自定义命令
Claude Code 带有内置命令,你可以通过输入斜杠来访问这些命令,但你也可以创建自己的自定义命令来自动化经常运行的重复性任务。
创建自定义命令
要创建自定义命令,你需要在项目中设置特定的文件夹结构:
-
1. 在项目目录中找到 .claude文件夹 -
2. 在其中创建一个名为 commands的新目录 -
3. 创建一个具有你所需命令名称的新 markdown 文件(如 audit.md)
文件名成为你的命令名称——所以 audit.md创建 /audit命令。
示例:审计命令
这是一个实用的自定义命令示例,它审计项目依赖项的漏洞:
这个审计命令做三件事:
-
1. 运行 npm audit来查找有漏洞的已安装包 -
2. 运行 npm audit fix来应用更新 -
3. 运行测试来验证更新没有破坏任何东西
创建命令文件后,你必须重启 Claude Code 才能识别新命令。
带参数的命令
自定义命令可以使用 $ARGUMENTS占位符接受参数。这使它们更加灵活和可重用。
例如,write_tests.md命令可能包含:
为以下内容编写综合测试:$ARGUMENTS
测试约定:
* 使用 Vitests 配合 React Testing Library
* 将测试文件放在与源文件相同文件夹的 __tests__ 目录中
* 将测试文件命名为 [filename].test.ts(x)
* 导入使用 @/ 前缀
覆盖范围:
* 测试正常路径
* 测试边界情况
* 测试错误状态
然后你可以使用文件路径运行这个命令:
/write_tests hooks 目录中的 use-auth.ts 文件
参数不必是文件路径——它们可以是你想传递的任何字符串,以给 Claude 提供上下文和任务方向。
主要好处
-
• 自动化- 将重复性工作流程转变为单个命令 -
• 一致性- 确保每次都遵循相同的步骤 -
• 上下文- 为 Claude 提供特定于项目的指令和约定 -
• 灵活性- 使用参数让命令适用于不同的输入
自定义命令对于项目特定的工作流程特别有用,如运行测试套件、部署代码或按照团队约定生成样板代码。

