Claude Code命令速查手册

# 一、最高频：每天必用

## 1.1 启动与进入会话 `[高频]`

| 命令                  | 说明                                                 |
| --------------------- | ---------------------------------------------------- |
| `claude`              | 在当前目录启动交互式会话                             |
| `claude -c`           | 继续当前目录上一次的会话                             |
| `claude -p "提示词"`  | 非交互（管道 / 脚本）模式，输出结果后退出            |
| `claude --resume`     | 交互式选择历史会话恢复（或 `-r "会话ID/名称"` 直达） |
| `claude "你的提示词"` | 带初始提示直接启动并执行                             |

> 管道用法示例：`cat error.log \| claude -p "分析这个报错并给出修复建议"`

## 1.2 上下文引用（@ 与 !）`[高频]`

在对话输入框中直接使用，无需斜杠前缀。

| 符号          | 说明                                                         |
| ------------- | ------------------------------------------------------------ |
| `@文件路径`   | 引用指定文件内容到上下文                                     |
| `@文件夹路径` | 引用整个目录（Claude 会读取目录内文件）                      |
| `@url`        | 抓取并引用网页内容                                           |
| `!命令`       | Bash 模式：直接执行 Shell 命令并把输出加入上下文（如 `!git status`、`!ls -la`） |
| `#` 开头      | 记忆快捷：将内容写入 `CLAUDE.md`（会提示选择文件）           |

**示例：**

```
@src/main.py 帮我分析这个文件的入口逻辑
@https://docs.example.com/api 根据这个文档生成 SDK
!find . -name "*.py" | head -20
```

## 1.3 上下文与费用管理 `[高频]`

| 命令       | 说明                                                       |
| ---------- | ---------------------------------------------------------- |
| `/clear`   | 清除当前对话上下文，开始全新会话（同时清空本目录命令历史） |
| `/compact` | 压缩当前对话历史，保留关键信息，减少 token 占用            |
| `/cost`    | 查看当前会话的 token 消耗与费用统计                        |
| `/status`  | 查看当前会话状态（模型、目录、token 用量等）               |

> 会话过长 → 用 `/compact` 保信息；切换任务 → 用 `/clear` 防混淆；大文件 → 用 `@` 引用而非直接粘贴。

## 1.4 最高频快捷键 `[高频]`

| 快捷键          | 说明                                                         |
| --------------- | ------------------------------------------------------------ |
| `Enter`         | 发送消息                                                     |
| `Shift + Enter` | 换行（部分终端需先执行 `/terminal-setup`；macOS 默认 `Option + Enter`） |
| `Ctrl + C`      | 中断当前操作 / 生成；**连按两次**退出 Claude Code            |
| `Ctrl + D`      | 退出 Claude Code（EOF 信号）                                 |
| `Tab`           | 自动补全文件路径 / 斜杠命令                                  |
| `↑` / `↓`       | 浏览历史输入记录（按目录独立保存）                           |
| `Ctrl + R`      | 反向模糊搜索历史输入（类似 bash 的 reverse-i-search）        |
| `Ctrl + L`      | 清屏（不清除上下文）                                         |
| `Esc`           | 取消当前输入 / 关闭自动补全 / 中断回复                       |

> 更完整的快捷键见 **第四章**。

---

# 二、高频：开发工作流

## 2.1 提交与代码审查 `[高频]`

| 命令      | 说明                                                         |
| --------- | ------------------------------------------------------------ |
| `/commit` | 自动分析变更并生成规范 commit message 后提交（遵循 git 安全协议） |
| `/review` | 对代码变更进行审查（Git diff）                               |
| `/init`   | 在项目根目录生成 `CLAUDE.md` 项目说明文件                    |

> 审查指定文件：`@src/api.py 审查这个文件的安全性和性能问题`
> 审查最近提交：`!git diff HEAD~1` 后让 Claude 检查安全问题

## 2.2 配置与切换 `[中频]`

| 命令              | 说明                                    |
| ----------------- | --------------------------------------- |
| `/config`         | 打开配置面板，查看和修改设置            |
| `/model`          | 切换使用的模型（Sonnet / Opus / Haiku） |
| `/theme`          | 切换界面主题（light / dark）            |
| `/permissions`    | 管理工具权限设置（查看允许列表）        |
| `/mcp`            | 查看 MCP Server 连接状态与管理          |
| `/add-dir <路径>` | 添加额外目录到工作上下文中              |
| `/ls`             | 列出当前工作目录的文件                  |

---

# 三、中频：安装、配置与权限（终端 / Shell）

## 3.1 安装 / 更新 / 版本 `[中频]`

| 命令                                       | 说明                                                         |
| ------------------------------------------ | ------------------------------------------------------------ |
| `npm install -g @anthropic-ai/claude-code` | 全局安装 Claude Code                                         |
| `npm update -g @anthropic-ai/claude-code`  | 更新到最新版本                                               |
| `claude update`                            | 更新到最新版本（CLI 内置命令）                               |
| `claude --version`                         | 查看当前版本                                                 |
| `claude auth login`                        | 登录 Anthropic 账号（`--console` 用 Console 计费，`--sso` 强制 SSO） |
| `claude auth status`                       | 查看登录状态（JSON；`--text` 可读输出）                      |

## 3.2 配置管理（claude config）`[中频]`

| 命令                                      | 说明             |
| ----------------------------------------- | ---------------- |
| `claude config list`                      | 列出所有配置     |
| `claude config get <key>`                 | 获取配置项       |
| `claude config set <key> <value>`         | 设置配置项       |
| `claude config set theme dark`            | 设置主题为暗色   |
| `claude config set --global apiKey <XXX>` | 全局设置 API Key |

## 3.3 权限与安全（启动参数）`[低频]`

| 参数                             | 说明                                                         |
| -------------------------------- | ------------------------------------------------------------ |
| `--allowedTools "Tool"`          | 预放行指定工具（如 `"Read"`、`"Bash(git log:*)"`），无需逐次确认 |
| `--disallowedTools "Tool"`       | 显式拒绝指定工具                                             |
| `--permission-mode <mode>`       | 以指定权限模式启动：`default` / `plan` / `acceptEdits` / `auto` / `bypassPermissions` |
| `--dangerously-skip-permissions` | 跳过所有权限确认（仅限可信环境，等同 `bypassPermissions`） |

---

# 四、完整快捷键速查表（REPL 交互界面）

> 适用于 `claude` 启动后的终端交互界面。Mac 上部分 `Ctrl` 组合以 `⌘` 为准；REPL 快捷键跨平台一致。

## 4.1 输入与发送

| 快捷键          | 说明                               |
| --------------- | ---------------------------------- |
| `Enter`         | 发送消息 / 确认操作                |
| `Shift + Enter` | 多行输入内换行（不发送）           |
| `\` + `Enter`   | 换行（所有终端通用）               |
| `Esc`           | 取消当前输入 / 关闭自动补全        |
| `Tab`           | 接受补全建议（文件路径、斜杠命令） |
| `↑` / `↓`       | 在补全建议中上下移动               |

## 4.2 会话控制 / 中断 / 退出

| 快捷键        | 说明                                               |
| ------------- | -------------------------------------------------- |
| `Ctrl + C`    | 取消当前输入或中断正在运行的任务；**连按两次退出** |
| `Ctrl + D`    | 退出 Claude Code                                   |
| `Ctrl + L`    | 清屏（保留会话上下文）                             |
| `Ctrl + O`    | 切换详细输出（显示工具调用与执行细节）             |
| `Esc` + `Esc` | 回退到历史检查点，恢复代码 / 对话到之前状态        |
| `Ctrl + Z`    | 将 REPL 挂到后台（用 `fg` 恢复）                   |

## 4.3 历史与导航

| 快捷键     | 说明                                                 |
| ---------- | ---------------------------------------------------- |
| `↑` / `↓`  | 浏览历史输入记录（按工作目录独立保存）               |
| `Ctrl + R` | 反向模糊搜索历史输入；再按 `Ctrl + R` 切换更早上一条 |
| `Ctrl + A` | 光标移到行首                                         |
| `Ctrl + E` | 光标移到行尾                                         |
| `Ctrl + K` | 删除光标到行尾                                       |
| `Ctrl + U` | 删除整行                                             |
| `Ctrl + W` | 删除前一个单词                                       |

## 4.4 权限与模式切换

| 快捷键             | 说明                                                         |
| ------------------ | ------------------------------------------------------------ |
| `Shift + Tab`      | 循环切换权限模式：Normal → Auto-Accept → Plan（最常用快捷键之一） |
| `Alt + M`          | 同上（Windows 未开启 VT 模式、Node 版本较低时的替代）        |
| `Tab`              | 部分版本下切换扩展思考（Thinking on/off）                    |
| `Ctrl + P`（`⌘P`） | 打开模型选择器，切换模型并调整推理强度（部分版本）           |

## 4.5 任务与后台

| 快捷键     | 说明                                        |
| ---------- | ------------------------------------------- |
| `Ctrl + T` | 切换任务列表浮层（跟踪多步任务进度）        |
| `Ctrl + B` | 将当前 Bash 任务转入后台（tmux 需连按两次） |
| `Ctrl + G` | 在外部编辑器打开当前提示词（适合长输入）    |
| `Ctrl + S` | 暂存当前提示词，稍后继续                    |

## 4.6 粘贴与图片

| 快捷键     | 说明                  |
| ---------- | --------------------- |
| `Ctrl + V` | 粘贴（macOS / Linux） |
| `Alt + V`  | 粘贴图片（Windows）   |

## 4.7 任务执行中的确认

当 Claude 展示差异并询问「Apply?」时，通常只需输入首字母 + `Enter`：

| 按键          | 说明                                   |
| ------------- | -------------------------------------- |
| `y` + `Enter` | 批准本次变更                           |
| `n` + `Enter` | 拒绝，要求替代方案                     |
| `e` + `Enter` | 在编辑器中打开变更后再决定             |
| `a` + `Enter` | 批准本任务剩余全部变更（跳过逐个确认） |
| `q` + `Enter` | 退出当前任务，拒绝所有待定变更         |

## 4.8 Vim 模式快捷键（启用 `/vim` 后）

| 快捷键          | 说明                           | 模式            |
| --------------- | ------------------------------ | --------------- |
| `i` / `a` / `o` | 进入插入（前 / 后 / 下方新行） | NORMAL → INSERT |
| `I` / `A` / `O` | 行首 / 行尾 / 上方新行插入     | NORMAL → INSERT |
| `Esc`           | 回到普通模式                   | INSERT → NORMAL |
| `h j k l`       | 左 / 下 / 上 / 右移动          | NORMAL          |
| `w` / `b`       | 下一词 / 上一词                | NORMAL          |
| `0` / `$`       | 行首 / 行尾                    | NORMAL          |
| `dd`            | 删除当前行                     | NORMAL          |
| `yy`            | 复制当前行                     | NORMAL          |
| `p`             | 粘贴                           | NORMAL          |
| `:w`            | 保存（发送消息）               | NORMAL          |
| `:q`            | 退出                           | NORMAL          |

---

# 五、中低频：其余斜杠命令

| 命令                 | 频率     | 说明                                                         |
| -------------------- | -------- | ------------------------------------------------------------ |
| `/help`              | `[中频]` | 查看所有可用命令及帮助信息                                   |
| `/doctor`            | `[低频]` | 诊断安装环境，检查配置问题（这是**斜杠命令**，原文档写作 `claude doctor` 不准确） |
| `/vim`               | `[低频]` | 切换 Vim 编辑模式                                            |
| `/bug`               | `[低频]` | 报告 Bug                                                     |
| `/terminal-setup`    | `[低频]` | 配置终端集成（绑定 `Shift + Enter` 换行等）                  |
| `/agents`            | `[低频]` | 列出已配置的子代理（subagents）                              |
| `/plugin`            | `[低频]` | 管理 Claude Code 插件                                        |
| `claude setup-token` | `[低频]` | 生成长期有效的 OAuth Token（用于 CI / 脚本）                 |

---

# 六、CLAUDE.md 项目配置文件

在项目根目录创建 `CLAUDE.md`，Claude Code 启动时会自动读取。

## 6.1 常用配置内容

```markdown
# 项目说明

## 技术栈
- 语言：Python 3.12
- 框架：FastAPI
- 数据库：PostgreSQL

## 代码规范
- 使用 Black 格式化
- 类型注解必须完整
- 函数必须有 docstring

## 禁止事项
- 不要修改 config/ 目录下的配置文件
- 不要直接操作生产数据库
```

### 6.2 配置层级

| 文件位置               | 作用范围           |
| ---------------------- | ------------------ |
| `~/.claude/CLAUDE.md`  | 全局，所有项目生效 |
| `项目根目录/CLAUDE.md` | 当前项目           |
| `子目录/CLAUDE.md`     | 特定子目录         |

---

# 七、实用技巧与工作流

## 7.1 上下文管理

- **会话过长**：`/compact` 压缩上下文，保留关键信息
- **切换任务**：`/clear` 清除上下文，避免混淆
- **大文件处理**：用 `@文件路径` 引用而非直接粘贴，减少 token 消耗

## 7.2 Git 集成

```
# 查看变更并审查
!git diff HEAD~1
审查最近的提交变更，检查是否有安全问题

# 生成分支说明
!git log --oneline main..feature-branch
为这个 feature 分支生成 PR 描述
```

## 7.3 调试与诊断

```
/status      # 查看会话状态
/cost        # 查看费用
/doctor      # 诊断安装与配置（注意是斜杠命令）
```

## 7.4 批量文件处理

```
# 引用整个目录批量操作
@src/components/ 给所有组件添加 TypeScript 类型声明

# 管道模式批量处理
!find . -name "*.py" -type f | head -20
分析这些 Python 文件的 import 依赖关系
```

## 7.5 导出历史会话

```
# 安装导出工具
pipx install claude-conversation-extractor
# 导出全部会话
claude-extract --all --detailed --output ~/claude-markdown-exports
```

---

# 八、环境变量

| 变量名                          | 说明                           |
| ------------------------------- | ------------------------------ |
| `ANTHROPIC_API_KEY`             | Anthropic API 密钥             |
| `CLAUDE_CODE_USE_BEDROCK`       | 使用 AWS Bedrock 作为后端      |
| `CLAUDE_CODE_USE_VERTEX`        | 使用 Google Vertex AI 作为后端 |
| `CLAUDE_MODEL`                  | 默认使用的模型                 |
| `MAX_THINKING_TOKENS`           | 思考模式最大 token 数          |
| `DISABLE_PROMPT_CACHING`        | 禁用提示缓存                   |
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | 最大输出 token 数              |

---

> **备注**：命令可能随版本更新变化，建议定期执行 `/help` 查看最新可用命令。完整文档参考：https://docs.anthropic.com/en/docs/claude-code