一个 Claude 不够？让多个 Claude Code 实例组成团队，分工协作。Agent Teams 是 Claude Code 的实验性功能，允许多个 Claude 实例共同工作——一个当队长协调任务，其他队友独立执行，还能互相交流。
什么是 Agent Teams？
传统的 Claude Code 子 Agent（Subagent）只能向主 Agent 汇报结果。Agent Teams 则不同：
| 特性 | Subagents | Agent Teams |
|---|---|---|
| 上下文 | 自己的窗口，结果返回调用者 | 自己的窗口，完全独立 |
| 通信 | 只能向主 Agent 汇报 | 队友之间直接通信 |
| 协调 | 主 Agent 管理所有工作 | 共享任务列表，自我协调 |
| 适用 | 只需要结果的聚焦任务 | 需要讨论和协作的复杂工作 |
| Token 消耗 | 较低 | 较高（每个队友独立实例） |
启用方法
在 settings.json 中添加：
json
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}需要 Claude Code v2.1.32+。
快速开始
只需要用自然语言描述你的团队：
text
我正在设计一个追踪 TODO 注释的 CLI 工具。
创建一个 Agent 团队从不同角度探索：
一个专注 UX，一个负责技术架构，一个扮演魔鬼代言人。Claude 会自动创建团队、分配角色、协调工作。
最佳使用场景
1. 研究和评审
多个队友同时调查问题的不同方面，然后分享和挑战彼此的发现。
2. 新功能开发
每个队友负责一个独立模块，互不干扰。
3. 竞争性假说调试
队友并行测试不同理论，更快收敛到答案。
4. 跨层协调
前端、后端、测试各由一个队友负责。
显示模式
In-process 模式
所有队友在主终端中运行：
Shift+Down：循环切换队友Enter：查看队友会话Escape：中断队友当前操作Ctrl+T：切换任务列表
Split Pane 模式
每个队友独立窗格，需要 tmux 或 iTerm2：
json
// ~/.claude.json
{
"teammateMode": "tmux"
}或单次会话：
bash
claude --teammate-mode in-process高级功能
指定队友和模型
text
创建一个 4 人团队来并行重构这些模块。
每个队友使用 Sonnet 模型。要求计划审批
text
派一个架构师队友重构认证模块。
在做任何修改前要求计划审批。队友完成计划后提交给队长审批。队长可以批准或退回并附带反馈。
直接与队友对话
每个队友是完整的 Claude Code 会话，你可以随时给任何队友发消息、提问或调整方向。
什么时候不该用？
- 顺序依赖任务：一步依赖上一步的结果
- 同文件编辑：多个队友编辑同一文件会冲突
- 简单任务：Token 开销不值得
这些场景用单会话或 Subagent 更合适。
注意事项
- 实验性功能，默认禁用
- Token 消耗显著高于单会话
- 会话恢复、任务协调和关闭行为有已知限制
- 建议从小团队（2-3人）开始尝试
原文来源：Claude Code Agent Teams 文档 | 来源：Claude Code 官方文档