Claude Code 自定义斜杠命令入门 ― 打造专属开发工作流

什么是自定义斜杠命令

Claude Code 自带 /help、/clear 等标准斜杠命令,但你知道可以轻松添加专属命令吗?自定义斜杠命令让你用一个简短关键字调用常用提示词或例行任务,熟练运用后能够显著提升日常开发效率。

与其每次都输入冗长的”审查当前分支的代码”之类提示词,不如直接输入 /review 触发相同行为。在团队中共享命令,还能统一代码审查标准或发布流程。

保存位置与文件格式

自定义斜杠命令就是普通的 Markdown 文件。有两种保存位置:

• 项目专用: .claude/commands/<命令名>.md
• 用户全局: ~/.claude/commands/<命令名>.md

项目专用命令可以提交到仓库与团队共享,用户全局命令则可用于你的所有项目。文件名即命令名,所以 review.md 对应 /review。

创建第一个命令

先做一个最简单的命令。在项目根目录执行:

mkdir -p .claude/commands
cat > .claude/commands/review.md <<'EOF'
读取 Git 暂存区中的所有变更,并从以下角度进行审查:

- 潜在的 Bug
- 命名一致性
- 缺失的测试覆盖
- 安全隐患

发现问题时,请附带文件名和行号进行报告。
EOF

这样就完成了。在 Claude Code 中输入 /review,文件内容会直接作为提示词发送。

接收参数

要让命令更实用,就得让它支持参数。在 Markdown 内使用 $ARGUMENTS 占位符,调用时传入的字符串会插入到该位置。

# .claude/commands/explain.md

请针对以下文件或符号,用初学者易懂的方式详细讲解。

目标: $ARGUMENTS

讲解内容应包含:
1. 代码的作用(用一两句话概括)
2. 关键行的逐步解析
3. 实际使用示例
4. 常见陷阱

这个命令用 /explain src/utils/parser.ts 的方式调用。$ARGUMENTS 会被替换为 src/utils/parser.ts 后执行。

引用多个文件的命令

除了通过参数传入文件路径,也可以在命令内部使用 @ 语法显式加载特定文件。

# .claude/commands/check-types.md

请在读取 @tsconfig.json 和 @package.json 之后,
检测整个项目的类型错误。

步骤:
1. 执行 `npx tsc --noEmit`
2. 按文件分组错误
3. 建议修复的优先顺序
4. 从影响范围大的开始排序

请以表格形式输出结果。

执行命令时,Claude 会先自动读取 tsconfig.json 和 package.json,再开始处理。

实战:发布准备命令

下面这个例子将常见的发布流程整合到一个命令里。

# .claude/commands/release.md

请进行版本 $ARGUMENTS 的发布准备。

执行步骤:
1. 将 package.json 的 version 更新为 $ARGUMENTS
2. 在 CHANGELOG.md 顶部添加新章节
   - 参考上一个标签以来的 git log
   - 分类为 feat / fix / docs / chore
3. 执行 `npm run test` 确认所有测试通过
4. 执行 `npm run build` 确认没有构建错误
5. 汇总变更内容并给出提交信息草案

注意: 不要实际执行 git push 或 npm publish。
最终确认交给用户决定。

只需输入 /release 1.4.0,即可自动完成从版本更新到执行测试的所有步骤。为了安全,避免破坏性操作,让人类进行最终确认。

模拟标志与选项

在 Markdown 中编写分支逻辑,就能模拟命令行标志。

# .claude/commands/test.md

参数: $ARGUMENTS

请按以下规则执行:

- 参数为空时: 执行全部测试
- 参数包含 `--unit`: 仅执行单元测试
- 参数包含 `--e2e`: 仅执行 E2E 测试
- 参数包含文件路径: 仅执行与该文件相关的测试

执行后如有失败的测试,请分析原因。

这样就能灵活使用 /test --unit 或 /test src/auth.ts 等调用方式。

团队共享的最佳实践

将项目专用命令放入 .claude/commands/ 并用 Git 管理,就能让团队所有成员使用相同的命令。需要注意以下几点:

• 统一命名规则: 使用动词开头的短名称(review、fix、explain)
• 在 README 中列出清单: 方便大家发现可用命令
• 避免破坏性操作: 明确禁止 git push --force 或 rm -rf
• 指定输出格式: 审查结果等用表格或清单保持一致

总结

自定义斜杠命令是将 Claude Code 打造为”专属 AI 助手”的捷径。先从一两个简单命令开始,每发现一项重复任务就添加一个,不知不觉间它们就会成为你离不开的伙伴。

关于 Claude Code 基本操作,请参阅入门指南;进阶自动化请查看 Agent SDK 入门;上下文管理技巧可以参考上下文管理。

官方文档请查阅 Anthropic 官方文档。