你有没有遇到过这种情况：
- 项目太大，一个 AI 顾此失彼
- 想同时做代码审查、写测试、写文档，但 AI 一件件来，效率低
- 调试时不确定原因，想从多个角度同时排查
Claude Code 最新推出的 Team 模式，就是为解决这个问题。
简单说：把"一个全能选手"变成"一个项目经理 + 多个专业工程师"。
Agent 编排的演进
AI Agent 编排的概念并非全新。早在 2025 年 6 月，就有工程师尝试通过 Tmux 启动多个 Claude Code 实例，实现"并行组织化"，一度成为热门话题。
但由于环境配置复杂、AI 模型能力有限，这个方向一直没能真正普及。
如今，Claude Code 在 2.1.32 版本正式发布了 Agent Teams 功能，加上过去半年 AI 模型能力的显著提升，Agent 编排再次成为焦点。
Team 模式是什么
Team 模式让多个 Claude Code 实例协同工作，就像一个真正的开发团队：
| 角色 | 职责 |
|---|---|
| Team Lead（班长） | 主 Claude 会话，负责创建团队、分配任务、协调工作 |
| Teammates（队友） | 独立的 Claude 实例，各自处理分配的任务 |
| Task List（任务列表） | 共享的工作项，队友可以认领和完成 |
| Mailbox（信箱） | Agent 之间的消息通信系统 |
Team 和任务存储的路径：
- Team config:
~/.claude/teams/{team-name}/config.json - Task list:
~/.claude/tasks/{team-name}/
Team 模式 vs 普通模式
| 普通模式 | Team 模式 | |
|---|---|---|
| 工作方式 | 你 → Claude → 干完所有活 | 你 → 班长 → 分派队友 → 协作 → 汇总 |
| 上下文 | 单一上下文窗口 | 每个队友独立上下文 |
| 适合场景 | 简单任务、顺序任务 | 复杂任务、并行任务 |
Team 模式 vs Subagent
很多人会问：这和 Subagent 有什么区别？
| Subagent | Team 模式 | |
|---|---|---|
| 沟通方式 | 只能向主 Agent 汇报 | 队友之间可以直接沟通 |
| 协调方式 | 主 Agent 管理一切 | 共享任务列表，自我协调 |
| 生命周期 | 任务完成即结束 | 队友保持空闲状态，直到被关闭 |
| 信息可见性 | 主 Agent 只能看到最终结果 | 主 Agent 和队友可随时交换信息 |
| 适合场景 | 只关心结果的聚焦任务 | 需要讨论协作的复杂任务 |
| Token 成本 | 较低 | 较高 |
一句话概括：Subagent 是"干完活汇报"，Team 是"队友互相讨论协作"。
Team 模式的核心机制
1. 共享任务列表
2026 年 1 月，Claude Code 对任务系统进行了改版，支持任务分解和依赖管理。通过 CLAUDE_CODE_TASK_LIST_ID，可以在多个实例间共享同一份任务列表。
任务以 JSON 格式存储：
{
"id": "1",
"subject": "实现登录处理器，包含 JWT Token 生成",
"description": "**What**: ...\n**Where**: ...\n**How**: ...\n**Why**: ...\n**Verify**: ...",
"activeForm": "正在实现登录处理器",
"status": "pending",
"blocks": ["3"],
"blockedBy": []
}
任务系统提供四个核心工具，你可以通过 PreToolUse Hooks 进行进一步控制：
| 工具 | 功能 |
|---|---|
| TaskCreate | 创建新任务 |
| TaskGet | 获取任务详情 |
| TaskList | 列出所有任务及状态 |
| TaskUpdate | 更新任务状态、依赖或删除任务 |
2. 代理间通信
Agent Teams 支持代理之间的双向通信。
底层实现：当代理调用 sendMessage 时，消息会记录到 ~/.claude/teams/{team-name}/inboxes/{name}.json，其他代理监控这些收件箱，实现消息传递。
消息格式示例：
[
{
"from": "team-lead",
"text": "任务 1.4（认证集成）已完成。摘要：...",
"summary": "任务 1.4 认证集成完成，已提交",
"timestamp": "2026-02-14T06:37:35.599Z",
"read": true
}
]
这种机制让主 Agent 和队友即使在任务执行过程中也能交换消息，特别适合讨论型任务。
什么场景适合用 Team 模式
适合的场景
| 场景 | 说明 |
|---|---|
| 并行代码审查 | 安全、性能、测试各派一个队友 |
| 竞争假设调试 | 多个队友各自调查不同假设，互相挑战 |
| 跨层开发 | 前端、后端、测试各一个队友 |
| 新模块拆分 | 不同队友负责不同文件/功能 |
| 多轮讨论 | 让 AI 从不同角度反复讨论开放性问题 |
不适合的场景
- 简单任务（开销太大，杀鸡用牛刀）
- 同一文件的多处编辑（会冲突）
- 强顺序依赖的任务（用普通模式更高效）
如何启用 Team 模式
配置方式
在 ~/.claude/settings.json 中加入：
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
或在启动时指定：
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude
常用命令
创建 Team 并指定模型：
创建一个有 4 个队友的团队，并行重构这些模块。
每个队友都使用 Sonnet。
要求计划审批（适合复杂或有风险的任务）：
生成一个架构师队友来重构认证模块。
在他们做任何更改之前需要计划批准。
队友会在只读计划模式下工作，直到领导批准。
清理团队：
清理团队
每个队友都是完整的、独立的 Claude Code 会话。你可以直接向任何队友发送消息，提供额外指示、询问后续问题或调整方向。
进阶使用模式
模式一：计划与讨论
Team 模式的优势在于"共享任务"和"代理间通信"。与 Subagent 不同，队友启动后会保持空闲状态，直到主 Agent 明确关闭。
这让 Team 模式特别适合让 AI 讨论开放性问题。
推荐提示模式：
使用 Agent Teams，安排 N 名队友进行 3 轮讨论 [主题]。
每轮让队友之间相互沟通。
包含一名专注于红队视角提供批判性反馈的队友。
三个有效要素：
- 多轮讨论
- 轮内队友讨论
- 红队挑战
这些在 Subagent 中很难实现。
模式二：任务执行
得益于任务系统的依赖管理，Team 模式可以比 Subagent 更好地处理顺序和并行执行。
关键建议：在规划阶段仔细定义任务粒度和依赖关系。 一旦有了清晰的任务列表，只需指示 Claude Code 合理分配任务给队友，它通常能忠实执行。
实战演示：六顶思考帽
纸上得来终觉浅，绝知此事须躬行。
我们以六顶思考帽为例，演示 Team 模式的使用。
为什么选六顶思考帽？ 因为它完美展示了 Team 模式的核心价值：多个角色从不同角度思考，互相补充，最终形成完整结论。
步骤 1：创建 Team
创建一个 6 顶思考帽 team，6个团队成员
步骤 2：分配任务
以"OpenClaw 作者加入 OpenAI"事件为例，让六个思考帽分别从不同角度分析。
主智能体给六个成员发指令任务，等待他们回答。
步骤 3：汇总结果
主智能体等待所有成员回答完毕后，进行整理并输出最终答案。
步骤 4：定向提问
可以指定让部分成员回答问题。比如仅让红帽和绿帽讨论"都 2026 年了，有些人还认为 AI 无用"。
注意事项
① Token 消耗大。每个队友都是独立的 Claude 实例，成本会叠加。复杂项目值得，简单任务没必要。
② 避免文件冲突。两个队友编辑同一文件会互相覆盖。安排任务时要确保文件归属清晰。
③ 任务粒度要合适
- 太小：协调开销大于收益
- 太大：队友跑太久容易偏离方向
- 合适：能产出明确交付物的独立单元
④ 定期检查。别让团队跑太久不管。定期看看进度，必要时调整方向。
⑤ 用量限制。使用过多会很快达到使用上限，需合理规划。
总结
Team 模式的本质，是把 AI 从"单兵作战"升级为"团队协作"。
适合：
- 任务复杂，需要多角度并行处理
- 工作可以拆分成独立单元
- 队友之间需要沟通协调
不适合：
- 简单任务
- 强依赖顺序的工作
- 同文件多处编辑
如果你经常面对复杂任务，Team 模式值得一试。它让 Claude Code 不再是"一个助手"，而是"一个团队"。
今年，不仅是 Claude Code，其他工具也很可能会推出多 Agent 编排功能。建议至少尝试一次，感受 AI 团队协作的力量。
你用过 Claude Code 的 Team 模式吗？欢迎留言分享你的使用心得。
参考资料：
欢迎关注我的公众号：悟鸣AI，后续会陆续分享比较有用的 AI 工具和比较好的 AI 经验，比较客观理性的 AI 观点等。
