Claude Code 自定义斜杠命令完整指南

发表于 分类于 ，

Claude Code 自定义斜杠命令完整指南

在Claude Code中，自定义斜杠命令允许开发者将常用的提示词定义为Markdown文件，方便重复使用。这些命令按作用域组织（项目专用或个人），并支持通过目录结构进行命名空间管理。

基本语法

使用自定义命令的语法非常简单：

1
/<命令名> [参数]

其中：

  • <命令名>：由Markdown文件名决定（不包含.md扩展名）
  • [参数]：可选参数，传递给命令

命令类型

项目命令

项目命令存储在代码仓库中，与团队共享。在/help列表中，这些命令在描述后会显示”(project)”标记。

存储位置：.claude/commands/

例如，创建一个/optimize命令：

1
2
3
# 创建项目命令
mkdir -p .claude/commands
echo "分析这段代码的性能问题并建议优化方案：" > .claude/commands/optimize.md

个人命令

个人命令仅对当前用户可见，不会提交到版本控制系统。

存储位置：~/.claude/commands/

命令文件结构

每个命令文件应该遵循以下结构：

1
2
3
命令的简短描述

## Usage

/command-name <参数>

1
2
3
4
5
6
7
8

## Parameters
- `<参数名>`: 参数描述

## What this command does
详细说明命令的功能和执行步骤

## Example

/command-name example-arg

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
```

## 最佳实践

### 1. 命名规范
使用清晰、简洁的命令名称，避免与系统命令冲突。优先使用动词开头的名称，如 `/optimize`、`/deploy`、`/test`。

### 2. 文档完整性
每个命令都应该包含完整的使用说明，包括参数说明、使用示例和预期输出。这有助于团队成员快速理解和使用命令。

### 3. 参数验证
在命令中包含参数检查逻辑，确保传入的参数符合预期格式和要求。

### 4. 错误处理
考虑各种异常情况，为常见错误提供清晰的提示信息。

### 5. 团队协作
项目命令应该考虑团队成员的不同技能水平和使用场景，提供适当的灵活性。

## 高级功能

### 目录结构命名空间

可以使用子目录来组织相关命令：

```bash
.claude/commands/
├── git/              # Git 相关命令
│   ├── smart-commit.md
│   └── branch-cleanup.md
├── deploy/           # 部署相关命令
│   ├── staging.md
│   └── production.md
└── blog/             # 博客相关命令
    └── publish.md

使用时：/git/smart-commit，/deploy/staging等。

参数处理

命令可以接收和处理各种类型的参数：

  • 文件路径：处理具体文件或目录
  • 选项标记：控制命令行为的开关
  • 文本内容：传递给命令的具体内容
  • 数字参数：用于配置数量、大小等数值

与其他工具集成

自定义命令可以与各种开发工具无缝集成：

Git 操作

  • 智能提交信息生成
  • 分支管理和清理
  • 代码审查流程自动化

文件系统操作

  • 批量文件处理
  • 项目结构生成
  • 模板文件创建

API 调用

  • 自动化测试接口
  • 数据获取和处理
  • 第三方服务集成

外部程序执行

  • 构建和部署脚本
  • 测试套件运行
  • 代码质量检查

总结

通过合理使用自定义斜杠命令，开发者可以显著提高工作效率，将复杂的工作流程封装为简单易用的命令调用。这不仅减少了重复性工作，还确保了团队操作的一致性和标准化。

无论是个人开发还是团队协作，自定义命令都能帮助你构建更高效、更专业的开发环境。开始创建你的第一个自定义命令，体验工作流程优化带来的便利吧！