Agent Teams是Claude Code中用于协调多个AI实例协同工作的机制，突破了传统子代理模式中"主→从"单向通信的局限。通过引入团队负责人、队友智能体、共享任务列表和消息系统四大组件，实现点对点通信、任务自动依赖管理和对抗式讨论，为复杂任务提供了全新的协作范式。
智能速览
Agent Teams支持多智能体点对点直接通信，无需通过主对话中转
共享任务列表支持依赖关系和自动解锁，避免任务竞争
提供三种并行模式：进程内、分屏和分离模式
委托模式让Team Lead专注协调，不直接执行任务
Token消耗约为单会话3-4倍，适合复杂长耗时任务
仍处于实验阶段，存在功能不稳定风险
精华内容
Agent Teams不仅将任务并行化，更引入了一种全新的协作范式，让多个AI实例在同一个项目中真正协同工作，通过互相通信、共享进度甚至对抗式讨论来提升整体效率。
核心架构
Agent Teams由四个核心组件构成：Team Lead作为团队主会话负责任务拆解和进度协调；Teammates是独立运行的Claude实例，拥有各自上下文；Task List作为共享任务看板支持依赖关系和状态管理；Mailbox消息系统实现智能体间点对点通信。这些组件共同构建了一个去中心化的协作网络，让每个智能体都能独立工作又保持紧密联系。
任务依赖关系通过文件锁机制防止竞争条件，当前置任务完成后，被阻塞任务会自动解锁，无需人工干预。这种设计确保了并行执行的正确性和一致性。
启用配置
Agent Teams默认关闭，需手动启用。推荐编辑 ~/.claude/settings.json 文件，在env节点中添加 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=true 配置并重启Claude Code。临时测试则可在终端设置环境变量，但仅当前会话生效。
提供三种显示模式：进程内模式所有队友在同一终端显示，可通过快捷键切换；分屏模式每个队友有独立窗格，需安装tmux支持；auto模式会自动检测环境选择合适模式。在macOS上，iTerm2用户建议使用 tmux -CC 获得更好的分屏体验。
启动方式
启动Agent Teams有两种方式：自然语言描述目标让Claude自动创建，或手动指定队友和职责。Claude不会在未经确认的情况下创建团队，用户始终拥有最终决定权。
创建团队时，启动提示至关重要。需要包含任务目标、文件范围、技术约束和期望产出物。例如：“审查认证模块，重点关注权限验证和会话管理，涉及auth.py和permissions.py”，这样具体的上下文能让队友更快进入工作状态。
高级功能
委托模式通过Shift+Tab切换，让Team Lead只负责协调调度，不直接编写代码。计划审批模式要求队友先提交执行计划，经Team Lead审批后再实施，适合高风险任务。还可为不同队友指定不同模型，实现成本和质量的最优分配。
权限管理方面，可通过 /permissions 命令预先批准常用操作，避免频繁确认成为瓶颈。如需跳过所有权限检查，需谨慎评估风险，因为队友可执行任何危险操作。
适用场景
Agent Teams特别适合多维度代码审查、多假设调试、跨层功能开发和技术方案论证。例如让安全、性能、可维护性专家同时审查同一段代码，或让多个调查员并行验证不同bug假设。
不适合任务间高度耦合、简单线性任务或成本敏感场景。对于日常简单任务，单个会话或Subagents仍是更经济的选择。建议新手从审查PR、调研选型等不涉及代码编写的任务开始体验。
成本控制
Agent Teams的Token消耗约为单会话的3-4倍，但能将跨层开发从30-40分钟压缩到10-15分钟。成本效益取决于时间节省是否超过额外Token成本。
控制策略包括：限制活跃队友数量，非必要不保持过多队友运行；使用更经济的模型处理简单子任务；定期清理已完成任务的队友；合理拆分任务避免重复工作。当面临耗时超过30分钟的复杂任务时，Agent Teams往往值得投入。
Agent Teams代表了从单智能体到多智能体协作的范式升级，在复杂任务中展现出独特的效率和优势。随着功能逐渐成熟，它将成为AI辅助开发的重要模式，但也需要用户在成本、稳定性和协调复杂度间做出权衡。
