Claude Code命令速查手册

# 一、操作系统层面命令（终端 / Shell 中执行）

## 1.1 安装与更新

| 命令                                       | 说明                       |
| ------------------------------------------ | -------------------------- |
| `npm install -g @anthropic-ai/claude-code` | 全局安装 Claude Code       |
| `npm update -g @anthropic-ai/claude-code`  | 更新到最新版本             |
| `claude --version`                         | 查看当前版本               |
| `claude doctor`                            | 诊断安装环境，检查配置问题 |

## 1.2 启动与运行

| 命令                  | 说明                                            |
| --------------------- | ----------------------------------------------- |
| `claude`              | 在当前目录启动交互式会话                        |
| `claude "你的提示词"` | 以单次提示直接启动并执行                        |
| `claude -p "提示词"`  | 非交互模式（管道/脚本中使用），输出结果后退出   |
| `claude -c`           | 继续上一次的会话                                |
| `claude -r "会话ID"`  | 恢复指定会话                                    |
| `claude -m "模型名"`  | 指定使用的模型（如 `claude-sonnet-4-20250514`） |
| `claude --resume`     | 交互式选择历史会话恢复                          |
| `claude config`       | 查看/修改配置                                   |

## 1.3 配置管理

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

## 1.4 权限与安全

| 命令                                    | 说明                           |
| --------------------------------------- | ------------------------------ |
| `claude --allowedTools`                 | 查看允许的工具列表             |
| `claude --dangerously-skip-permissions` | 跳过权限确认（⚠️ 仅限可信环境） |

---

# 二、Claude Code 交互界面内命令

## 2.1 斜杠命令（Slash Commands）

在 Claude Code 对话输入框中以 `/` 开头执行。

### 会话管理

| 命令       | 说明                                          |
| ---------- | --------------------------------------------- |
| `/clear`   | 清除当前对话上下文，开始全新会话              |
| `/compact` | 压缩当前对话历史，保留关键信息减少 token 占用 |
| `/cost`    | 查看当前会话的 token 消耗与费用统计           |
| `/quit`    | 退出 Claude Code（也可按 `Ctrl+C` 两次）      |

### 文件与项目操作

| 命令              | 说明                       |
| ----------------- | -------------------------- |
| `/add-dir <路径>` | 添加额外目录到工作上下文中 |
| `/ls`             | 列出当前工作目录的文件     |

### 配置与设置

| 命令              | 说明                               |
| ----------------- | ---------------------------------- |
| `/config`         | 打开配置面板，查看和修改设置       |
| `/model`          | 切换使用的模型（如 Sonnet / Opus） |
| `/theme`          | 切换界面主题（light / dark）       |
| `/permissions`    | 管理工具权限设置                   |
| `/terminal-setup` | 配置终端集成（Shift+Enter 换行等） |

### 开发辅助

| 命令      | 说明                                                |
| --------- | --------------------------------------------------- |
| `/init`   | 在项目根目录生成 `CLAUDE.md` 项目说明文件           |
| `/review` | 对代码变更进行审查（Git diff）                      |
| `/commit` | 自动生成 commit message 并提交（遵循 git 安全协议） |
| `/vim`    | 切换 Vim 编辑模式                                   |
| `/bug`    | 报告 Bug                                            |

### MCP 管理

| 命令   | 说明                           |
| ------ | ------------------------------ |
| `/mcp` | 查看 MCP Server 连接状态与管理 |

### 帮助

| 命令      | 说明                                         |
| --------- | -------------------------------------------- |
| `/help`   | 查看所有可用命令及帮助信息                   |
| `/status` | 查看当前会话状态（模型、目录、token 用量等） |

---

## 2.2 特殊命令符（@ 引用）

在输入框中使用 `@` 引用外部内容。

| 符号          | 说明                                    |
| ------------- | --------------------------------------- |
| `@文件路径`   | 引用指定文件内容到上下文                |
| `@文件夹路径` | 引用整个目录（Claude 会读取目录内文件） |
| `@url`        | 抓取并引用网页内容                      |

**示例：**

```
@src/main.py 帮我分析这个文件的入口逻辑
@https://docs.example.com/api 根据这个文档生成 SDK
```

---

## 2.3 快捷键

### 通用快捷键

| 快捷键            | 说明                                    |
| ----------------- | --------------------------------------- |
| `Enter`           | 发送消息                                |
| `Shift + Enter`   | 换行（需先执行 `/terminal-setup` 配置） |
| `Ctrl + C`        | 中断当前操作/生成                       |
| `Ctrl + C` (两次) | 退出 Claude Code                        |
| `Ctrl + D`        | 退出 Claude Code                        |
| `Esc`             | 中断当前 Claude 的回复                  |
| `Esc` (两次)      | 回退到历史消息编辑重新发送              |
| `↑` / `↓`         | 浏览历史输入记录                        |
| `Tab`             | 自动补全文件路径                        |
| `Ctrl + L`        | 清屏（不清除上下文）                    |

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

| 快捷键 | 说明             |
| ------ | ---------------- |
| `i`    | 进入插入模式     |
| `Esc`  | 回到普通模式     |
| `:w`   | 保存（发送消息） |
| `:q`   | 退出             |
| `dd`   | 删除当前行       |
| `yy`   | 复制当前行       |
| `p`    | 粘贴             |

---

## 2.4 自然语言快捷指令

无需斜杠前缀，直接在对话中使用的常用操作模式。

| 输入模式       | 说明                                           |
| -------------- | ---------------------------------------------- |
| `!命令`        | 执行 Shell 命令（如 `!ls -la`、`!git status`） |
| 直接粘贴代码   | Claude 会自动识别并分析                        |
| 拖拽文件到终端 | 自动以 `@文件路径` 形式引用                    |

---

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

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

## 3.1 常用配置内容

```markdown
# 项目说明

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

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

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

## 3.2 配置层级

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

---

# 四、常用工作流速查

## 4.1 代码审查流程

```
# 1. 查看变更
/review

# 2. 手动指定文件审查
@src/api.py 审查这个文件的代码安全性和性能问题

# 3. 审查 Git diff
审查当前未提交的变更，重点关注潜在 bug
```

## 4.2 提交代码流程

```
/commit
# Claude 会自动分析变更并生成规范的 commit message
```

## 4.3 项目初始化流程

```
# 1. 生成项目配置
/init

# 2. 添加项目目录（如需要）
/add-dir ../shared-lib

# 3. 开始开发
帮我实现用户登录接口，参考 @src/auth/ 现有的认证逻辑
```

## 4.4 批量文件处理

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

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

---

# 五、环境变量

| 变量名                          | 说明                           |
| ------------------------------- | ------------------------------ |
| `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 数              |

---

# 六、实用技巧

## 7.1 上下文管理

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

## 7.2 Git 集成

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

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

## 7.4 调试与诊断

```
# 查看会话状态
/status

# 查看费用
/cost

# 诊断安装
!claude doctor
```

---

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