用途:Agent Teams 用于在 Claude Code 中配置多智能体团队协作,适合多个代理并行工作、代理间需要持续通信、后台任务需要进度汇报、复杂工作流需要任务协调,以及对同一代码库做独立改动(配合 worktree)的场景。若任务顺序依赖、单一聚焦任务、输出直接进入下一步或上下文共享即可,则更适合用子代理。
主要能力:实验性功能,需设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1,且可能随版本变化。Claude Code 2.1.178 起移除了显式 TeamCreate/TeamDelete,设置该变量后每个会话自带一个隐式团队,无需创建或销毁;team_name 参数仍被接受但被忽略。原生工具包括:Agent(生成队友,需给名字)、SendMessage(私信、广播、关闭请求、计划审批)、TaskCreate/TaskList/TaskUpdate(创建、发现、分配与推进共享任务)、TaskOutput(获取后台代理输出)、TaskStop(停止后台代理)。任务状态有 pending、in_progress、completed、blocked,队友按 ID 顺序认领任务并跳过被阻塞任务。
使用方式:设置环境变量后,用 TaskCreate 创建工作单元,用 Agent 工具带名字生成队友,用 TaskUpdate 分配任务,结果自动返回。队友消息在回合间自动送达 lead 收件箱,无需轮询。通信统一走 SendMessage,收件人用 name 而非 agentId;广播开销大应少用。完成后向每个队友发送 shutdown_request,无需 TeamDelete。
限制与注意:子代理的工具面可能不含 Agent 等并行生成工具,可能静默退化为串行执行,建议由主线程做扇出。worktree 隔离代理存在相对路径解析到父仓库的上游缺陷,需用绝对路径加固并做事后检查。SendMessage 恢复已完成的 worktree 隔离代理会丢失隔离,应重新派发。Web 会话中队友可能遇到 git push 的 TLS 错误,推送与 PR 操作应交给 lead。详细示例见 REFERENCE.md。