Claude Code 内置了一批以斜杠开头的命令,你也可以创建自己的命令,把常见流程自动化。
创建自定义命令
在项目中准备以下目录结构:
- 找到项目中的
.claude目录 - 在其中创建
commands目录 - 创建一个以命令名命名的 Markdown 文件(如
audit.md)
文件名就是命令名,因此 audit.md 会生成 /audit 命令。
示例:审计依赖的命令
一个实用的命令是检查依赖安全问题:
- 运行
npm audit找出漏洞 - 运行
npm audit fix自动修复 - 运行测试验证修复不破坏功能
创建命令文件后,需要重启 Claude Code 才能识别新命令。
带参数的命令
自定义命令可以使用 $ARGUMENTS 占位符接收参数,从而更灵活。
例如 write_tests.md:
Write comprehensive tests for: $ARGUMENTS
Testing conventions:
* Use Vitests with React Testing Library
* Place test files in a __tests__ directory in the same folder as the source file
* Name test files as [filename].test.ts(x)
* Use @/ prefix for imports
Coverage:
* Test happy paths
* Test edge cases
* Test error states
调用方式:
/write_tests the use-auth.ts file in the hooks directory
参数可以是任意文字说明,不一定是文件路径。
关键收益
- 自动化:把重复流程变成一个命令
- 一致性:确保每次执行遵循相同步骤
- 上下文:为 Claude 提供固定的项目约定
- 灵活性:通过参数适配不同场景
自定义命令非常适合项目内的固定流程,例如测试、部署、代码生成等。