Claude Code 提供四种使用方式：CLI 终端、VS Code 扩展、桌面应用和 Web 应用。 推荐从 CLI 开始——它是功能最完整的入口，理解了 CLI 的交互模型，切换到其他平台就是换个壳。

CLI 安装（推荐）

# macOS / Linux — 使用 npm 全局安装
$ npm install -g @anthropic-ai/claude-code

# 或者使用 Homebrew (macOS)
$ brew install claude-code

# 验证安装
$ claude --version
claude-code v1.x.x

# 查看帮助
$ claude --help

Claude Code 需要连接到 Anthropic API 才能工作。 最简单的方式是 OAuth 登录—— 一条命令打开浏览器，登录你的 Anthropic 账号，授权完成，回到终端直接开始。

Step 1 — 认证

# OAuth 登录 (推荐) — 浏览器会自动打开
$ claude login

# 或者用 API Key 方式
$ export ANTHROPIC_API_KEY=sk-ant-xxxxx
$ claude

Step 2 — 启动第一次对话

# 进入交互模式
$ claude

╭──────────────────────────────────────╮
│  Claude Code v1.x.x                 │
│  Type your message or /help          │
╰──────────────────────────────────────╯

# 试试你的第一条消息:
> 你好，请告诉我当前目录下有哪些文件

# Claude 会调用 Bash 工具执行 ls，然后回答你

Claude Code 的交互不是"发消息等回复"的聊天模式—— 它是一个工具驱动的循环。 理解这个模型，是高效使用 Claude Code 的前提。

常用斜杠命令

快捷键与退出

# 终端交互快捷键
Esc         # 中断当前 Claude 的回答
Ctrl+C      # 中断或退出
Enter       # 发送消息（单行）
Shift+Enter # 多行输入（换行不发送）

# 恢复之前的对话
$ claude --resume     # 从上次对话列表中选择
$ claude --continue   # 直接继续最近一次对话

# 直接传入任务（非交互模式）
$ claude "解释一下 package.json 里的 scripts"

# 管道输入
$ cat error.log | claude "分析这个错误日志"

理论到此结束——打开终端，亲手体验。 下面三个练习覆盖 Claude Code 最基础的三种能力： 读文件、写文件、跑命令。

Lab 1 — 让 Claude 读文件

进入任意一个项目目录，让 Claude 阅读并理解一个文件。 观察它如何调用 Read 工具，以及返回的内容格式。

# 进入你的项目目录
$ cd ~/my-project
$ claude

# 试试这些提示词:
> 读一下 package.json 的内容
> 这个项目的目录结构是什么样的？
> src/index.ts 这个文件在做什么？

# 观察: Claude 会调用 Read 工具读取文件
# 然后用自然语言给你解释文件内容

Lab 2 — 让 Claude 创建文件

让 Claude 用 Write 工具创建一个新文件。 注意权限确认提示——这是你第一次让 AI 修改你的文件系统。

# 让 Claude 创建一个文件
> 在当前目录创建一个 hello.py，内容是打印 "Hello from Claude Code!"

# Claude 会:
# 1. 调用 Write 工具 → 你会看到权限确认弹窗
# 2. 你选择 Allow → 文件被创建
# 3. 验证: 看看文件是否真的在那里

> 运行一下 hello.py

# Claude 会调用 Bash 工具执行 python hello.py
Hello from Claude Code!

Lab 3 — 让 Claude 分析与修改

综合练习：让 Claude 分析代码并做一个小修改。 体验 Read → 分析 → Edit 的完整循环。

# 给 Claude 一个稍复杂的任务
> 给 hello.py 加上一个 main 函数，并添加当前时间的输出

# Claude 会:
# 1. Read hello.py — 读取当前内容
# 2. Edit hello.py — 用 Edit 工具修改文件（非全量覆盖）
# 3. 可能还会 Bash python hello.py — 验证修改是否正确

# 观察 Edit 工具的输出: 它只展示变更的部分（diff）
# 而不是整个文件，这比 Write 更精确

1. Claude Code 的四大核心工具是哪些？分别对应什么操作？（读、写、改、执行）
2. 描述 Claude Code 的交互循环：从用户输入到得到结果经过了哪几步？
3. Prompt 模式和 Auto 模式的区别是什么？什么时候应该用哪个？
4. 如果你发现 Claude 执行了一个你不想要的操作（比如改错了文件），你有哪些补救方式？
5. 用 /usage 查看你今天练习消耗了多少 token，思考哪些操作最"贵"。