教程

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 Sub-agents 官方完整指南:内置 Agent、自定义配置、并行模式和 Fork 会话Claude Code Sub-agents 官方文档完整整理:解决的核心问题(保护上下文/成本控制);三个内置 Sub-agent(Explore/Plan/General-purpose 及各自模型和工具);/agents 创建流程(界面/描述生成/工具选择/持久内存配置);完整 Frontmatter 字段参考;模型选择策略(Haiku 探索→Sonnet 审查→Opus 复杂任务);MCP 服务器限定到 Sub-agent;自动委托 vs 显式调用;前台/后台运行;隔离高容量/并行调研/链式 Sub-agent 三种模式;Fork 会话(与命名 Sub-agent 的区别);以及 4 个官方示例配置。2026/5/8教程Claude Code 官方最佳实践完全指南:Anthropic 工程团队总结的 25 条黄金法则Anthropic 官方 Best Practices 完整整理:核心约束(上下文管理);给 Claude 可验证标准(最高杠杆);探索→规划→实现→提交四步流程;精准提示 4 策略;丰富上下文输入方式;CLAUDE.md 有效写法(含 ✅/❌ 清单和 @ 引入语法);权限预设;CLI 工具配置;MCP 服务器选择;Hooks 自动化;Skills vs CLAUDE.md 选择;高效沟通技巧;会话管理(提前纠正/激进 /compact/Subagent 调研);以及非交互模式和多 Session 并行的规模化技巧。2026/5/8教程Claude Code 自定义 Agents 完整指南:创建专用 AI 编程助手Claude Code 自定义 Agents 完整指南:Agent 定义文件格式(Frontmatter 字段:name/description/tools/permissionMode/model/effort/context);4 种调用方式(/agents 界面/--agent CLI/对话提及/Print 模式自动化);4 个实战 Agent 配置(安全审查员/数据库优化顾问/无障碍合规检查/TypeScript 类型安全/CI 失败分析师);skillOverrides 控制可见性;context: fork 独立上下文;以及在 GitHub Actions 里使用 Agent 的 CI 配置示例。2026/5/7教程Claude Code Remote Control 完整指南:用浏览器界面控制本地终端会话Claude Code Remote Control 完整指南:取本地权限和云端 UI 两者之长;两种启用方式(--remote-control 标志和 /remote-control 命令);4 个核心使用场景(手机远程审查/向同事展示/大屏查看长输出/配合 /diff 可视化);与 Ultraplan/Ultrareview 的互斥关系;/teleport 反向操作(把 Web/iOS 会话拉回本地);/desktop 移交到桌面应用;以及安全注意事项。2026/5/7教程Claude Code /batch 命令实战:在 30 个并行 Worktree 上执行大规模重构/batch 命令完整实战指南:适用场景(全库 async/await 迁移/统一错误处理/批量添加类型注解);4 个完整实战示例(async/await 迁移/统一错误格式/API 响应格式/TypeScript 类型注解);/batch vs 手动 worktree 的区别;配合 Hooks 自动 lint;大规模变更风险控制(git tag + 小范围先测试 + ultrareview 审查);以及关联命令 /loop 的定期任务用法。2026/5/6