深度研究：Claude Code Agent Teams
来源: https://code.claude.com/docs/zh-CN/agent-teams
日期: 2026-02-22
一句话总结
Claude Code 新增实验性功能：多个 Claude Code 实例组成团队协作，有共享任务列表、代理间消息传递和集中管理。
核心概念
架构
| 组件 | 角色 |
|---|---|
| Team Lead | 主会话，创建团队、分配任务、综合结果 |
| Teammates | 独立 Claude Code 实例，各自处理任务 |
| Task List | 共享工作项列表，支持依赖关系 |
| Mailbox | 代理间消息系统 |
关键区别于 Subagents：
- Subagents 只能向主代理报告，像"干活的工人"
- Agent Teams 的队友可以直接互相通信、质疑对方发现、自我协调，像"协作团队"
| 维度 | Subagents | Agent Teams |
|---|---|---|
| Context | 结果返回调用者 | 完全独立 |
| 通信 | 仅报告结果 | 队友直接对话 |
| Token 成本 | 较低 | 较高（每人一个完整实例） |
| 适合 | 专注任务 | 需要讨论和协作的复杂工作 |
最佳用例
1. 研究和审查 — 多人同时调查不同方面，分享和质疑发现
2. 新模块/功能 — 各自拥有独立部分，互不干扰
3. 竞争假设调试 — 并行测试不同理论，甚至互相反驳
4. 跨层协调 — 前端/后端/测试各一个队友
工作流程
启动
I'm designing a CLI tool for TODO tracking. Create an agent team:
one on UX, one on architecture, one playing devil's advocate.
Claude 自动创建团队、生成队友、分配任务。
显示模式
- In-process：所有队友在主终端内，Shift+Up/Down 切换
- Split panes：每人一个窗格（需 tmux 或 iTerm2）
关键操作
- 计划批准：可要求队友实施前先提交计划审批
- 委派模式：Shift+Tab 切换，限制 Lead 只做协调不写代码
- 直接对话：随时向任何队友发消息
- 任务认领：队友完成当前任务后自动认领下一个
高级示例：竞争假设调试
Users report the app exits after one message.
Spawn 5 teammates to investigate different hypotheses.
Have them talk to each other to disprove each other's theories,
like a scientific debate.
每人独立调查 + 互相反驳 = 幸存的理论更可能是真正根因。
实用建议
- 任务粒度：每个队友 5-6 个任务最佳，太小浪费协调，太大风险高
- 避免文件冲突：不要让两个队友编辑同一文件
- 给足 context：队友不继承 Lead 的对话历史，spawn prompt 里要写清楚
- 定期检查：别让团队无人值守太久
- 从研究入手：新手先用审查/研究任务练手，再尝试并行实现
当前限制（实验性）
- ⚠️ 默认禁用，需设置
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 - In-process 队友无法 session resume
- 任务状态可能滞后
- 每个会话只能一个团队
- 不支持嵌套团队
- 关闭可能很慢
- Split panes 在 VS Code 终端/Windows Terminal 不支持
🔍 对我们的启发
与 OpenClaw 的对比
OpenClaw 的 sessions_spawn + subagents 已经实现了类似的多代理协作：
| 维度 | Claude Code Agent Teams | OpenClaw |
|---|---|---|
| 通信 | Mailbox + 直接消息 | sessions_send + subagents steer |
| 任务管理 | 共享 Task List + 自动认领 | 手动管理 |
| 显示 | in-process / tmux split | Discord/Telegram 消息 |
| 计划批准 | 内置 plan approval | 无内置机制 |
| 独立性 | 同一机器 CLI | 可跨机器 |
可借鉴的模式
1. 竞争假设调试 — 有趣的思路，可以用 sessions_spawn 启动多个子代理各自调查不同假设
2. 计划批准流程 — 子代理先出计划，主代理审批后再执行
3. 委派模式 — Lead 只协调不动手，避免越俎代庖
实际价值判断
- Token 成本高：每个队友是完整 Claude 实例，研究/审查场景值得，日常任务不划算
- 最大价值：需要多角度分析的复杂问题（安全审计、架构评审、竞争假设）
- 不适合：顺序任务、同文件编辑、有大量依赖的工作
总结：Agent Teams 是 Claude Code 从"单人工具"向"团队协作平台"演进的一步。核心创新是代理间直接通信和竞争性协作（互相质疑），而非简单的并行执行。实验性质意味着现在更适合探索，生产环境还需观望。