教程

Claude Code 自定义斜杠命令完全指南:用 /命令 封装常用工作流

Claude Code 自定义斜杠命令(slash commands)完整教程:命令文件创建位置(.claude/commands/)、Markdown 格式规范、$ARGUMENTS 参数传递、项目级命令 vs 用户全局命令的区别、实用命令示例(/review、/test、/deploy-check、/refactor、/standup)、命令组合调用,以及如何在团队中共享和版本管理自定义命令。

2026/3/184分钟 阅读ClaudeEagle

Claude Code 支持自定义斜杠命令(/command), 让你把重复的提示词封装成一个简短命令,一键触发复杂工作流。

什么是自定义斜杠命令?

bash
# 没有自定义命令时,你每次需要输入:
"请对这个 PR 做完整的代码审查,检查:安全漏洞、性能问题、代码规范、测试覆盖..."

# 有自定义命令后:
/review

两者效果完全一样,但第二种只需输入 7 个字符。

命令文件存放位置

项目级命令(团队共享,推荐)

my-project/ └── .claude/ └── commands/ ├── review.md → /review ├── test.md → /test ├── deploy-check.md → /deploy-check └── standup.md → /standup

这些命令提交到 Git 仓库,所有团队成员共享。

用户全局命令(个人专属)

~/.claude/commands/ ├── my-review.md → /my-review └── daily.md → /daily

全局命令在所有项目中都可以使用。

命令文件格式

每个命令是一个 Markdown 文件,内容就是发给 Claude 的提示词:

markdown
# .claude/commands/review.md

请对当前修改的代码进行全面的代码审查,包括:

## 安全检查
- SQL 注入、XSS、CSRF 等常见漏洞
- 密钥和敏感信息是否硬编码
- 权限验证是否完整

## 性能检查
- 是否有明显的 N+1 查询问题
- 循环中是否有不必要的 IO 操作
- 内存使用是否合理

## 代码质量
- 函数是否过长(超过 50 行建议拆分)
- 变量命名是否清晰
- 是否有重复代码可以提取

## 测试覆盖
- 核心逻辑是否有测试
- 边界条件是否覆盖

请输出问题列表,按严重程度排序(Critical / Major / Minor)。

带参数的命令:$ARGUMENTS

使用 $ARGUMENTS 接收命令后面跟的参数:

markdown
# .claude/commands/test.md

请为 $ARGUMENTS 编写完整的单元测试。

要求:
1. 覆盖正常流程、边界条件、异常情况
2. 使用项目现有的测试框架
3. 测试文件命名为 ${文件名}.test.${扩展名}
4. 确保所有测试可以直接运行通过

使用方式:

bash
# 在 Claude Code 中输入
/test src/auth/login.ts
# $ARGUMENTS 会被替换为 "src/auth/login.ts"

实用命令示例集

/deploy-check(部署前检查)

markdown
# .claude/commands/deploy-check.md

执行部署前全面检查,确认以下所有项目:

1. 运行所有测试:`npm test`,必须全部通过
2. 检查是否有未提交的更改
3. 验证 .env.example 是否与 .env 同步(不能有缺失的 KEY)
4. 检查 package.json 中的版本号是否需要更新
5. 确认 CHANGELOG.md 已更新
6. 检查是否有 TODO/FIXME 注释需要在上线前处理

输出:检查结果汇总,标注 ✅ 通过 / ❌ 失败 / ⚠️ 需要确认

/standup(生成每日站会报告)

markdown
# .claude/commands/standup.md

根据今天的 Git 提交记录和当前项目状态,生成每日站会报告:

1. 运行 `git log --since="24 hours ago" --oneline`
2. 查看当前分支状态
3. 检查是否有 JIRA/GitHub Issues 相关引用

输出格式:
**昨天完成:**
- [具体工作内容]

**今天计划:**
- [基于当前未完成的工作推断]

**阻碍:**
- [如果有未解决的问题]

/refactor(智能重构建议)

markdown
# .claude/commands/refactor.md

分析 $ARGUMENTS 文件,给出重构建议:

1. 识别代码坏味道(Long Method、Large Class、Duplicate Code 等)
2. 提出具体的重构方案(附重构后的代码示例)
3. 评估重构的收益和风险
4. 优先级排序(先做影响大且风险低的)

不要直接修改代码,先给出方案让我确认。

/security-audit(安全审计)

markdown
# .claude/commands/security-audit.md

对整个项目进行安全审计:

1. 扫描所有依赖的已知漏洞:`npm audit` 或 `pip-audit`
2. 检查环境变量使用是否安全(没有 hardcode 的密钥)
3. 检查 API 接口的鉴权逻辑
4. 检查文件上传功能的安全处理
5. 检查 SQL/NoSQL 查询的注入风险

输出:安全报告(Markdown 格式,保存到 docs/security-audit.md)

在 CLAUDE.md 中声明可用命令

markdown
# CLAUDE.md

## 可用的自定义命令

| 命令 | 功能 |
|------|------|
| `/review` | 全面代码审查 |
| `/test <文件>` | 为指定文件生成单元测试 |
| `/deploy-check` | 部署前检查清单 |
| `/standup` | 生成每日站会报告 |
| `/refactor <文件>` | 重构建议(不直接修改)|
| `/security-audit` | 全项目安全审计 |

团队协作建议

bash
# 1. 将 .claude/commands/ 目录提交到 Git
git add .claude/commands/
git commit -m "feat: 添加团队 Claude Code 自定义命令"

# 2. 在 README 中说明可用命令
# 3. 鼓励团队成员贡献新命令
# 4. Code Review 时一并审查命令文件的更新

来源:Claude Code 官方文档 - docs.anthropic.com/en/docs/claude-code

相关文章推荐

教程Claude Code Skills 自定义命令:打造你的团队专属 AI 工作流Claude Code Skills 自定义命令完整教程:Skills vs CLAUDE.md 使用场景对比、内置 Skills 速览(/batch/simplify/loop)、SKILL.md 文件格式与 Frontmatter 配置、四大实用 Skills 示例(代码审查/部署检查/功能开发/团队 OnBoarding)、传参方式、子代理执行与 Git 团队共享。2026/3/14教程Claude Code 使用技巧大全:让 AI 编程效率提升 10 倍的 20 个实用技巧Claude Code 深度使用技巧合集:精准任务描述法、上下文管理、/compact 防超限、CLAUDE.md 记忆系统、多文件协作、测试驱动、Hooks 自动化、Sub-Agent 并行、斜杠命令速查,覆盖新手到高级用户全场景。2026/3/15教程Claude Code Hooks 实战指南:5 大自动化场景、三种 Hook 类型与故障排查Claude Code Hooks 实战指南:/hooks 交互菜单四步创建桌面通知 Hook、5 大常用自动化场景(等待通知/编辑后 Prettier 格式化/退出码 2 阻止受保护文件/PostCompact 重注入上下文/ConfigChange 审计日志)、四种 Hook 类型(command/prompt-based/agent-based/HTTP Webhook)、输入/输出机制(stdin JSON/stdout 注入上下文/退出码 0 继续/2 阻止/非零警告)、结构化 JSON 输出、Matcher 过滤器语法(Edit|Write/Bash(git *)/*/空字符串)、四级存储位置,以及五大故障排查方法和调试技巧。2026/3/8教程Claude Code Hooks 完全指南:五大自动化场景、三类 Hook 类型与 JSON 输入输出规范Claude Code Hooks 完整指南:30 秒创建第一个 Hook(/hooks 交互菜单)、五大常用场景(通知/自动格式化/保护文件/压缩后注入上下文/审计配置变更)、六个生命周期事件(PreToolUse/PostToolUse/Notification/PostCompact/SessionStart/Stop)、四类 Hook 类型(Command/Prompt/Agent/HTTP)、JSON 输入输出规范(decision/reason/output/updatedInput)、Matcher 过滤语法,以及五大故障排查方法。2026/3/6教程Claude Code Checkpointing 完全指南:会话回退、代码还原与 /rewind 分叉工作流Claude Code Checkpointing 完全指南:三种操作模式(代码回退/对话回退/摘要压缩)、/rewind 和 /fork 命令用法、分叉多方案探索工作流(从同一节点并行尝试 approach-a 和 approach-b)、Esc+Esc 快捷键,以及 Checkpointing 与 Git 的能力对比和最佳实践建议。2026/3/5教程Claude Code Hooks 实战指南:自动格式化、桌面通知与文件保护Claude Code Hooks 实战指南:5 大场景(桌面通知、自动格式化、文件保护、压缩后注入上下文、配置审计)的完整配置,Hook 输入/输出 JSON 格式,事件类型(PreToolUse/PostToolUse/Notification/PostCompact),以及提示型和 Agent 型 Hook。2026/3/2