Claude Code Agent Teams 是一个实验功能：把多个 Claude Code 实例组织成团队。一个 session 作为 team lead，负责任务分配和结果综合；多个 teammates 独立工作，并可以直接互相通信。
Agent Teams 和 Subagents 有什么区别？
两者都能并行化，但心智模型不同。
Subagents：
- 主 session 派出 worker
- worker 只把结果汇报给主 Agent
- worker 之间不直接交流
- 成本较低，适合聚焦任务
Agent Teams：
- 每个 teammate 是完整 Claude Code session
- 有共享 task list
- teammates 可直接互相发消息
- 你也可以直接切到某个 teammate 交流
- 成本更高，但适合真正协作
简言之：需要“工人汇报”用 subagents；需要“团队讨论和协作”用 agent teams。
如何启用？
Agent Teams 默认关闭，需要设置环境变量：
json
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}要求 Claude Code v2.1.32 或更高版本：
bash
claude --version启动第一个团队
用自然语言告诉 Claude 创建团队：
text
I'm designing a CLI tool that helps developers track TODO comments across their codebase. Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.Claude 会创建 team、生成共享任务列表、spawn teammates，并让他们从不同角度探索。
适合哪些任务？
Agent Teams 最适合“并行探索有价值”的场景：
- 研究和审查：不同 teammate 分别调查，再互相挑战结论
- 新模块设计：每个 teammate 负责一个相对独立部分
- Debugging：不同 teammate 测试不同假设
- 跨层改动：frontend、backend、tests 分工推进
- 架构评审：一个实现方案，一个风险评估，一个反方
不适合：
- 顺序依赖很强的任务
- 多人同时改同一个文件
- 简单单文件修复
- 成本敏感的小任务
显示模式：in-process vs split panes
Agent Teams 支持两种显示模式：
In-process
所有 teammate 都在主终端内运行。用 Shift+Down 在 lead 和 teammates 之间切换。
优点：无需额外工具，任何终端都能用。
Split panes
每个 teammate 一个 pane，可以同时看到所有输出。需要 tmux 或 iTerm2。
可以在设置中指定：
json
{
"teammateMode": "in-process"
}也可以单次启动：
bash
claude --teammate-mode in-process模型选择和计划审批
Teammates 默认不一定继承 lead 当前 /model。你可以在 prompt 中明确指定：
text
Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.对于复杂或风险较高任务，建议要求 teammates 先 plan 再执行，由 lead 审批后再修改文件。
最佳实践
- 只在任务可并行拆分时使用
- 给每个 teammate 明确职责和边界
- 避免多人同时编辑同一文件
- 让一个 teammate 专门做反方审查
- 对高风险变更要求 plan approval
- 明确模型选择，控制成本
来源：Claude Code 官方文档 - Agent Teams | 整理：ClaudeEagle