从 Subagent 到 Team：Claude Code 把 AI 协同玩明白了

你有没有遇到过这种情况：

项目太大，一个 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 格式存储：

swift 复制代码

{
    "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，其他代理监控这些收件箱，实现消息传递。

消息格式示例：

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 中加入：

json 复制代码

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

或在启动时指定：

ini 复制代码

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude

常用命令

创建 Team 并指定模型：

复制代码

创建一个有 4 个队友的团队，并行重构这些模块。
每个队友都使用 Sonnet。

要求计划审批（适合复杂或有风险的任务）：

复制代码

生成一个架构师队友来重构认证模块。
在他们做任何更改之前需要计划批准。

队友会在只读计划模式下工作，直到领导批准。

清理团队：

复制代码

清理团队

每个队友都是完整的、独立的 Claude Code 会话。你可以直接向任何队友发送消息，提供额外指示、询问后续问题或调整方向。

进阶使用模式

模式一：计划与讨论

Team 模式的优势在于"共享任务"和"代理间通信"。与 Subagent 不同，队友启动后会保持空闲状态，直到主 Agent 明确关闭。

这让 Team 模式特别适合让 AI 讨论开放性问题。

推荐提示模式：

css 复制代码

使用 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 观点等。