---
title: "从单兵作战到团队协作：Claude Code Agent Team 深度解析"
author: deletexiumu
pubDatetime: 2026-02-15T15:00:00+08:00
featured: false
draft: false
tags:
  - Claude Code
  - AI Agent

  - AI 编程
description: "Claude Code 推出 Agent Team 功能，让多个 AI Agent 像真实团队一样协作。本文深入对比 Subagent 与 Agent Team 的架构差异、适用场景与实战体验。"
---

你有没有遇到过这样的场景：让 AI 帮你重构一个模块，它埋头苦干半天，结果改完后端忘了前端，改完代码忘了测试？

或者你想让 AI 同时从安全性、性能、测试覆盖率三个角度审查一个 PR，但它只能一个一个来，审完第三个的时候已经忘了第一个的发现？

这就是**单 Agent 模式的天花板**——一个 AI 再强，也只有一个脑子、一个上下文窗口。

Claude Code 的 **Agent Team** 功能，正是为了打破这个天花板。

## 先回顾：Subagent 做对了什么

在 Agent Team 之前，Claude Code 已经有了 **Subagent**（子代理）机制。主 Agent 可以派生出若干个 Subagent，各自在独立的上下文窗口中工作，完成后把结果汇报回来。

这个模式解决了两个核心问题：

1. **上下文隔离**：跑测试、查文档这类产生大量输出的操作，不再污染主对话的上下文窗口
2. **并行探索**：多个 Subagent 可以同时研究不同的模块，主 Agent 最后汇总

但 Subagent 有一个根本性的限制——**它们只能向上汇报，彼此之间无法通信**。

打个比方：Subagent 模式就像一个老板分别给三个员工安排任务，每个人做完后单独向老板汇报。员工 A 发现了一个关键信息，但无法直接告诉员工 B，必须先报给老板，再由老板转达。

这在很多场景下是够用的。但当任务需要**讨论、争论、互相挑战**时，这种"中心化汇报"模式就捉襟见肘了。

## Agent Team：AI 的真·团队协作

2026 年初，Claude Code 推出了 Agent Team（实验性功能）。与 Subagent 的"老板-员工"模式不同，Agent Team 更像一个真正的项目团队：

- 有一个 **Team Lead**（团队负责人），负责组建团队、拆分任务、协调工作
- 有多个 **Teammate**（队友），每个都是独立的 Claude Code 会话
- 有一个 **共享任务列表**，所有成员可见，支持认领和依赖管理
- 队友之间可以**直接通信**，不需要经过 Lead 中转

![Subagent 与 Agent Team 架构对比](/blog/claude-code-agent-team/subagent-vs-agent-team-zh.png)

上图清晰地展示了两者的架构差异：

- **左侧 Subagent**：Main Agent 派生三个 Subagent，各自工作后把 Result 汇报回来，Subagent 之间没有连线
- **右侧 Agent Team**：Team Lead 创建共享任务列表，三个 Teammate 不仅各自工作，还能互相通信（Communicate 箭头）

这个架构差异带来的不只是通信能力的提升，而是**协作模式的根本改变**。

## 核心对比：Subagent vs Agent Team

|  | Subagent | Agent Team |
|---|---|---|
| **上下文** | 独立窗口，结果返回给主 Agent | 独立窗口，完全自治 |
| **通信方式** | 只能向主 Agent 汇报 | 队友之间可直接通信 |
| **任务协调** | 主 Agent 统一管理 | 共享任务列表，自主认领 |
| **最佳场景** | 专注型任务，只需返回结果 | 需要讨论和协作的复杂任务 |
| **Token 消耗** | 较低：结果摘要返回 | 较高：每个队友独立会话 |
| **嵌套能力** | 不能嵌套（Subagent 不能再派生 Subagent） | 不能嵌套（Teammate 不能再建团队） |

**一句话总结**：需要快速的"干活-汇报"用 Subagent，需要"讨论-协作-共识"用 Agent Team。

## 实战体验

### 如何开启

Agent Team 目前是实验性功能，需要手动开启。在 `settings.json` 中添加：

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

### 组建你的第一个团队

开启后，直接用自然语言描述你的需求和团队结构即可。比如：

```
帮我组建一个 Agent Team 来重构认证模块：
- 一个负责后端 API 重构
- 一个负责前端适配
- 一个负责写测试
```

Claude 会自动创建团队、拆分任务、派生队友，然后协调整个工作流程。

### 显示模式

Agent Team 支持两种显示模式：

- **In-process 模式**（默认）：所有队友在主终端内运行，用 `Shift+Up/Down` 切换查看不同队友的工作
- **Split pane 模式**：每个队友一个独立面板，可以同时看到所有人的输出。需要 tmux 或 iTerm2

![Agent Team 实际运行效果](/blog/claude-code-agent-team/agent-team-demo.png)

上图是一个实际的 Agent Team 运行场景。可以看到左侧是 Team Lead 的视角，右侧展开了多个 Teammate 的独立会话窗口。每个 Teammate 都在各自的上下文中独立工作，同时通过消息机制保持协调。

### 关键交互

- **直接对话队友**：`Shift+Up/Down` 选中队友，直接输入消息
- **查看任务列表**：按 `Ctrl+T` 切换任务面板
- **委派模式**：按 `Shift+Tab` 切换到 delegate 模式，Lead 只负责协调不亲自干活
- **审批计划**：可以要求队友在动手前先提交计划，Lead 审批后才能执行

## Agent Team 最适合的场景

Agent Team 最能发挥价值的两个场景是**系统重构**和 **MVP 搭建**。

### 1. 系统重构

系统重构是 Agent Team 的天然主场。重构一个模块，往往涉及后端 API 改造、前端适配、数据库迁移、测试更新等多个维度。单个 Agent 很难同时兼顾这些层面，容易改了 A 忘了 B。

用 Agent Team，你可以让不同的 Teammate 分别负责不同层：一个改后端、一个适配前端、一个补测试。他们通过共享任务列表管理依赖——后端 API 改完后，前端 Teammate 自动认领适配任务。更关键的是，他们能直接沟通："我把这个接口的返回格式改了，你那边需要同步调整。"

### 2. MVP 搭建

从零搭建一个 MVP 产品，需要同时推进多条线：技术选型、UI 框架搭建、核心业务逻辑、API 设计、数据库设计……一个 Agent 单线程做这些事，既慢又容易丢失上下文。

Agent Team 可以让多个 Teammate 并行推进，每人专注一个模块，同时通过消息机制保持架构层面的一致性：

```
帮我搭建一个任务管理系统的 MVP：
- 一个负责数据库设计和后端 API
- 一个负责前端 UI 和交互
- 一个负责认证和权限模块
```

三路并进，效率远超单 Agent 串行。

### 3. 多角度代码审查

```
组建一个 Agent Team 审查 PR #142：
- 一个专注安全审查
- 一个检查性能影响
- 一个验证测试覆盖率
让他们各自审查后汇报发现。
```

单人审查容易陷入某一类问题，多人并行审查能确保安全、性能、测试三个维度都被充分关注。

### 4. 竞争性假设调试

```
用户反馈应用只处理一条消息就断开了。
创建 5 个队友分别调查不同的假设。
让他们互相讨论、试图推翻对方的理论，
像科学辩论一样，最后把达成的共识写入文档。
```

这是 Agent Team 最独特的用法——**让 AI 互相挑战**。单个 Agent 调试容易"锚定"在第一个看似合理的解释上，而多个 Agent 互相质疑，最后存活下来的理论更可能是真正的根因。

### 5. 并行研究

多个 Teammate 同时调研问题的不同方面，各自分享发现并互相补充，最后由 Lead 汇总出完整的分析报告。

## 注意事项

Agent Team 功能强大，但也有一些需要注意的地方：

1. **Token 消耗更高**：每个 Teammate 都是独立的 Claude 会话，Token 用量随队友数量线性增长。日常小任务用 Subagent 更经济
2. **避免文件冲突**：两个 Teammate 同时编辑同一个文件会导致覆盖。拆分任务时确保每人负责不同的文件
3. **任务粒度要适中**：太小则协调开销大于收益，太大则队友长时间不汇报容易跑偏。每个 Teammate 分配 5-6 个任务是比较好的节奏
4. **目前不支持会话恢复**：`/resume` 无法恢复 In-process 模式的队友，如果会话中断需要重新派生
5. **一次只能一个团队**：需要先清理当前团队才能创建新团队

## 写在最后

从 Subagent 到 Agent Team，Claude Code 的演进路径很清晰：

- **Subagent** 解决了"一个人干不完"的问题——并行分工
- **Agent Team** 解决了"分工后需要协作"的问题——沟通与共识

这不只是 Claude Code 的一个新功能，更是 AI 编程工具的一个重要方向信号：**未来的 AI 编程助手，不是一个更强的个体，而是一个能自组织的团队。**

如果你已经在用 Claude Code，强烈建议打开 Agent Team 的实验开关试试。从一个简单的多角度代码审查开始，你会对 AI 协作的能力有全新的认识。

> **备注**：Agent Team 并非 Claude 官方模型的专属功能。目前国内模型 **Kimi K2.5**、**GLM-5**、**MiniMax-2.5** 都已支持在 Claude Code 中使用 Agent Team，意味着你无需翻墙、无需海外 API Key，也能体验多 Agent 团队协作的能力。

---

> **参考资料**
> - [Claude Code 官方文档 - Agent Teams](https://code.claude.com/docs/en/agent-teams)
> - [Claude Code 官方文档 - Subagents](https://code.claude.com/docs/en/sub-agents)
> - [Addy Osmani - Claude Code Swarms](https://addyosmani.com/blog/claude-code-agent-teams/)

---

## 相关阅读

- [别让 AI 乱写代码：从方法论到实战，我的 Claude Code 工作流](/posts/claude-code-plan-before-code/) — Agent Team 要跑得好，离不开清晰的任务拆解方法论
- [同样的话跟 Claude Code 说了八遍，是时候让它自己记住了](/posts/claude-code-memory-rules/) — 给每个 Agent 配好规则文件，协作更顺滑
- [从需求到自动化：Claude Code Skill 工具链完整实战](/posts/claude-code-skill-toolchain/) — Skill Creator 背后的多 Agent 协作机制在实战中的应用