Claude Code Subagents 多 Agent 协作与统一主计划

方法定义

把复杂任务拆给多个 Claude Code Subagents 并行或分阶段处理，但由一份统一的主计划（Main Plan）协调产出方向与边界。橙皮书（claude-code-orange-book（Claude Code 橙皮书仓库））强调"复杂任务用 Subagents，但要保留统一主计划"，避免多个 Agent 各自为政导致方案失控。

适合哪些情况

• 任务范围大，需要并行调研或并行实现不同模块
• 单个 Agent 的上下文窗口不足以容纳全部约束与代码
• 任务可以清晰拆分为互相独立的子任务
• 团队需要一个稳定的总览，方便在 Agent 行动前/后做整体审阅

常见做法

• 在 CLAUDE.md 或独立的主计划文档中写明整体目标、子任务拆分与边界
• 给每个 Subagent 一个明确的子目标与最小上下文，不把主 Agent 的全部凭证传递下去
• 让主 Agent 在 Subagent 完成各自任务后负责汇总与整合
• 通过 Claude Code 计划模式工作流（Plan Mode） 在拆任务前先做整体规划
• 用 用 Hooks 在 Claude Code 生命周期事件上挂接自动化脚本 在 Subagent 触发的关键事件上加日志与校验

限制和检查点

• Subagent 不是权限隔离：它们仍可能继承主 Agent 的凭证与上下文，参见 Claude Code 在 MCP / Hooks / Slash Commands 上的权限与凭证暴露风险
• 多 Agent 协作会放大 prompt 注入与上下文漂移风险，每个 Subagent 都应只看到完成任务所需的最小信息
• 子任务拆分过细反而增加协调成本；拆分的颗粒度应以"每个 Subagent 能独立验证"为准
• 最终质量仍由人工汇总与测试决定，多 Agent 不会自动保证整体一致性

来源

• claude-code-orange-book（Claude Code 橙皮书仓库）
• HuaShu（花叔）
• HuaShu《Claude Code 橙皮书》教程摘要
• sources/25-08-development-automation--35-src-dev-002-claude-code-orange-book--1m81cqu