Claude Code Agent Teams让一个团队为你工作

小伙伴们，大家好，我是小溪，见字如面。Claude Opus 4.6 发布时同步推出了 Agent Teams（多智能体团队）功能，让多个 Claude 实例像真正的开发团队一样并行协作。

当前使用版本

Claude Code CLI：2.1.39

优势

多个 Claude 实例并行工作，效率翻倍

限制

需要额外的tmux或者iTerm2终端工具辅助
多个 Claude 实例并行工作单tokens会翻倍

Agent Teams是什么?

Agent Teams是 Claude Code 的实验性功能（研究预览阶段），它允许您协调多个 Claude Code 会话组成团队，共同协作完成一个项目。其中一个会话充当团队领导，负责协调工作、分配任务并汇总结果。团队成员各自独立工作，在各自的上下文窗口中进行操作，并直接相互沟通。

用一句话理解就是: Agent Teams = 一个Lead（团队负责人）+ 多个Teammate（队友），各自独立工作又互相通信，共同完成复杂任务

之前了解过Subagents的小伙伴可能要有疑问了，那Agent Teams和Subagents是什么关系，又有什么区别？官方给出的解释是：Agent Teams和Subagents都支持并行处理任务，但它们的运行方式不同。选择哪种方案取决于你的工作人员是否需要相互沟通：

下面是AI绘制的Subagnet和Agent Team的协同工作的交互图，感觉还是挺形象的

Agent Teams核心架构

Agent Teams由4个核心部件构成：

队友消息会自动到达队首，系统会自动管理任务依赖关系，当一个 team-name 完成一个其他任务依赖的任务时，被阻塞的任务会在无需手动干预的情况下解锁。

Agent Teams的Teams和Tasks在执行过程中会存储在本地：

团队配置：~/.clade/teams/{team-name}/config.json，team config包含一个members数组，其中包含每个team-name的名称、agent ID 和 agent类型，队友可以通过读取这个文件来发现其他队友成员。
任务列表：~/.clade/tasks/{team-name}/，包含Agent角色提示词和任务描述

Agent Teams使用场景

Agent Teams会增加协调开销，并且比单个会话消耗更多的令牌。当团队成员能够独立操作时，Agent Teams的效果最佳。对于顺序任务、同一文件的编辑或涉及多个依赖项的工作，单个会话或子代理更为高效。

最有效的使用场景用例包括：

研究与评审：多位团队成员可以同时调查问题的不同方面，然后分享并相互质疑彼此的研究成果
新模块或功能：队友可以各自拥有独立的部件，互不干扰
使用竞争假设进行调试：团队成员并行测试不同的理论，更快地找到答案
跨层协调：涉及前端、后端和测试的变更，每个部分分别由不同的团队成员负责

开启Agent teams

代理团队功能目前处于实验阶段，默认情况下处于禁用状态，需要手动开启

目前Agent teams 还只是实验性功能，默认禁用的，想要使用需要手动开启，一次性使用可以直接在命令行终端中设置环境变量：

bash 复制代码

$ export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
$ claude

想持久化存储可以将其添加到 ~/.claude/settings.json

bash 复制代码

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

配置完成后重启Claude Code即可使用。

基本使用

创建Agent Teams

在Claude Code中使用Agent Team也很简单，直接使用自然语言描述需求即可，例如我们创建一个代码审查Team帮我们从不同维度审查项目代码，最终为我们输出审查报告，我们可以直接这么写：

bash 复制代码

创建一个agent team来审查项目代码，包含三个审查者：
- 一个专注于安全隐患
- 一个专注于性能分析
- 一个专注于验证测试覆盖率
各自审查后完成后汇总输出审查报告

可以看到Claude Code创建了3个审查Agent，并为每个队友分配了不同的角色职责

官方说使用快捷键【Shift+Up/Down】可以切换不同的队友，在最新版本好像不太好用

在Claude Code CLI最新版本中，输入框底部会展示包含Team Lead在内的所有Agent，使用【<- ->】按键可以切换不同的队友

使用【Enter】快捷键可以进入不同的Agent，可以对指定Agent发送指令

团队创建后，打开 ~/.claude 目录，可以看到Agent Team本地化存储创建的 tasks 和 teams 目录，这2个文件夹是Agent teams的关键。

teams/{code-review}/config.json：团队职责描述，所有的队员信息及工作流程
teams/{code-review}/inboxes ：所有队友的角色职责定义、消息通信记录
tasks/{code-review} ：共享任务列表

所有队友Agent任务执行完成后，会将结果同步到Team Lead Agent进行汇总，所有任务完成后，Claude Code会自动的解散团队并清理任务配置和通信队列

Agent Teams显示模式

Claude Code官方提供了2种展示模式：

Auto：如果在 tmux 会话内（使用Split panes模式），如果不在 tmux 内（使用In-process模式），默认auto模式
In-process：所有队友都在主终端内运行，使用通过交互式方式选择队友并直接输入消息给他们。可在任何终端中使用，无需额外设置。
Split panes：每个队友都有自己的面板，可以同时看到每个人的输出并点击一个面板直接交互。需要 tmux 或 iTerm2

上面我们使用的是默认模式，Claude Code根据环境判断使用了 In-process 模式，如果我们想使用Split panes分屏模式，我们需要单独下载tmux或者iTerm2。

我之前没有用过tmux，这里我就以tmux为例在macOS上进行配置。首先先安装tmux，在命令终端输入以下命令：

bash 复制代码

$ brew install tmux

安装完成后，使用 tmux -V 查看版本信息，输入以下信息就表示安装成功了

其他系统安装方式可以参考官方Wiki：github.com/tmux/tmux/w...

接着输入 tmux 进入tmux模式，这种状态就表示开启成功

也可以在Cluade Code配置中强制指定分屏显示

bash 复制代码

# 命令行指定
$ claude --teammate-mode tmux

# 或在 settings.json 中设置
{
  "teammateMode": "tmux"
}

然后输入 claude 启动Claude Code CLI，输入提示词等待Claude Code创建Agent Team，创建完成后我们就可以看到如下效果的界面。需要注意的是，分屏是claudecode自行创建的，不需要手动创建

正常情况下，每个分屏的Agent都是可以通过鼠标点击自由切换的，如果你发现你的分屏无法点击，可以继续往下看。

在tmux模式下，输入

bash 复制代码

$ nano ~/.tmux.conf

进入配置界面，输入如下指令

bash 复制代码

set -g mouse on
set -g base-index 1

使用快捷键【Ctrl+X】退出编辑状态，接着输入【Y】，然后回车退出编辑界面，最后执行命令使配置立即生效

bash 复制代码

$
source

重启Claude Code就完成了，这个时候就可以通过鼠标在分屏中自由切换了

总结

以往与AI协同开发最令人头大的莫过于上下文长度限制和上下文污染问题了，Agent Teams中采用的上下文分而治之，多Agent并行执行把这些难题好像变得不是难题了，真是不得不佩服。在合适的场景下，Agent Teams的这种团队模式的确是可以为我们大幅度提升研发效率的，但是我们也不能盲目追求效率，还是要看一下实际的，Agent Teams对Tokens的消耗是非常大的，一次对话相当于我们日常Vibe Coding的N倍还多，我两天跑了两个Demo，20刀到已经没了🤣，小伙伴们有实力的前提下可以忽略。

友情提示

见原文：Claude Code Agent Teams让一个团队为你工作

本文同步自微信公众号 "程序员小溪" ，这里只是同步，想看及时消息请移步我的公众号，不定时更新我的学习经验。友情提示友情提示