Claude Code 实战入门（三）：自定义斜杠命令与对话控制

/clear、/init 这些内置斜杠命令是冰山可见部分。整套系统的重点是你写自己的，并且它们住在你的 Repo 里。

一个斜杠命令是什么

.claude/commands/<name>.md 文件。内容是一段 Markdown Prompt。文件名变成命令名。新建后必须重启 Claude Code（少数不热加载的地方之一）。

最简例。新建 .claude/commands/audit.md：

1
2
3
4

跑 `npm audit` 找出有漏洞的依赖。
跑 `npm audit fix` 应用不破坏的修复。
跑 `npm test` 确认没破。
报告哪些 CVE 已修、哪些还在。

重启之后，任何会话里：

/audit

整段 Prompt 触发。你拿到结构化的审计报告，不用再去记三个命令和它们的顺序。

两点要注意：

1. 命令就是 Prompt。没有 DSL、没有特殊语法。表面积小是有意为之。
2. 不用重复自己。下次团队任何人需要审计，打 /audit 就行。

$ARGUMENTS——参数化

斜杠命令有个魔法 token $ARGUMENTS，会被替换成你在命令名后面打的内容。例——.claude/commands/explain.md：

1
2
3
4
5
6
7

解释 $ARGUMENTS，分三层：

1. 一句话——是什么，大白话。
2. 一段——怎么工作、关键组件、为什么存在。
3. 代码层——指向我们 Repo 里的实现，给行号。

如果这个词有歧义，列出所有含义并问我要哪一个。

然后：

/explain rate limiter

$ARGUMENTS 变成 rate limiter，Prompt 触发，你拿到三层解释，且基于实际 Repo。

我每个项目都有的命令

用了两年 Claude Code 之后我固定下来一组：

/audit——上面的安全审计。

/test——跑测试，总结失败，建议修复。

1
2
3
4
5
6

跑项目的测试套件（看 CLAUDE.md 找命令）。
对每个失败：
  - 引用失败用例名和挂掉的断言
  - 建议最小可信修复
  - 标注：改测试还是改代码
不要动任何东西——这是报告。

/review——对 diff 做 code review。

1
2
3
4

review staged diff（`git diff --staged`）。
重点：正确性、边界情况、命名、是否符合 CLAUDE.md。
按编号 finding 输出，每条带严重度（must-fix / nit / praise）。
最后用一段说你是否会 approve。

/explain $ARGUMENTS——上面那个。

/onboard——给新人写一页入门文档。

1
2
3

给一个新加入此 Repo 的工程师写一页入门文档。
以 CLAUDE.md 为事实来源。
包括：项目做什么、怎么 setup、怎么跑测试、最容易搞坏的三件事、最先看哪里。

5 个命令。覆盖了我每天会反手打的大部分东西。

对话控制——3 个值得肌肉记忆

内置命令里值得肌肉记忆的：

/compact——压缩对话。模型因为上下文大开始变慢时用。保留要点，去掉啰嗦。

/clear——清对话。保留 Memory 和 settings。任务切换时用。

/init——上一篇讲过。每 Repo 一次，bootstrap CLAUDE.md。

还有更多——/help 列出全部——但这三个是日常套件。

关于团队推广

斜杠命令是把约定散播给团队最便宜的方式。在 main 上推三条有用的命令到 .claude/commands/。下一次任何人在这个 Repo 里跑 claude，就有这些命令。用户端零配置。这就是重点。

我见过这个模式对团队范围的 AI 使用推动比任何内训都强。人会复制已经在那的东西，而 .claude/commands/ 是一个装满"已经被认为有用到值得 commit 的东西"的目录。

它不擅长什么

斜杠命令不擅长：

• 任何需要复杂运行时参数（不止是单字符串）的事
• 任何需要在多次调用间保持状态的事
• 任何你想要测试的事

那些场景你要 SDK（第六篇）。斜杠命令是给那些不值得编程复杂度的工作流捷径用的。

下一篇：MCP——让 Claude Code 跟任何东西对话的协议。