Claude Code agent teams 和 subagent 有什么区别：各自什么时候用，以及怎么搭一个团队

Agent teams 和 subagent 的区别

两者都在各自独立的上下文窗口里并行干活。区别在于谁来协调：用 subagent 时，主 agent 统管一切；在团队里，队友从共享列表里认领任务，并且互相沟通。

什么时候该用 agent teams（什么时候不该用）

• 调研和审查：队友从不同角度研究同一个问题，再互相质疑对方的结论。
• 新模块或新功能：每个队友负责独立的一块，比如前端、后端和测试。
• 带着几种互相竞争的假设排查 bug：几个队友各自设法证明自己的猜想，同时推翻别人的。
• 不适合按顺序进行的工作、要改同一批文件的工作，或依赖关系很多的任务：这些场景用单个会话或 subagent。
• 不适合日常琐事：每多一个活跃的队友，token 消耗就多一份。

怎么搭建一个 Claude Code agent team

1. 开启 agent teams

   在环境变量里，或 settings.json 的 env 块里，把 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 设为 1。团队只能在交互式会话里用；用 -p（以及 Agent SDK）时，Claude 不会派生队友。

   // settings.json: agent teams are experimental and off by default
   {
     "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" }
   }
   
   // Optional: give each teammate its own split pane (tmux or iTerm2)
   {
     "teammateMode": "auto"
   }

2. 用大白话描述团队

   说清楚要几个队友、每个负责什么。Claude 会建好共享任务列表、派生队友，并在它们做完后汇总结论。

   Spawn three teammates to review PR #142:
   - One focused on security implications
   - One checking performance impact
   - One validating test coverage
   Have them each review and report findings.

3. 选一种显示模式

   默认是进程内（in-process）模式，任何终端都能用：队友显示在提示符下方的面板里；用方向键和回车打开某个队友并给它发消息，按 Ctrl+T 查看任务列表。分屏模式让每个队友有自己的窗格，需要 tmux，或装了 it2 CLI 的 iTerm2；把 teammateMode 设为 auto 或 tmux，或者用 claude --teammate-mode auto 启动。

4. 复用已经定义好的角色

   让 Claude 派生一个“using the security-reviewer agent type”的队友，就能复用 .claude/agents/ 里的 subagent 定义，连同它的工具、模型和指令。

5. 随时引导，最后关闭

   随时查看队友进度、给它们改方向；如果负责人开始自己动手干队友的活，就对它说“wait for your teammates”。收尾时，让负责人按名字关闭某个队友；会话结束时，团队的目录会被清理掉。

来源：Claude Code 文档，Agent teams（英文）

最佳实践和限制

• 先从 3–5 个队友开始，每人大约 5–6 个任务；三个专注的队友往往比五个各干各的更有效。
• 给每个队友分配不同的文件：两个队友改同一个文件会互相覆盖。
• 把任务细节写进派生提示词：队友会加载 CLAUDE.md、MCP 服务器和 skills，但看不到负责人的对话。
• 用 hooks 做质量关卡：TeammateIdle、TaskCreated 和 TaskCompleted 可以用退出码 2 把工作打回去重做。
• 限制：每个会话只能有一个团队，不能嵌套团队，负责人不能更换，/resume 恢复不了进程内的队友，任务状态也可能滞后。
• 分屏模式在 VS Code 集成终端、Windows Terminal 和 Ghostty 里用不了；进程内模式在哪里都能用。
• 开启 agent teams 后，Claude 点名调用的 subagent 可能会作为队友启动；想要回原来的 subagent，就把这个变量设为 0。

Agent teams 和其他并行运行 Claude Code 的方式

Agent teams 是在一个会话里拆分你正盯着的一个任务。如果是彼此独立的任务，就在 git worktrees 里开多个会话，或者用后台 agent；完整对比见多个 Claude Code agent。想压低成本，看怎么减少 Claude Code 的 token 用量。

一支会话结束后还在干活的团队

agent team 只存在于一个会话里，会话一关就停。Crewmark 把 Claude Code、Codex、DeepSeek Harness 或 OpenCode 会话变成有固定岗位、目标和工作时间的 AI 员工：每个员工按心跳醒来，从共享看板上接下一个 issue，需要你拍板时给你发消息。

1. 给每个员工一个岗位

   软件工程师、代码审查员、SEO 专员：就是你会派生成队友的那些角色，只不过一直留着。

2. 大家在同一块看板上干活

   issue 取代了会话里的任务列表，而且重启之后、过了几天几周都还在。

3. 让心跳来启动工作

   工作时间内每 15、30 或 60 分钟一次；了解什么是 AI 员工。

Claude Code agent teams 常见问题