Claude Code 实战命令手册

目标：规范项目开发，管理 AI 记忆，提升编码效率。

适用：macOS / Linux / WSL

---

一、项目初始化与记忆（核心）

这是你工作流的基石，必须熟练掌握。

命令	作用	使用场景
/init	初始化项目	新项目、接手旧项目、或中途补建记忆时使用。生成 .claude/ 和 CLAUDE.md。
/memory	编辑记忆文件	定义项目规则（如：禁 any、API 格式、命名规范）。这是"教"Claude 懂你项目的关键。
/review	代码审查	提交代码前，让 Claude 审查当前改动（Diff）的质量和风险。
/diff	查看差异	快速查看当前未提交的代码变更。

---

二、会话与上下文管理（高频）

用于控制对话的生命周期，防止上下文混乱。

命令	作用	使用场景
/clear	清空对话	切换项目、或话题彻底改变时，清空当前上下文。
/compact	压缩对话	对话太长，Token 不够用时。Claude 会总结上文，保留 CLAUDE.md 中的核心记忆。
/resume	恢复会话	第二天开工，恢复昨天的对话进度。
/rewind	回退节点	代码改坏了，或想撤销某一步操作时。
/branch	创建分支	从当前对话分叉，尝试不同的解决方案（A/B 测试）。
/rename	重命名会话	给会话起个易懂的名字（如 refactor-auth-module），方便后续查找。
/export	导出对话	将重要的开发讨论导出为 Markdown 存档。

---

三、配置与系统（底层保障）

用于调整 Claude 的行为和系统状态。

命令	作用	使用场景
/config	打开配置	调整终端主题、输出样式等基础设置。
/model	切换模型	在快速模型（Haiku）和强力模型（Opus/Sonnet）之间切换。
/permissions	权限管理	控制 Claude 能访问哪些目录、执行哪些命令（安全相关）。
/mcp	扩展连接	配置 Model Context Protocol，连接外部工具（如 GitHub、数据库）。
/doctor	诊断修复	Claude 运行异常、找不到文件或权限报错时，用于自检。
/cost	查看费用	实时监控当前会话的 Token 消耗和费用。

---

四、补充命令（低频但关键）

这部分是补充内容。虽然不常用，但在复杂项目、自动化、排错时非常有用。

命令	作用	使用场景
/batch	批量处理	需要在多个目录或多个文件中并行执行相同的代码修改（大规模重构）。
/hooks	生命周期钩子	想在 Claude 生成代码后自动执行脚本（如自动格式化 prettier、自动 git add）。
/plugin	插件管理	安装社区插件来扩展 Claude 的能力（如特定的框架支持）。
/agents	子代理	复杂任务分解。例如：让一个 Agent 写测试，另一个 Agent 写文档。
/sandbox	沙盒模式	高危操作时开启，严格限制 Claude 的文件系统访问权限，防止误删。
/vim	Vim 模式	如果你习惯使用 Vim 键位进行文本编辑。
/plan	计划模式	高风险操作前。让 Claude 先输出详细的操作计划，你确认无误后，它再动手改代码。
/add-dir	多目录工作	同时处理位于不同位置的项目（如同时修改前端和后端代码）。
/effort	算力调节	简单任务设为 low，复杂重构设为 high 或 ultrathink，控制思考深度。
/statusline	状态栏	自定义终端底部的状态栏，显示当前模型、会话名等信息。

---

五、推荐工作流

# 1. 进入项目目录（macOS 拖拽法）
cd /path/to/project
claude
2. 初始化（仅首次或中途补建）
/init
3. 设定规则
/memory
4. 开发循环
... coding ...
/review
5. 切换项目或结束
/clear

---

六、"铁律"备忘录

请将以下内容放入你的 CLAUDE.md 中：

## Rules
Never use any. Always define strict types explicitly.
Do not use default exports. Always use named exports.
All API responses must follow: { code: number, data: T, message: string }.
All forms must use react-hook-form. Do not manage form state via useState.