同时启动多个 Claude Code 代理，分别处理任务的不同部分，由主代理协调并合并结果。
什么是子代理
子代理是 Claude Code 的一项功能，允许你同时运行多个独立的 Claude 实例。每个子代理：
- 获得自己全新的上下文窗口
- 独立访问项目和工具
- 完成后向主会话返回摘要
为什么用子代理
1. 并行处理不同部分
一个需要修改多个独立组件的任务，可以分配给不同的子代理同时处理。
帮我并行完成：
1. 给 auth 模块写测试
2. 给 user 模块写测试
3. 给 api 模块写测试
2. 不占用主会话上下文
子代理有独立上下文，不会撑大你的主会话。它们完成后只返回摘要。
3. 处理长对话
对于需要大量上下文的任务（如大型代码库分析），子代理可以提供"全新的上下文窗口"。
如何使用子代理
方式一：让 Claude 自动分配
当你给出需要并行处理的复杂任务时，Claude 可能会自动启动子代理：
审查这个 PR 中的所有变更，检查安全问题、边界条件和性能
方式二：使用 /agents 命令
运行 /agents 可以配置和管理自定义子代理。
子代理的工作流程
- 主代理接收任务 — 你给出指令
- 主代理分析并分配 — 将任务拆分为子任务
- 子代理并行执行 — 每个子代理独立工作
- 子代理返回结果 — 每个返回完成摘要
- 主代理合并 — 整合所有结果并报告给你
适用场景
| 场景 | 子代理如何帮助 |
|---|---|
| 大型代码库重构 | 每个子代理处理一个模块 |
| 全面代码审查 | 分别审查安全、性能、风格 |
| 批量测试编写 | 并行给不同模块写测试 |
| 多文件迁移 | 每个子代理迁移一部分文件 |
| 上下文满了的长任务 | 子代理有独立的新上下文 |
注意事项
- 子代理之间不共享上下文：它们各自独立工作，不知道彼此在做什么
- 主代理负责协调：确保子任务不冲突，结果能正确合并
- 消耗更多 token：多个子代理并行运行会消耗更多 API 配额
- 适合独立任务：如果子任务之间有强依赖关系，可能更适合顺序执行