第 03 模块 · 2 节

自定义斜杠命令与快捷指令

《Claude Code 基础入门》03 斜杠命令全掌握 · 本节时长 30 分钟

内置命令不够用?自己造

内置斜杠命令是「官方快捷键」。但你的工作有自己的重复动作——比如每次都让 Claude Code「按项目规范审查一遍」。这时候,把这一长串指令存成你自己的斜杠命令,以后敲一个 / 就触发。

思路:凡是你反复用、规则固定的操作,都值得固化成自定义命令。

贯穿项目这一节我们给 todo 造一个 /review-todo 命令,把「审查 todo 代码」的固定套路固化下来——这正是自定义命令最典型的用法。

什么是自定义斜杠命令

自定义命令把「一长段固定指令」绑定到一个简短的 /名字 上。调用它,就等于把那段指令完整发给了 Claude Code。

适用例子:

  • /review:按团队规范做代码审查
  • /commit:按规范写提交信息
  • /clean:清理没用的 import 和注释

怎么定义

自定义斜杠命令通常以配置文件的形式定义。以 Claude Code 的 .claude/commands 目录为例,你新建一个文件,文件名就是命令名:

.claude/commands/
  review.md      # 对应 /review
  commit.md      # 对应 /commit

文件内容就是你要固定下来的那套指令:

---
description: 按团队规范做一次代码审查
---
请以资深工程师身份,对本次改动做代码审查:
1. 检查逻辑错误、边界情况、异常处理
2. 指出可读性和性能问题
3. 只输出「必须改 / 建议改 / 可不改」三档,简短直给

保存后,在 Claude Code 里敲 /review,就会执行这套审查指令。

注意不同版本/配置方式,自定义命令的存放目录可能略有差异。以你所用版本文档为准,原理一致:一个「名字 = 一套指令」。

设计好命令的三个原则

  1. 规则固定:指令要能重复执行,别写一次性的东西
  2. 目标明确:命令只干一件事,别塞一堆
  3. 团队共享:把命令放进 Git 仓库,全组都能用

落地练习:给 todo 造一个 /review-todo

todo-app 里建自定义命令,让 Claude Code 以后每次按固定套路审查 todo:

  1. 建目录:mkdir -p .claude/commands
  2. 新建 .claude/commands/review-todo.md,内容:
---
description: 审查 todo 代码的规范与边界情况
---
审查这个 todo 工具的代码:
1. 是否处理了「没有待办」时的空状态
2. 待办名称是否允许为空,不允许的话有没有提示
3. 有没有遗漏的边界情况(超长名称、重复项等)
4. 按「必须改 / 建议改 / 可不改」三档输出,简短直给
  1. 在 Claude Code 里敲 /review-todo,执行这套审查

怎么判断做对了?——敲 /review-todo 后,Claude Code 开始按这四条规则审查代码,而不是你临时描述。这就实现了「一次定义、反复复用」。

卡住了怎么办?/review-todo 没反应?文件路径或文件名拼错了,检查是不是 .claude/commands/ 下、文件名是 review-todo.md。命令弹出来了但内容不对?打开文件核对内容。


常见坑:把「一次性指令」固化成命令

新手容易把一次性的、带具体文件名的指令存成自定义命令,结果下次复用就过时了。

自定义命令应该是规则而不是个案。比如「审查 todo 代码」是可复用的规则;而「把 05 行改成 xxx」是一次性的。只固化规则,别固化个案。 否则命令用一两次就失效了。


小结

  1. 自定义命令 = 把固定指令绑定到 /名字
  2. 存在配置目录,文件名即命令名
  3. 规则固定、目标明确、团队共享
  4. 固化「规则」、别固化「个案」
  5. 我们给 todo 造好了 /review-todo

下一节,用 CLAUDE.md 让 Claude Code 长期记住你的偏好。