多个子代理按顺序执行，每个代理完成后将结果传递给下一个代理。
explore → code-reviewer → tester
先探索代码结构，再用 code-reviewer 审查，最后生成测试
返回首页
Sub-Agent 子代理系统
通过专业化子代理协同工作，让 Claude Code 具备处理复杂任务的能力
6+ 内置子代理
∞ 扩展能力
4 协同模式
什么是 Sub-Agent？
Claude
code-reviewer
debugger
refactorer
tester
explore
librarian
分布式智能
Sub-Agent 是 Claude Code 的专业化代理组件，每个子代理专注于特定领域。当面对复杂任务时，主代理可以调用相应的子代理协同处理。
用户请求
→
主代理
→
Sub-Agent
专业化处理结果
任务分发机制
主代理分析任务需求，智能分发到最适合的子代理。子代理独立处理完成后，结果返回主代理进行整合和输出。
专业化专注
协同工作
持续进化
可扩展
核心优势
子代理系统提供更高效、更专业的问题解决能力，同时保持系统的灵活性和可扩展性。
协同工作模式
多个子代理同时处理不同部分，最后汇总结果。
explore | librarian | debugger
↓ 汇总 并行探索代码、查找文档、诊断问题 主代理协调多个子代理，处理复杂的多阶段任务。
主代理
子代理 A 子代理 B 子代理 C
分析项目架构，审查关键模块，生成完整报告 子代理处理结果反馈给主代理，主代理判断是否需要继续调用其他代理。
主代理 → 子代理
反馈结果
审查代码 → 修复问题 → 再次审查 → 确认通过 内置 Sub-Agents
6 个专业子代理 代码质量
code-reviewer
全方位代码审查，检查潜在 bug、安全漏洞、性能问题和代码规范，提供改进建议。
核心能力
- 静态代码分析
- 安全漏洞检测
- 性能优化建议
- 代码规范检查
调用示例
code-reviewer: 审查 src/auth/ 模块 用 code-reviewer 检查潜在安全问题 问题诊断
debugger
智能调试分析，定位错误根源，分析堆栈信息，提供修复方案和预防建议。
核心能力
- 堆栈分析
- 错误定位
- 修复方案生成
- 预防措施建议
调用示例
debugger: 分析这个崩溃原因 为什么这个 API 返回 500？ 代码优化
refactorer
代码重构专家，识别代码异味，提供重构方案，平衡可读性与性能。
核心能力
- 代码异味识别
- 重构方案设计
- 依赖关系分析
- 渐进式重构
调用示例
refactorer: 重构这个复杂函数 优化这段重复代码 质量保障
tester
测试生成专家，为代码编写单元测试、集成测试和端到端测试，确保代码覆盖率。
核心能力
- 单元测试生成
- 集成测试设计
- E2E 测试编写
- 覆盖率分析
调用示例
tester: 为这个模块写测试 生成 API 的集成测试 代码探索
explore
深入探索代码库，理解项目结构，追踪功能实现，绘制架构图谱。
核心能力
- 代码库结构分析
- 功能追踪
- 依赖关系图谱
- 架构可视化
调用示例
explore: 查找认证相关代码 这个项目如何处理支付？ 知识检索
librarian
外部知识检索专家，搜索文档、API 参考和开源项目，提供准确的技术答案。
核心能力
- 文档搜索
- API 参考查找
- 开源项目分析
- 最佳实践建议
调用示例
librarian: 查找 React Hooks 最佳实践 如何在 Node.js 中处理 WebSocket？ 使用指南
直接调用
在对话中直接使用子代理名称前缀来调用特定的子代理。
基本语法
[子代理名称]: [任务描述]
或
用 [子代理名称] [任务描述]实际示例
code-reviewer: 审查 src/utils/auth.ts 文件
用 debugger 分析这个 TypeError 错误
refactorer: 重构这个数据处理函数
tester: 为 userService 生成单元测试斜杠命令
使用斜杠命令查看和管理可用的子代理。
查看列表
/agents终端输出
可用 Sub-Agents:
• code-reviewer - 代码审查
• debugger - 调试分析
• refactorer - 代码重构
• tester - 测试生成
• explore - 代码探索
• librarian - 知识检索隐式调用
主代理会根据任务内容自动判断是否需要调用子代理。
隐式调用示例
"帮我检查这个函数的性能问题"
"这段代码有什么安全风险吗？"
"为这个类编写测试用例"主代理会自动识别这些任务并调用相应的子代理处理。
1. 任务接收
主代理接收用户请求，分析任务需求
→
2. 代理选择
根据任务类型选择最适合的子代理
→
3. 任务执行
子代理处理任务，生成处理结果
→
4. 结果整合
主代理整合结果，返回给用户
实际案例
用户请求
"重构用户认证模块并添加测试"
explore → refactorer → tester
执行结果
- explore: 理解认证模块结构
- refactorer: 优化代码结构
- tester: 生成完整测试用例
上下文传递
子代理可以访问主代理的上下文信息，确保处理的一致性。
主代理上下文
→ 传递 →
子代理上下文
上下文隔离
每个子代理有独立的上下文空间，避免相互干扰。
code-reviewer 独立上下文
debugger 独立上下文
tester 独立上下文
上下文优化
合理使用子代理可以有效管理上下文消耗。
推荐做法
明确指定子代理任务，避免上下文浪费
注意事项
过度使用子代理可能导致上下文膨胀
高级用法
组合调用
在一个请求中组合多个子代理，实现复杂任务处理。
先用 explore 了解代码结构，
再用 code-reviewer 审查代码，
最后用 tester 生成测试条件分支
根据子代理的处理结果决定下一步操作。
如果 code-reviewer 发现严重问题，
先用 refactorer 修复，
然后再次审查确认循环迭代
反复调用子代理直到达到预期结果。
循环:
调用 refactorer 重构代码
如果 reviewer 通过则退出
否则继续重构错误处理
子代理处理失败时的回退策略。
尝试用 debug 分析问题
如果失败，调用 librarian 查找解决方案常见问题
Sub-Agent 和普通回复有什么区别？
Sub-Agent 是专门化的 AI 代理，针对特定任务进行了优化。每个子代理有明确的角色定义、专业能力和工作流程，使其在特定领域表现更专业。
如何选择使用哪个 Sub-Agent？
根据任务类型选择：代码审查用 code-reviewer，调试分析用 debugger，代码重构用 refactorer，测试生成用 tester，代码探索用 explore，知识检索用 librarian。
可以同时使用多个 Sub-Agent 吗？
是的，主代理可以协调多个子代理协同工作。支持顺序调用、并行处理、层级管理和迭代优化等多种协同模式。
Sub-Agent 会消耗更多 Token 吗？
通常是的，因为子代理需要额外的上下文来理解其角色定义和任务约束。但专业化的处理通常能以更少的迭代完成更复杂的任务。
如何创建自定义的 Sub-Agent？
通过 Skills 系统创建自定义 Agent。定义 Agent 的角色、能力、工作流程和约束条件，然后通过斜杠命令调用。
Sub-Agent 处理失败怎么办？
可以设置错误处理策略，如调用其他子代理重试、使用 librarian 查找解决方案，或返回主代理进行人工干预。