Claude Code 自定义命令指南

Claude Code 支持创建自定义斜杠命令 (Slash Commands)，让你可以快速执行常用操作。本章介绍实用的自定义命令及其使用方法。

---

什么是自定义命令

自定义命令是存放在 .claude/commands/ 目录下的 Markdown 文件，可以通过 /<command-name> 快速调用。

命令文件结构

---
description: 命令描述（显示在命令列表中）
argument-hint: [参数提示]
allowed-tools: Read, Edit, Bash(git:*)
---

# 命令标题

这里是命令的 Prompt 内容...
可以使用 $ARGUMENTS 引用用户传入的参数

命令存放位置

.claude/
└── commands/
    ├── think-harder.md
    ├── reflection.md
    └── gh/
        ├── review-pr.md
        └── fix-issue.md

---

分析思考类命令

/think-harder - 增强分析思考

用于复杂问题的深度分析。

使用方式：

/think-harder 如何设计一个高并发的订单系统？

核心流程：

1. 问题澄清 - 定义核心问题，识别隐含假设
2. 多维分析
   • 结构分解：拆分为基础组件和依赖
   • 利益相关者视角：考虑所有受影响方
   • 时间分析：短期 vs 长期影响
   • 因果推理：映射因果关系和反馈循环
3. 批判性评估 - 挑战假设，识别认知偏见
4. 综合整合 - 连接跨领域洞察

输出格式：

• 问题重构
• 关键洞察
• 推理链条
• 备选方案
• 不确定性
• 可执行建议

---

/think-ultra - 超级深度分析

比 /think-harder 更全面的分析，适用于极复杂问题。

使用方式：

/think-ultra 如何从零构建一个 AI 编程助手？

---

/reflection - 指令反思分析

分析当前会话，改进 CLAUDE.md 中的指令。

使用方式：

/reflection

核心流程：

1. 分析阶段 - 审查对话历史，检查当前 CLAUDE.md
2. 识别问题
   • Claude 响应中的不一致
   • 对用户请求的误解
   • 可以提供更详细信息的地方
3. 交互阶段 - 提出改进建议，等待确认
4. 实施阶段 - 修改 CLAUDE.md 文件

最佳实践：

• 使用 TodoWrite 跟踪分析进度
• 在修改前充分阅读当前 CLAUDE.md
• 考虑边缘情况和常见场景

---

/reflection-harder - 深度会话分析

综合分析整个会话，捕获学习和改进点。

使用方式：

/reflection-harder

---

/eureka - 记录技术突破

当你有重要的技术洞察时，用这个命令记录下来。

使用方式：

/eureka 发现 React 18 的 Suspense 可以完美解决数据获取的瀑布问题

---

GitHub 集成命令

/gh:review-pr - PR 代码审查

自动获取 PR 详情并进行代码审查。

使用方式：

/gh:review-pr 123

核心流程：

1. 获取 PR 详情：gh pr view 123
2. 获取代码差异：gh pr diff 123
3. 分析变更并提供审查意见
4. 直接在 GitHub 上发表评论

审查焦点：

• 代码正确性
• 项目规范遵循
• 性能影响
• 测试覆盖
• 安全考虑

评论格式：

# 获取 commit ID
gh api repos/OWNER/REPO/pulls/123 --jq '.head.sha'

# 发表评论
gh api repos/OWNER/REPO/pulls/123/comments \
    --method POST \
    --field body="建议：这里可以使用 useMemo 优化" \
    --field commit_id="abc123" \
    --field path="src/components/List.tsx" \
    --field line=42 \
    --field side="RIGHT"

---

/gh:fix-issue - Issue 修复流程

完整的 Issue 修复工作流。

使用方式：

/gh:fix-issue 456

核心流程：

1. 获取 Issue 详情
2. 分析问题根因
3. 创建修复分支
4. 实施修复
5. 创建 PR 并关联 Issue

---

工具类命令

/translate - 技术翻译

将英文/日文技术内容翻译成中文。

使用方式：

/translate This article explains the fundamentals of RAG...

特点：

• 保留技术术语
• 保持代码格式
• 适当的中文技术表达

---

/cc:create-command - 创建新命令

快速创建新的自定义命令。

使用方式：

/cc:create-command deploy "自动化部署到生产环境"

---

创建自己的命令

步骤 1：创建命令文件

mkdir -p .claude/commands
touch .claude/commands/my-command.md

步骤 2：编写命令内容

---
description: 我的自定义命令描述
argument-hint: [参数说明]
allowed-tools: Read, Write, Bash
---

# 命令标题

你是一个专业的 [角色]。

## 任务

根据用户输入的 $ARGUMENTS，执行以下操作：

1. 第一步
2. 第二步
3. 第三步

## 输出格式

-   使用清晰的标题
-   提供具体的建议

步骤 3：使用命令

/my-command 参数内容

---

命令配置参数

allowed-tools 常用值

• Read - 读取文件
• Write - 写入文件
• Edit - 编辑文件
• Glob - 文件搜索
• Grep - 内容搜索
• Bash - 执行命令
• Bash(git:*) - 仅允许 git 命令
• Bash(gh:*) - 仅允许 gh 命令
• TodoWrite - 任务管理
• WebFetch - 网页获取

---

最佳实践

1. 命名清晰 - 命令名应直接表达功能
2. 描述准确 - description 要让用户一眼看懂
3. 限制工具 - 使用 allowed-tools 限制权限
4. 结构化输出 - 定义清晰的输出格式
5. 错误处理 - 考虑边缘情况

---

推荐命令集

---

参考资源：feiskyer/claude-code-settings