Claude Agent Teams 实战指南：多代理协同开发的配置、使用与高级玩法

在今年2月，Anthropic公司推出了一个名为 Agent teams 的全新范式，引发了技术社区的新一轮热议和研究。这被看作是一个能让“一人团队”发挥出惊人效率的新工具。今天我们就来深入了解一下这个备受关注的特性。

Agent teams 是什么？

简单来说，Agent teams 功能允许你协调多个 Claude Code 实例进行协同工作。你可以创建一个会话作为 Team Lead（团队负责人），同时与其他多个 Teammate（队友）在不同的会话中（拥有独立的上下文窗口）开展可协作的独立任务。

所以，一个 Agent team 的构成就是：一位 Team Lead + 多位 Teammate。

关键在于，这些队友之间是独立且平级的。他们可以直接互相沟通和处理问题，无需事事都通过 Team Lead（即主代理）中转。

目前，Agent teams 仍是一个实验性功能，在 Claude Code 中默认是禁用的。要启用它，你需要在 settings.json 文件或通过环境变量添加配置：CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1。

与 Subagents 的核心区别

它与我们之前可能了解的 subagent 有根本上的不同。最核心的区别在于：subagent 只能在单一会话内运行，且每个子代理只能与主代理沟通，无法与其他子代理直接交流。

而 Agent teams 中，各位队友之间可以直接互相沟通，无需经过 Team Lead，是典型的平级协作模式，且各自的上下文窗口完全独立。

Claude 官方对此的推荐用法是：“当你需要快速、专注的工作人员报告结果时，使用 subagents。当队友需要分享发现、相互质疑和自我协调时，使用 agent teams。” 这很好地体现了两种模式各自适用的 人工智能 协作场景。

快速上手指南

首先，你需要开启这个实验特性。通常可以在配置文件中进行设置：

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

配置并激活后，你就可以向 Claude 描述你的团队任务了。这里使用一个官方的示例提示词：

我正在设计一个命令行工具（CLI），帮助开发者跟踪代码库中的待办事项注释。

组建一个团队从不同角度探讨这个问题：一名成员负责用户体验（UX），一名负责技术架构，还有一名担任质疑者角色。

运行后，你将看到 Claude 开始组建团队并启动讨论。

这个过程非常值得亲身体验，不过要注意：这相当消耗 tokens。

两种显示模式

目前，Agent teams 支持两种用户界面显示模式：

• In-process（进程内模式）：所有队友都在主终端窗口内运行，你可以使用 Shift+Up/Down 箭头键在不同队友的视图间切换和操作。
• Split panes（分屏模式）：每个队友都拥有自己独立的终端窗口，这需要配合 tmux 或 iTerm2 这类终端多路复用器使用。

默认显示模式是 auto。这意味着，如果 Claude Code 检测到当前处于 tmux 会话中，它会自动启用分屏模式。你通常会在屏幕底部看到类似下方的提示，方便你在不同的 tmux 面板间导航：

否则，它将使用 In-process 模式，即传统的单一终端界面。

你也可以手动为每个会话指定模式：使用 claude --teammate-mode in-process 或 claude --teammate-mode tmux 命令。

进阶玩法与高级功能

除了基础的团队协作，Agent teams 还内置了一些提升效率和管理能力的“高级”功能：

• 任务管理：团队共享一个中央任务列表。Team Lead 可以直接指派任务。队员完成当前工作后，可以自动认领下一个未被阻塞的任务（系统使用文件锁来防止任务冲突）。
• 计划审批：对于高风险任务，可以要求队员在执行写代码等具体操作前，先提交一个行动计划，待 Team Lead 批准后才能继续。
• 委托模式：此模式强制 Team Lead 只负责“协调”和“管理”，不能直接编写代码。这能有效防止 Team Lead“抢活干”，确保其专注于任务分发和结果汇总。
• Hooks（钩子）：支持在特定事件触发时执行脚本，例如 TeammateIdle（队员空闲时）和 TaskCompleted（任务完成时），可用于自动执行代码质量检查等操作。

目前存在的限制与问题

作为一个实验性功能，Agent teams 目前还存在一些已知的限制：

• 不支持会话恢复：目前 /resume 和 /rewind 命令无法恢复队员的状态，这是当前最大的使用限制。
• 单一团队限制：一个会话同一时间只能管理一个团队。
• 需要手动清理：工作结束后，需要让 Team Lead 执行 Clean up 来释放资源并关闭相关的 tmux 会话（如果使用了分屏模式）。
• 常见问题排查：
  • 如果看不到队员视图，尝试使用 Shift+Down 切换。
  • 分屏模式在 VS Code 集成终端或 Windows Terminal 中可能无法完美支持，建议在标准终端应用中使用。

总结

Agent teams 代表了当前 AIGC 开发范式中的一个新兴趋势，它特别适合处理那些复杂、需要“分头行动、并行处理”的中大型开发任务。

但由于其 Token 消耗较大，且目前不支持断点续传，对于简单的线性任务，继续使用单会话或 subagent 可能是更经济高效的选择。

在最佳实践上，Claude 官方文档 的建议包括：提供充足的上下文、合理规划任务规模、避免组长抢活干、从研究和审查类任务起步，并且需要确保持续的监控和引导。

总而言之，作为一个前沿的实验性特性，Agent teams 既充满了潜力，也存在不少待完善之处。对于开发者而言，最好的方式就是动手实践，边玩边探索，在具体的项目场景中感受其威力与边界。如果你想了解更多类似的 AI 与开发实战内容，欢迎来 云栈社区 交流探讨。