Claude Code 常用命令

/init

初始化项目，扫描项目，生成 CLAUDE.md 文件。最开始必须做。

`/init` 生成的 `CLAUDE.md` 文件有什么用？

它是什么？

执行 /init 后，Claude Code 会扫描你的项目结构（文件夹、入口文件、构建配置、依赖、README 等），自动在项目根目录生成一个 CLAUDE.md 文件，用来描述这个项目的概况和约定。

它有什么作用？

CLAUDE.md 本质上是项目的"说明书"或"使用手册"，每次启动 Claude Code 时，我都会自动读取它，从而：

作用	说明
📖 了解项目	快速知道这是什么项目、用什么技术栈、目录结构如何
🧭 遵循约定	记住你定下的代码规范、命名习惯、Git 提交格式等
⚙️ 掌握命令	记录如何启动、构建、测试、部署这个项目
🚀 避免踩坑	记录注意事项（比如哪些文件别改、哪个目录不能动）
🤝 保持一致	让每次会话、每个协作者都按同一套规则工作

一句话总结：CLAUDE.md 就是给我（Claude Code）看的项目简介——有了它，我就能"懂这个项目"，按你的规矩干活；没有它，每次都要靠你口头解释。

需要手动维护吗？

/init 只生成一次，之后不会自动更新。当项目结构或约定变了，需要再次运行 /init 或让我帮你更新，否则里面的信息可能过时、产生误导。
你可以在 CLAUDE.md 里手动添加你特意规定的规则（比如"禁止安装第三方包""提交信息用中文"等），我每次都会遵守。
我（当前这个 AI 会话）的说明也写在 CLAUDE.md 里，你可以直接打开它查看。

💡 小提示：CLAUDE.md 通常会被加入 .gitignore，不会随代码提交到 GitHub，属于本地项目约定文件。如果你希望团队成员也共享这套规则，可以单独把这个文件同步给团队。

权限授予

配置方案	核心命令 / 配置	适用场景	安全性	便捷性
最激进方法	`claude --dangerously-skip-permissions`	CI/CD、容器等完全隔离的自动化环境	🔴 低	🟢 高
Headless 模式	`claude -p "<你的指令>"`	脚本集成、单次自动化任务	🟡 中	🟢 高
Auto 模式 (推荐)	`claude --enable-auto-mode`	日常开发的长时运行任务	🟡 中高	🟢 高
预授权模式	`claude --permission-mode acceptEdits`	日常开发，自动接受文件编辑	🟡 中	🟢 高
手动配置模式	编辑 `.claude/settings.json` 文件	长期、精细化的项目或全局配置	🟢 中高 (可定制)	🟡 中

常用斜杠命令

命令	用途
`/init`	初始化项目，生成 `CLAUDE.md`。此文件不会自动更新，在项目更改完之后，应重复运行这个命令更新此文件，若此文件中有自己特意规定的规则，可用对话的形式让 AI 更新此文件，否则，下次新开这个项目时，此文件会产生误导
`/add-dir`	增加工作目录
`/cd`	迁移当前会话到新工作目录
`/clear`	清除上下文，开启新会话（旧会话可 `/resume` 恢复）
`/compact`	压缩上下文，减少 Token 消耗
`/cost`	查看 Token 消耗和费用
`/background`	把会话挂到后台，释放终端
`/resume`	恢复之前挂起或退出的会话
`/branch`	从当前节点创建对话分支
`/btw <问题>`	旁白插话，不打断主线对话
`/plan`	先写执行计划，确认后再执行
`/batch`	大规模变更：拆成多个 worktree 并行执行
`/review`	代码审查
`/diff`	查看当前会话所有文件变更
`/undo`	撤销最后一次文件编辑
`/commit`	自动生成 commit message 并提交
`/pr`	创建 GitHub Pull Request
`/bug`	报告 bug 或分享当前对话
`/doctor`	检查 CC 状态、项目环境
`/export`	导出当前会话
`/settings`	打开交互式设置
`/mcp`	管理 MCP 服务器
`/memory`	显示已加载的 `CLAUDE.md`
`/claude-api`	Claude API / SDK 参考
`/keybindings`	自定义快捷键
`/help`	显示所有命令
`/exit`	退出

💡 关于 /agents：help 里已标记为 (removed)，现在直接编辑 .claude/agents/ 目录即可创建子代理，不需要命令了。

快捷键

快捷键	用途
`Shift + Tab`	切换模式（如 `accept edits on` / `plan mode on` / `auto mode on` / `manual mode on` 模式）
`Ctrl + Shift + Enter`	换行
`\` + `Enter`	换行（另一种方式）
`!`	进入 Shell 模式
`/`	进入命令模式
`@`	引用文件路径
`Tab`	接受自动补全
`Ctrl + C`	中断当前操作
`Ctrl + O`	Verbose 输出（详细模式）
`Ctrl + T`	切换 Tasks 面板
`Ctrl + S`	Stash 当前输入
`Ctrl + G`	在系统编辑器中编辑
`Ctrl + Shift + _`	撤销（Undo）
`Alt + V`	粘贴图片
`Alt + P`	切换模型
`Esc` `Esc`	双击 Esc 清空输入
`↑` / `↓`	浏览输入历史
`Ctrl + R`	反向搜索历史
`Ctrl + L`	清屏
`Ctrl + D`	退出（空输入时）

配置文件路径

路径	用途
`~/.claude/settings.json`	全局配置（所有项目生效）
`.claude/settings.json`	项目级配置（仅当前项目）
`.claude/CLAUDE.md`	项目级系统提示（`/init` 自动生成）
`~/.claude/commands/`	自定义斜杠命令目录

实用技巧

技巧	说明
`CLAUDE_CODE_DEBUG=1 claude`	以调试模式启动，查看详细日志
`claude -p "指令"`	Headless 模式，执行完自动退出，适合脚本
`claude --print`	非交互模式，直接输出结果到 stdout
`@文件名`	在对话中快速引用某个文件
`@文件夹名/`	引用整个文件夹作为上下文
`git diff` 后问 Claude	直接粘贴 diff 让 Claude 做 code review
多行输入	用 `Ctrl + Shift + Enter` 换行，写长 prompt 更方便
`/compact` 时机	当上下文超过 50k tokens 或 Claude 开始"失忆"时用
会话恢复	`/resume` 可以找回之前的对话，但重启终端后可能失效，重要内容及时 `/export`

补充说明

//memory 和 //add-dir 你原文里写的是双斜杠，Claude Code 标准命令是单斜杠（/memory、/add-dir），双斜杠在部分旧版本或自定义配置中可能作为注释/特殊语法存在，建议统一用单斜杠。
/doctor 前面建议也加上斜杠写成 /doctor，保持命令格式一致。

# Claude Code 常用命令

## /init

- 初始化项目，扫描项目，生成 `CLAUDE.md` 文件。最开始必须做。

---

## `/init` 生成的 `CLAUDE.md` 文件有什么用？

### 它是什么？

执行 `/init` 后，Claude Code 会扫描你的项目结构（文件夹、入口文件、构建配置、依赖、README 等），自动在项目根目录生成一个 **`CLAUDE.md`** 文件，用来描述这个项目的概况和约定。

### 它有什么作用？

`CLAUDE.md` 本质上是**项目的"说明书"或"使用手册"**，每次启动 Claude Code 时，我都会自动读取它，从而：

| 作用 | 说明 |
| ---- | ---- |
| 📖 **了解项目** | 快速知道这是什么项目、用什么技术栈、目录结构如何 |
| 🧭 **遵循约定** | 记住你定下的代码规范、命名习惯、Git 提交格式等 |
| ⚙️ **掌握命令** | 记录如何启动、构建、测试、部署这个项目 |
| 🚀 **避免踩坑** | 记录注意事项（比如哪些文件别改、哪个目录不能动） |
| 🤝 **保持一致** | 让每次会话、每个协作者都按同一套规则工作 |

**一句话总结**：`CLAUDE.md` 就是**给我（Claude Code）看的项目简介**——有了它，我就能"懂这个项目"，按你的规矩干活；没有它，每次都要靠你口头解释。

### 需要手动维护吗？

- `/init` **只生成一次，之后不会自动更新**。当项目结构或约定变了，需要**再次运行 `/init`** 或让我帮你更新，否则里面的信息可能过时、产生误导。
- 你可以在 `CLAUDE.md` 里**手动添加你特意规定的规则**（比如"禁止安装第三方包""提交信息用中文"等），我每次都会遵守。
- 我（当前这个 AI 会话）的说明也写在 `CLAUDE.md` 里，你可以直接打开它查看。

> 💡 **小提示**：`CLAUDE.md` 通常会被加入 `.gitignore`，**不会随代码提交到 GitHub**，属于本地项目约定文件。如果你希望团队成员也共享这套规则，可以单独把这个文件同步给团队。

---

## 权限授予

| 配置方案         | 核心命令 / 配置                         | 适用场景                          | 安全性           | 便捷性 |
| ---------------- | --------------------------------------- | --------------------------------- | ---------------- | ------ |
| 最激进方法       | `claude --dangerously-skip-permissions` | CI/CD、容器等完全隔离的自动化环境 | 🔴 低            | 🟢 高  |
| Headless 模式    | `claude -p "<你的指令>"`                | 脚本集成、单次自动化任务          | 🟡 中            | 🟢 高  |
| Auto 模式 (推荐) | `claude --enable-auto-mode`             | 日常开发的长时运行任务            | 🟡 中高          | 🟢 高  |
| 预授权模式       | `claude --permission-mode acceptEdits`  | 日常开发，自动接受文件编辑        | 🟡 中            | 🟢 高  |
| 手动配置模式     | 编辑 `.claude/settings.json` 文件       | 长期、精细化的项目或全局配置      | 🟢 中高 (可定制) | 🟡 中  |

---

## 常用斜杠命令

| 命令           | 用途                                                                                                                                                                                                         |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `/init`        | 初始化项目，生成 `CLAUDE.md`。此文件不会自动更新，在项目更改完之后，应重复运行这个命令更新此文件，若此文件中有自己特意规定的规则，可用对话的形式让 AI 更新此文件，否则，下次新开这个项目时，此文件会产生误导 |
| `/add-dir`     | 增加工作目录                                                                                                                                                                                                 |
| `/cd`          | 迁移当前会话到新工作目录                                                                                                                                                                                     |
| `/clear`       | 清除上下文，开启新会话（旧会话可 `/resume` 恢复）                                                                                                                                                            |
| `/compact`     | 压缩上下文，减少 Token 消耗                                                                                                                                                                                  |
| `/cost`        | 查看 Token 消耗和费用                                                                                                                                                                                        |
| `/background`  | 把会话挂到后台，释放终端                                                                                                                                                                                     |
| `/resume`      | 恢复之前挂起或退出的会话                                                                                                                                                                                     |
| `/branch`      | 从当前节点创建对话分支                                                                                                                                                                                       |
| `/btw <问题>`  | 旁白插话，不打断主线对话                                                                                                                                                                                     |
| `/plan`        | 先写执行计划，确认后再执行                                                                                                                                                                                   |
| `/batch`       | 大规模变更：拆成多个 worktree 并行执行                                                                                                                                                                       |
| `/review`      | 代码审查                                                                                                                                                                                                     |
| `/diff`        | 查看当前会话所有文件变更                                                                                                                                                                                     |
| `/undo`        | 撤销最后一次文件编辑                                                                                                                                                                                         |
| `/commit`      | 自动生成 commit message 并提交                                                                                                                                                                               |
| `/pr`          | 创建 GitHub Pull Request                                                                                                                                                                                     |
| `/bug`         | 报告 bug 或分享当前对话                                                                                                                                                                                      |
| `/doctor`      | 检查 CC 状态、项目环境                                                                                                                                                                                       |
| `/export`      | 导出当前会话                                                                                                                                                                                                 |
| `/settings`    | 打开交互式设置                                                                                                                                                                                               |
| `/mcp`         | 管理 MCP 服务器                                                                                                                                                                                              |
| `/memory`      | 显示已加载的 `CLAUDE.md`                                                                                                                                                                                     |
| `/claude-api`  | Claude API / SDK 参考                                                                                                                                                                                        |
| `/keybindings` | 自定义快捷键                                                                                                                                                                                                 |
| `/help`        | 显示所有命令                                                                                                                                                                                                 |
| `/exit`        | 退出                                                                                                                                                                                                         |

> 💡 **关于 `/agents`**：help 里已标记为 `(removed)`，现在直接编辑 `.claude/agents/` 目录即可创建子代理，不需要命令了。

### 快捷键

| 快捷键                 | 用途                                                                                       |
| ---------------------- | ------------------------------------------------------------------------------------------ |
| `Shift + Tab`          | 切换模式（如 `accept edits on` / `plan mode on` / `auto mode on` / `manual mode on` 模式） |
| `Ctrl + Shift + Enter` | 换行                                                                                       |
| `\` + `Enter`          | 换行（另一种方式）                                                                         |
| `!`                    | 进入 Shell 模式                                                                            |
| `/`                    | 进入命令模式                                                                               |
| `@`                    | 引用文件路径                                                                               |
| `Tab`                  | 接受自动补全                                                                               |
| `Ctrl + C`             | 中断当前操作                                                                               |
| `Ctrl + O`             | Verbose 输出（详细模式）                                                                   |
| `Ctrl + T`             | 切换 Tasks 面板                                                                            |
| `Ctrl + S`             | Stash 当前输入                                                                             |
| `Ctrl + G`             | 在系统编辑器中编辑                                                                         |
| `Ctrl + Shift + _`     | 撤销（Undo）                                                                               |
| `Alt + V`              | 粘贴图片                                                                                   |
| `Alt + P`              | 切换模型                                                                                   |
| `Esc` `Esc`            | 双击 Esc 清空输入                                                                          |
| `↑` / `↓`              | 浏览输入历史                                                                               |
| `Ctrl + R`             | 反向搜索历史                                                                               |
| `Ctrl + L`             | 清屏                                                                                       |
| `Ctrl + D`             | 退出（空输入时）                                                                           |

---

## 配置文件路径

| 路径                      | 用途                                   |
| ------------------------- | -------------------------------------- |
| `~/.claude/settings.json` | **全局配置**（所有项目生效）           |
| `.claude/settings.json`   | **项目级配置**（仅当前项目）           |
| `.claude/CLAUDE.md`       | **项目级系统提示**（`/init` 自动生成） |
| `~/.claude/commands/`     | 自定义斜杠命令目录                     |

---

## 实用技巧

| 技巧                         | 说明                                                                       |
| ---------------------------- | -------------------------------------------------------------------------- |
| `CLAUDE_CODE_DEBUG=1 claude` | 以**调试模式**启动，查看详细日志                                           |
| `claude -p "指令"`           | Headless 模式，执行完自动退出，适合脚本                                    |
| `claude --print`             | 非交互模式，直接输出结果到 stdout                                          |
| `@文件名`                    | 在对话中快速引用某个文件                                                   |
| `@文件夹名/`                 | 引用整个文件夹作为上下文                                                   |
| `git diff` 后问 Claude       | 直接粘贴 diff 让 Claude 做 code review                                     |
| 多行输入                     | 用 `Ctrl + Shift + Enter` 换行，写长 prompt 更方便                         |
| `/compact` 时机              | 当上下文超过 50k tokens 或 Claude 开始"失忆"时用                           |
| 会话恢复                     | `/resume` 可以找回之前的对话，但重启终端后可能失效，重要内容及时 `/export` |

---

## 补充说明

- `//memory` 和 `//add-dir` 你原文里写的是双斜杠，Claude Code 标准命令是**单斜杠**（`/memory`、`/add-dir`），双斜杠在部分旧版本或自定义配置中可能作为注释/特殊语法存在，建议统一用单斜杠。
- `/doctor` 前面建议也加上斜杠写成 `/doctor`，保持命令格式一致。