Claude Code常用指令整理

开场个人观察

刚开始用 Claude Code 时，我最关心的是“到底有哪些命令”。后来用多了才发现，命令本身不是重点，命令背后的工作流才是重点。一个命令如果不知道什么时候用，很快就会变成收藏夹里的知识；只有放到真实开发场景里，才会变成效率。

Claude Code 的命令主要在会话里用 / 触发。官方文档说明，输入 / 可以看到当前环境可用的命令，也可以继续输入字母过滤。需要注意的是，不同平台、计划、版本、登录状态下，可见命令可能不完全一样，所以不要把网上某一份命令清单当成绝对真理。

这篇笔记按开发阶段整理常用命令：项目准备、任务推进、上下文管理、审查发布、排障恢复。每个命令都配一个我会怎么用的场景。

核心观点

Claude Code 的命令可以理解为“会话控制器”。它们不是替代自然语言，而是帮助你快速切换模式、控制上下文、查看改动、管理风险。

我个人最常用的不是最炫的命令，而是这些朴素命令：

/init：新项目第一次接入时生成项目说明。

/plan：复杂任务先进入计划模式，避免直接乱改。

/context：查看上下文占用，判断是不是该压缩或清理。

/compact：长会话继续推进前压缩上下文。

/diff：查看当前文件改动。

/code-review：提交前让 Claude Code 对 diff 做一次审查。

/rewind：方向错了时回退到前面的检查点。

/skills：查看可用 skill，了解当前环境能调用哪些能力。

实践方法

新项目第一步，我会用：

/init

它适合生成项目级说明，但生成之后不要直接信。你应该打开生成的说明文件，把真实规则补上去，比如安装命令、测试命令、不要修改的目录、发布流程、代码风格。AI 写的项目记忆如果不校对，后面会把错误规则越用越熟。

遇到稍微复杂一点的任务，我会先用：

/plan 给订单列表增加按状态筛选，先不要修改文件

计划模式的意义，是把“要改什么”提前暴露出来。如果计划里出现了明显不相关的文件，或者准备重构过多内容，就可以及时纠正。

会话变长后，我会用：

/context

它能帮助你理解上下文被什么占住了。如果一个会话里混了很多无关问题，我通常不会继续硬聊，而是用：

/compact 请保留当前任务目标、已修改文件、未完成事项和验证结果

这个写法比单独 /compact 更稳，因为你告诉它压缩时要保留什么。

准备验收时，我会用：

/diff

看 diff 是 AI 编程里最重要的习惯之一。不要只看“我改了三个文件，测试通过”这种总结，要看它到底改了什么。

提交前，可以再跑：

/code-review

如果是安全敏感、权限、支付、登录、数据删除这类改动，我还会要求更严格的审查，并手工看关键路径。

如果发现方向错了，不要在错误基础上继续补丁叠补丁，可以考虑：

/rewind

这类命令的价值，是让错误回退更可控。相比手动在一堆改动里挑挑拣拣，回到清晰检查点通常更干净。

踩坑提醒

第一个提醒：命令要放在消息开头。Claude Code 文档里说明，命令只有在消息开头才会被识别，后面的内容会作为参数传给命令。所以不要写成“请帮我 /plan …”，而应该直接以 /plan 开头。

第二个提醒：不要迷信命令清单。官方文档也提示，不是所有命令都会出现在每个用户环境中。你本机没有某个命令，不一定是你用错了，也可能是版本、平台、计划或环境差异。

第三个提醒：/clear 和 /compact 的用途不同。/compact 适合当前任务还没完，但上下文太长；/clear 更适合换一个新任务。不要为了“清爽”把一个还在推进的任务直接清掉。

第四个提醒：审查命令不能替代人工 review。/code-review 可以帮你发现很多明显问题，但关键业务逻辑、权限边界、数据一致性，仍然需要开发者自己负责。

第五个提醒：不要把 /init 当成一次性动作。项目结构变了、测试命令变了、发布方式变了，都应该更新项目记忆，否则后面 Claude Code 会一直按照旧规则工作。

总结

Claude Code 常用指令可以按一句话记：准备时 /init，复杂任务 /plan，长会话 /context 和 /compact，验收时 /diff 和 /code-review，出问题时 /rewind。

真正提高效率的不是记住更多命令，而是知道什么时候该让工具停下来想、什么时候该让它动手、什么时候必须由人来验收。

参考资料

• Claude Code commands reference
• Claude Code interactive mode
• Claude Code CLI reference