Claude Code 的 Sub‑Agents 与 Slash‑Commands 差异分析与协同配合

 你有没有想过，可以把常用的 AI 操作包装成快捷命令，一键执行，还能让 AI 拆任务后分工合作？Claude Code 正是这样一款能让开发者更高效、更规范、也更有趣地使用 AI 辅助编码的工具。今天我用轻松的语言跟你聊聊它的两个核心功能：Slash‑Commands 和 Sub‑Agents，并告诉你它们有什么特点、用法和区别，还举几个真实的例子让你立马能用。

在 Claude Code 中，Slash‑Commands 就像你事先写好的“快捷按钮”，能一键触发标准流程；而 Sub‑Agents 就像一支由多个 AI 小助手组成的团队，每个小助手专精一项任务，由主 Claude 给它们安排工作。

---

Slash‑Commands：你自定义的 AI 快捷按钮 🚀

特点与用途

• • 自定义提示写一次，用命令调一次：将常用操作（如代码审查、性能优化、Issue 修复）写入 .claude/commands/*.md 文件，Claude 就把这套提示视为一个命令。输入 /命令名 参数 就能自动执行对应流程。
• • 支持参数化：命令中可使用 $ARGUMENTS 占位，输入参数时会替换提示内容，接收 Issue 编号、模块名等参数灵活调用。
• • 项目共享或个人私用：放在 .claude/commands/ 为项目级命令，整个团队都能用；放在 ~/.claude/commands/ 则是个人私有命令。

举例说明

比如你定义一个 /fix-issue 命令，模板里写好修复流程：

修复 GitHub issue：$ARGUMENTS。
请执行以下步骤： 
1. 用 gh issue view 获取详情； 
2. 分析问题； 3. 找到相关代码； 4. 提交修复；…

在命令行输入：

/fix-issue 123

Claude 会进行 Git 操作、代码修改、开 Pull Request，整个过程自动化，省了你一大堆重复步骤（也可以选择是否自动提交）。适合重复修 issue、审查 PR、生成文档等场景。

---

Sub‑Agents：由 AI 拆任务、分工协作的多智能体系统 🧠

特点与用途

• • 每个子代理心无旁骛：Sub‑Agents 是具有独立上下文的“小 Claude”，专门负责一类任务，如性能优化、测试生成、代码审查等，从不干扰主对话体。
• • 角色自定义，可复用：你可以用 /agents 命令创建子代理配置，每个代理有明确名称、描述和权限（如只读代码、运行 tests、调用 grep 等）。
• • 主代理负责统筹，并可串联多个子代理：主 Claude 根据上下文决定哪些子代理执行哪些任务，支持任务拆分、职责分明，最终结果汇总返回主对话界面。

举例说明

假设你定义了几个子代理：

• • code-reviewer.md：只审查代码风格和安全问题
• • test-builder.md：专门生成单元测试
• • debugger.md：负责查错误日志并定位问题

你和 Claude 这样对话：

“请审查 auth 模块” → 主代理调用 code-reviewer 或 @code-reviewer
“这个模块单测写一下” → 调用 test-builder 或 @test-builder
“发现测试失败，找错在哪” → 调用 debugger 或 @debugger

最后主代理把输出汇总给你。整个过程就像你请来了一队 AI 助手各司其职。

---

两者区别：敲门方式不同，分工视角不同

项目	Slash‑Commands	Sub‑Agents
调用方式	开始输入 / 触发命令	对话中自动或显式使用 /agents 调用特定子代理
使用门槛	写模板即可，比较直观	需要定义角色描述、工具权限、提示风格等，比较复杂
场景定位	重复、标准流程类任务	专业、复杂或可拆分任务（如测试、审查、调试）
输出控制	每次用模板一致，比较固定	可以拆多个阶段，用不同代理负责不同环节，输出更细化
可维护性	模板文件易管理，适合团队共享	子代理配置文件复杂，需要版本控制、同步更新

---

使用举例：真实工作流中的两者协同应用 👩‍💻

1. 1. 规范审查流程
• • 写一个 Slash‑Command /security-review，模板里自动检查代码安全点。
• • 主代理调用 security-review，并根据情况再触发 code-reviewer 子代理输出细节。
2. 2. 自动修 Bug + 提单
• • Slash‑Command /fix-issue 456 启动：主代理扫 GitHub issue -> 调用 debugger 查错误 -> 修改代码 -> 再调用 test-builder 写测试 -> 最后开 Pull Request。
3. 3. 模块协作场景
• • 创建 frontend-expert 子代理专注 React 组件优化、创建 backend-optimizer 子代理负责 API 性能。
• • 项目想做一个新 feature 时，主代理一个流程让两个子代理各自产出方案，再汇总由你决策。

---

使用建议

Slash‑Commands 是你的快捷命令按钮，适合反复、标准化的操作
Sub‑Agents 是你背后的 AI 小团队，可拆任务、多角度、各司其职

建议你先试 Slash‑Commands：把最常做的几个操作放到命令里，团队共享模板文件。
熟练之后，再逐步引入子代理，将复杂流程拆给它们去做，主代理调度、你把控。这样可以少走弯路，也不会一开始就被工具搞晕。

如果你是小团队或短项目，一两个 Slash‑Commands 和简单子代理就很够用；长期项目或多人团队，就能慢慢扩展出完整的 AI 协作流水线。就像请了一个靠谱的 AI 助手团队，开发效率和规范性都会明显提升。