Claude Code 指令大全：Vibe Coding 核心武器库

Vibe Coding 宣言：我们不写代码，我们指挥代码。熟练掌握这些指令，你就是 AI 的指挥官。

1. 核心指令 (Core Commands)

这些是你日常开发中最常用的指令，构成了 Vibe Coding 的基础循环。

指令	描述	Vibe 场景
`/init`	初始化。在当前目录启动一个新的 Claude Code 会话。	项目启动的第一步。
`/bug`	修复。自动分析当前报错或异常，并给出修复方案。	遇到报错直接甩给 AI，不要自己看 StackTrace。
`/test`	测试。为当前代码或指定功能生成测试用例。	写完功能立刻运行，确保代码是“活”的。
`/doc`	文档。生成代码注释、README 或 API 文档。	也就是所谓的“垃圾时间”交给 AI 处理。
`/cost`	成本。查看当前会话的 Token 消耗和预估费用。	随时掌握“弹药”消耗情况。
`/help`	帮助。查看所有可用指令和说明。	忘记指令时查阅。

2. 上下文管理 (Context Management)

这是 Vibe Coding 的精髓。 控制 AI 知道什么，不知道什么，直接决定了输出的质量。

/add [文件/目录]
- 作用：将文件或文件夹添加到 AI 的上下文中。
- 技巧：
  - /add src/utils：一次性添加整个工具库。
  - /add *.py：添加所有 Python 文件。
  - Vibe Tip：不要把整个项目都塞进去！只给它看与当前任务相关的文件，保持上下文纯净。
/remove [文件/目录]
- 作用：将文件从上下文中移除。
- 场景：当你完成了一个模块的开发，开始做另一个无关模块时，用这个清理大脑。
/compact
- 作用：压缩上下文。
- 场景：对话太长，AI 开始“胡言乱语”或遗忘之前的指令时，使用此指令让它总结摘要，释放 Token 空间。
/clear
- 作用：清空当前会话历史（但保留已加载的文件）。
- 场景：彻底换个话题，或者觉得 AI 陷入了思维死胡同，重置一下它的短期记忆。

3. 高级开发指令 (Advanced Development)

让 AI 像资深工程师一样工作。

/plan [任务描述]
- 作用：让 AI 先列出计划，而不是直接写代码。
- Vibe Tip：对于复杂功能，必须先 Plan。比如：“/plan 重构用户登录模块，增加 OAuth 支持”。
/review
- 作用：让 AI 审查当前代码变更（Diff）。
- 场景：在提交代码（Commit）之前，让它自己检查一遍有没有低级错误。
/search [关键词]
- 作用：在代码库中搜索特定内容。
- 场景：当你不知道某个函数定义在哪里，或者想找类似的实现参考时。
/run [命令]
- 作用：在终端执行 shell 命令。
- 场景：/run npm install 或 /run pytest。不用切出界面，保持心流。

4. Vibe Coding 组合技 (Combo Moves)

不仅仅是单独使用，组合起来威力更大。

连招 A：光速启动 (The Kickstart)

/init
/add README.md (让它读懂项目目标)
/plan 基于现有架构，实现[新功能]

连招 B：无脑修 Bug (The Debugger)

/run npm test (运行测试，发现报错)
/bug (直接把报错丢给它，让它分析)
/review (检查它修复的代码)
/run npm test (再次验证)

连招 C：遗留代码考古 (The Archaeologist)

/add src/legacy_module.js
请解释这段代码的逻辑，并生成 Mermaid 流程图
/doc 为这个文件生成详细的 JSDoc 注释

5. 常见问题 (Troubleshooting)

Q: AI 总是改坏之前的代码怎么办？
- A: 上下文污染了。使用 /remove 移除不相关文件，或者 /clear 重置会话。确保它只关注当前要修改的一小部分。
Q: 生成的代码跑不通？
- A: 只要报错，就用 /bug。不要自己改。如果 /bug 三次还不行，说明思路错了，用 /clear 后重新 /plan。
Q: Token 消耗太快？
- A: 勤用 /compact。不要一次性 /add 几百个文件。

记住：在 Vibe Coding 的世界里，你不需要懂每一行代码的语法，但你必须懂如何清晰地传达意图。这些指令就是你传达意图的介质。