用途:当任务需要多个 Claude Code 会话协作时,用 Agent Teams 组建团队。核心原则是只有当成员之间确实需要互相通信时才组队;若任务彼此独立、成员永远不会互发消息,应改用并行子智能体而非团队。适用场景包括:并行调研且一个方向的发现会改变另一个方向、前端/后端/测试需协调的多模块特性、需协商接口的跨层改动、需要共享证据的竞争假设调试、跨多个子系统的大规模重构。不适合简单独立任务、顺序依赖任务、单文件或单模块改动、未启用该功能或协作任务少于两个的情况。
前置条件:Agent Teams 属实验性功能,需设置环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=true,否则 TeamCreate、TaskCreate、SendMessage 等工具不可用。这些属于延迟加载工具,首次使用前需通过 ToolSearch 加载。
主要流程:先枚举任务、标出需要共享信息的任务对、统计协作任务对数量,再决定是否组队。组队时先调用 TeamCreate 创建团队,再用 Agent 工具派生 2 至 5 名成员(人数越多协调成本越高)。每名成员可用 EnterWorktree 在独立 git 工作区中作业以避免文件冲突。用 TaskCreate 定义任务范围、文件归属与完成标准,用 TaskUpdate 设置 owner 和 addBlockedBy 依赖。团队负责人用 TaskList 跟踪进度,用 SendMessage 直发消息转达发现、解除阻塞,仅在关键全队问题时才用广播。全部完成后统一审查改动、确认无文件冲突、跑完整测试并整合工作区。
限制:不得让多名成员编辑同一文件,不得跳过整合审查,不得忽略成员消息,团队不得超过 5 人,不得用广播发日常更新,不得在未设计任务的情况下组队。成员在等待消息或任务时会处于空闲状态属正常现象。成员数量和具体团队模式依资料中 team-patterns.md 所述,此处不详述。