安装登录与第一次会话：提问、改代码、提交

你将得到什么

• 一个能在终端里直接运行的 claude 命令，并用 claude --version 与 claude doctor 验证安装健康
• 已登录的 Claude Code 账号（Pro / Max / Team / Enterprise 订阅或 Claude Console）
• 一个练习用的小项目，以及 Claude Code 帮你读代码、改代码、提交 Git 的完整一轮操作

开始前准备

• 系统：macOS 13.0+、Windows 10 1809+ / Windows Server 2019+、Ubuntu 20.04+、Debian 10+ 或 Alpine 3.19+；内存 4 GB 以上，x64 或 ARM64。
• 账号：Claude Pro、Max、Team、Enterprise 或 Claude Console 账号。官方明确：免费版 claude.ai 不包含 Claude Code。也可走 Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry 等企业云。
• 网络与地区：需联网，且须位于 Anthropic 支持的国家和地区，列表见 https://www.anthropic.com/supported-countries 。
• 工具：本课练习会用到 git 与 python3（只用来跑一个两行的测试）。

核心事实（先记住）

步骤 1：安装 Claude Code

官方推荐 原生安装（Native Install），它会在后台自动更新。按你的系统任选其一。

macOS、Linux、WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell（提示符以 PS C:\ 开头）：

irm https://claude.ai/install.ps1 | iex

Windows CMD（提示符是 C:\，没有 PS）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

原生 Windows 建议装 Git for Windows，Claude Code 才能使用 Bash 工具；没装时会改用 PowerShell 工具。WSL 不需要 Git for Windows。

其他安装方式（可选）

macOS Homebrew（claude-code 跟随 stable 通道，约晚一周；claude-code@latest 跟随最新通道）：

brew install --cask claude-code

Windows WinGet：

winget install Anthropic.ClaudeCode

npm（需要 Node.js 22+，不要加 sudo）：

npm install -g @anthropic-ai/claude-code

Homebrew 与 WinGet 默认不会自动更新，需定期执行 brew upgrade claude-code 或 winget upgrade Anthropic.ClaudeCode。

步骤 2：验证安装

安装结束后，新开一个终端窗口再执行：

claude --version

对照结果（版本号以你本机为准）：

2.1.xxx (Claude Code)

再做一次只读体检：

claude doctor

对照结果：输出安装健康状态、设置文件校验结果，以及带修复建议的警告（如有）；它不会启动会话。

如果提示 claude: command not found，说明安装目录还不在 PATH 中。原生安装在 macOS / Linux 上的启动器位于 ~/.local/bin/claude，按官方 Troubleshooting 把 ~/.local/bin 加入 PATH 后重开终端。

步骤 3：登录账号

在任意目录执行：

claude

首次运行会提示登录：订阅账号或 Console 账号按提示在浏览器中完成授权。对照结果：

• 浏览器授权完成后，终端回到 Claude Code 界面，不再要求登录
• 凭据会保存下来，以后不需要重复登录
• 若你设置了环境变量 ANTHROPIC_API_KEY，Claude Code 会跳过浏览器登录，改为让你确认是否使用该 Key

以后要切换账号，在会话里输入：

/login

用 Console 账号首次登录时，Console 会自动创建一个名为「Claude Code」的工作区，方便集中查看费用。

输入 /exit（或连按两次 Ctrl+D）退出会话，进入下一步。

步骤 4：准备一个练习项目

为了让后续每一步都有确定的对照结果，先建一个只有两个文件的 Python 小项目：

mkdir -p ~/kun-claude-demo && cd ~/kun-claude-demo
git init -q
cat > calc.py <<'PY'
def add(a, b):
    return a + b


def divide(a, b):
    return a / b
PY
cat > test_calc.py <<'PY'
from calc import add

assert add(2, 3) == 5
print("ok")
PY
python3 test_calc.py
git add . && git commit -qm "init demo"

对照结果：终端打印 ok，且 git log --oneline 能看到一条 init demo 提交。

步骤 5：开启第一次会话并提问

在项目目录启动 Claude Code：

cd ~/kun-claude-demo
claude

对照结果：提示框上方显示 版本号、当前模型和工作目录（应为 ~/kun-claude-demo）。输入 /help 可查看可用命令。

先让它理解项目（以下每行是一次独立提问，直接粘贴到会话里）：

what does this project do?

where is the main entry point?

对照结果：Claude 会自行读取 calc.py 和 test_calc.py，说明这是一个包含 add、divide 两个函数及一个简单测试脚本的小项目。官方说明：你不需要手动把文件塞进上下文，Claude Code 会按需读取项目文件。

用中文提问同样可以，例如「这个项目是做什么的？」。本课保留官方英文示例，便于对照文档。

步骤 6：让它改第一处代码

divide(1, 0) 目前会直接抛出 ZeroDivisionError。在会话中输入：

make divide() raise ValueError("b must not be zero") when b is 0, and add a test for it

对照结果：

• Claude 定位到 calc.py，给出修改内容；需要你确认时选择 Yes
• test_calc.py 中新增一段对除零情况的断言
• 它可能会主动运行 python3 test_calc.py 验证，并报告输出 ok

权限模式：谁来批准每一步

Claude 改文件、跑命令之前是否询问你，由权限模式决定。官方说明：Claude Code v2.1.283 及以上，交互式终端会话默认以 auto 模式启动——由一个分类器模型代你审核操作，大部分文件编辑和命令会直接执行。更早的版本只在 Pro、Max、Team 套餐上默认 auto。

会话中随时按 Shift+Tab 循环切换。想从一开始就逐步审核，可以这样启动：

claude --permission-mode manual

步骤 7：用对话完成 Git 操作

继续在同一会话中输入：

what files have I changed?

commit my changes with a descriptive message

对照结果：Claude 列出 calc.py 与 test_calc.py 的改动，并创建一条描述清楚的提交。退出会话后可自行核对：

git log --oneline -2
python3 test_calc.py

应看到两条提交（最新一条是 Claude 写的说明），测试仍打印 ok。

常用命令速查

终端命令（在 shell 中运行）：

会话命令（在 Claude Code 里输入）：

快捷操作：输入 / 查看全部命令与技能；Tab 补全命令；↑ 翻历史输入；Shift+Tab 切换权限模式。

本课检查清单

• claude --version 输出 x.y.z (Claude Code)
• claude doctor 没有未处理的错误
• 已在 ~/kun-claude-demo 完成一次提问、一次改代码、一次提交
• 知道用 Shift+Tab 切换权限模式

常见问题

下一课：用 /init 生成 CLAUDE.md 让 Claude 记住项目规矩，再用 claude -p 把它接进脚本与 CI。