Claude Code 智能体团队（agent teams）怎么开、怎么用：实验功能，和子智能体的区别、费用与限制

本文根据 Claude Code 官方文档《Orchestrate teams of Claude Code sessions》《Manage costs effectively》整理，资料核对于 2026-11-05。配图为本站整理的示意图，不是界面截图。本站（bigolab.com）不是 Anthropic 官方网站。

适用于谁

• 搜「claude code 智能体团队」「claude code 团队模式」的人；
• 用过子智能体（subagents），想知道多个 Claude 实例互相协作是怎么回事的人；
• 担心多开会烧掉大量额度的人。

结论先说

1. 智能体团队是实验功能，默认关闭。 官方要求设置环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1（放在环境里或 settings.json 的 env）。不设的话，不会建团队，Claude 也不会生成或建议队友。
2. 结构：一个会话当组长（team lead），协调、分配任务、汇总结果；队友（teammates）各自有独立的上下文窗口，彼此可以直接发消息，你也可以直接和任何队友说话。
3. 和子智能体不同：子智能体在单个会话内工作，把结果交还调用方；团队成员共享任务列表、能互相通信。
4. 很费 token：官方说它增加协调开销，用的 token 明显多于单个会话；顺序性任务、改同一个文件、依赖很多的工作，用单会话或子智能体更合适。
5. 非交互模式不生成队友：用 -p 参数（包括 Agent SDK 会话）时，Claude 不会生成队友。

图：本站根据 Claude Code 官方文档：Agent teams 整理的示意图

一、什么时候值得用

官方列出的强场景：

• 研究与评审：多个队友同时调查问题的不同方面，再互相分享和质疑；
• 新模块或新功能：每人负责一块，互不踩脚；
• 多假设排错：队友并行验证不同的猜测；
• 跨层协调：前端、后端、测试各由一个队友负责。

官方的原话大意是：开团队前先想想有没有更轻的办法。子智能体只在单个会话内工作，详见 /guides/claude-code-subagents；官方另有「跨会话消息」功能，让你自己开的多个会话互相传递结果。

二、怎么开启

在 settings.json 里写：

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

配置文件的位置和优先级见 /guides/claude-code-settings-json。官方特别提醒一件事：开启之后普通委派也会变化，Claude 自己给子智能体起名时，被命名的子智能体会以队友的身份启动，所以你没要求时也可能形成团队。

三、启动第一个团队

图：本站根据 Claude Code 官方文档：Agent teams 整理的示意图

开启后，用自然语言描述任务和你要的队友。官方示例（翻译大意）：

text
我在设计一个帮开发者追踪代码库里 TODO 注释的命令行工具。
请生成三个队友，从不同角度探索：一个管用户体验，一个管技术架构，一个扮演唱反调的人。

Claude 会建立共享任务列表、生成队友、让他们各自探索，最后汇总。官方也提醒：Claude 有时会用子智能体而不是建团队，两者都显示在同一个面板里，所以光看面板不能确认团队是否形成；如果它用了子智能体，再说一次并明确要求「agent team」。

组长终端的输入框下面有智能体面板：上下箭头选队友，Enter 打开其记录并直接发消息，Esc 清除选择；在查看某个队友时按 Esc 会打断它当前这一轮。

指定数量和模型也可以直接写在提示里，例如官方示例的意思是：生成 4 个队友并行重构这些模块，每个用 Sonnet。官方给出模型选择的优先级：提示词里指定的模型、子智能体定义里的 model、环境变量 CLAUDE_CODE_SUBAGENT_MODEL、组长当前使用的模型。模型选择的一般知识见 /guides/claude-code-switch-model。

四、显示模式

官方有两种：

• in-process（默认）：所有队友都在主终端里，不需要额外设置，任何终端都能用；
• 分屏（split panes）：每个队友一个窗格，需要 tmux 或 iTerm2。

用 settings.json 的 teammateMode 切换，取值有 "in-process"、"auto"、"tmux"、"iterm2"；单次会话可以用 claude --teammate-mode auto。官方提醒 tmux 在某些操作系统上有已知限制，通常在 macOS 上最好用。

五、权限

• 队友启动时沿用组长的权限模式，不能在生成时单独设置；包括组长开着 bypassPermissions（即 --dangerously-skip-permissions）时，队友也是；
• 队友的权限提示会出现在组长会话里，需要你在那里批准；
• 官方还强调：队友之间发的消息会被标明来自另一个 Claude 会话，不是你，队友不能替你批准权限请求；
• 想让队友先出方案再动手：先让组长进入计划模式再要求生成队友，官方说队友会一直处在计划模式直到方案就绪。计划模式见 /guides/claude-code-plan-mode，权限模式详解见 /guides/claude-code-permission-modes。

六、费用怎么控制

官方在费用页给出的建议：

• 队友用 Sonnet，在能力和成本之间平衡；
• 团队保持小规模，token 用量大致随成员数增长；官方在最佳实践里说大多数工作流从 3–5 个队友开始；
• 生成提示保持聚焦，因为提示里的所有内容从一开始就进入队友的上下文；
• 工作完成就让队友关闭，活跃的队友会一直消耗 token；
• 关闭队友：直接对组长说「让 researcher 队友关闭」，队友可以同意退出，也可以拒绝并说明原因。

订阅用户要关注额度，Claude Code 的额度与限额说明见 /guides/claude-usage-limits；需要更大额度可以了解 /chongzhi/claude-code 或 /chongzhi/claude-max。

七、官方列出的限制

• /resume、/rewind 不会恢复 in-process 队友，恢复后组长可能给已不存在的队友发消息，这时让组长重新生成；
• 任务状态可能滞后：队友有时不把任务标记完成，导致后续任务被阻塞；
• 关闭可能很慢：队友会先做完当前请求或工具调用；
• 一个会话只有一个团队，不能创建多个命名团队，也不能跨会话共享；
• 不能嵌套：队友不能再生成自己的队友，只有组长能管理团队；
• in-process 队友的子智能体只能在前台运行。

官方还提供了钩子来设质量关卡：TeammateIdle、TaskCreated、TaskCompleted，用退出码 2 可以给反馈并让队友继续工作或阻止创建 / 完成任务。钩子的基本用法见 /guides/claude-code-hooks。

常见问题

Q：我没设环境变量，为什么说「生成三个队友」没反应？

官方说不设置变量时 Claude 不会生成队友。先确认开关，并在交互模式下使用。

Q：两个队友会不会改同一个文件？

官方的「避免文件冲突」一节说：两个队友编辑同一个文件会导致覆盖，所以要把工作拆开，让每个队友负责不同的文件集合。分支隔离的做法见 /guides/claude-code-worktree（那是另一个功能，官方这页没有把它和团队绑在一起说）。

Q：是所有套餐都能用吗？

官方这页没有写套餐限制；功能是否可用请以官方 feature availability 页面为准。

相关教程

• /guides/claude-code-subagents：子智能体
• /guides/claude-code-plan-mode：计划模式
• /guides/claude-code-hooks：钩子

参考资料

• Claude Code 官方文档：Orchestrate teams of Claude Code sessions — https://code.claude.com/docs/en/agent-teams
• Claude Code 官方文档：Manage costs effectively — https://code.claude.com/docs/en/costs