Claude Code Agent Teams 实战指南：我的第一个AI开发团队是怎么组起来的

小星AI
4 阅读1分钟

一句话说清楚 Claude Code Agent Teams

去年8月我第一次用 Claude Code 的时候，还觉得它就是个带权限控制的终端助手，写写单文件、修修 bug 挺好。结果今年 Anthropic 扔出一个新功能——Agent Teams，直接把天花板捅穿了。

简单说，你可以在 Claude Code 里组一个 AI 开发团队。不是一个 agent 干活，是多个 agent 同时干活，而且它们之间能直接聊天。

上周四我试着搭了一个 4 人团队做 REST API 模块，真实体验是：第一回震撼，第二回上瘾，第三回开始算 token 账单了。

这篇东西不整虚的，纯实战记录，从开启功能到第一次跑通，连带踩坑一起写。

先解决一个问题：Subagent 和 Agent Teams 到底差在哪

很多人（包括我一开始）搞混这两个概念。我先说结论：

Subagent 是你派出去的快递员，Agent Teams 是一起开会的项目组。

Subagent 模式下，主 agent 把任务拆开，让子 agent 各自干，干完回来汇报。但子 agent 之间不说话。就像你雇了三个程序员分别写前端、后端、数据库，但谁也不知道隔壁在干嘛。

Agent Teams 不一样。每个团队成员有自己的对话窗口，可以通过共享任务列表和内部邮箱直接沟通。前端写个接口调用，可以直接问后端接口返回格式长啥样，不用绕回主 agent。

看个对比就明白了：

维度SubagentAgent Teams
上下文独立窗口，结果汇总给主 agent独立窗口，完全自主
通信只能和主 agent 说话成员之间直接发消息
协调主 agent 统一管理共享任务列表 + 自协调
适合单点任务，只要结果复杂协作，需要讨论
费用较低较高（每个成员是独立 Claude 实例）

这一对比就很清楚了。简单的单文件修改用 Subagent 就够，跨模块的大型任务才值得上 Agent Teams。

开搞：组第一个 AI 开发团队

第一步：开启实验功能

这功能在 Claude Code 里默认没开，需要手动设置环境变量。

在 ~/.claude/settings.json 里加：

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

或者在终端直接 export：

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

然后启动 Claude Code。如果 tmux 已经装了，团队面板会自动用 tmux 分屏显示。

这里我踩了个坑：第一次设完环境变量，启动 Claude Code 后直接说"帮我创建一个 agent team"，结果它完全没反应。查了半天才发现——需要 Opus 4.6 或更高版本。我用的还是旧版 Sonnet，根本不支持。切到 Opus 4.6 之后就正常了。

第二步：写 Prompt 组队

我当时有一个 Express 项目，想加用户认证模块。这么写的：

I have a Node.js/Express project in the current folder.
I need to add a complete user management module with:
- CRUD REST API (registration, login, profile, update, delete)
- JWT authentication with refresh tokens
- Input validation with Joi
- Testing with Jest (unit + integration)
- OpenAPI/Swagger documentation

Create a team of 4 agents:
1. Architect - analyzes existing code and defines DB schema and API structure
2. Backend Dev - implements controllers, middleware, routes
3. Tester - writes unit and integration tests with Jest
4. Docs Writer - generates OpenAPI documentation and JSDoc comments

The Tester must wait for the Backend Dev to complete the implementation.
The Docs Writer must wait for both the Architect and the Backend Dev.
Use Sonnet for each team member.

回车之后大概 20 秒，Claude Code 开始分裂——

多了 4 个分屏，每个窗口一个 agent。左边是主 agent（Team Lead），右边四个窗格各自独立运作。你能看到他们在任务列表里认领任务、更新状态、互相发消息。那个瞬间确实有点科幻片的意思。

第三步：他们是怎么协调的

Agent Teams 的核心架构就三个东西：

  1. Team Lead — 你的主会话，负责创建团队、分配任务、汇总结果
  2. Teammates — 每个成员一个独立的 Claude Code 实例，有自己的上下文窗口
  3. 共享任务列表 — .md 格式的文件，所有成员都能读/写/认领/更新
  4. 邮箱系统 — agent 之间发消息的通道，比如前端问后端 API 结构

任务列表存储在 ~/.claude/tasks/{team-name}/ 下，配置在 ~/.claude/teams/{team-name}/config.json。每个任务有状态：pending → in progress → completed。

实际操作中，我看到的是：

  • Architect 先分析了项目结构，在任务列表里写下了 DB schema 提案
  • Backend Dev 看到了，直接开始实现路由和控制器
  • Tester 在等 Backend Dev 的 pr，期间自己在写 test scaffolding
  • Docs Writer 最后启动，直接读完成了的代码写文档

全程不需要我插手。 大概 18 分钟后，4 个模块全部完成，代码可运行。我当时反应就是——离谱。

踩坑实录（真金白银换来的）

坑 1：Token 烧得飞快

这一点官方文档也没强调过——Agent Teams 的 token 消耗极其夸张。

4 个 Sonnet agent 同时跑，**不到 20 分钟就用完了 Pro 订阅（20/月）的额度∗∗。如果用的是按量计费的APIkey，4个agent跑一小时大概20/月）的额度**。如果用的是按量计费的 API key，4 个 agent 跑一小时大概 7-10。

建议：

  • 非关键任务用 Sonnet，关键模块用 Opus
  • 订阅用户跑小型 demo 还行，正式开发建议切 API key
  • 控制团队规模，不是人越多越好

坑 2：文件冲突

两个 agent 同时改同一个文件的时候——你猜对了——冲突了。

这事儿发生过两次：一次是 Backend Dev 和 Tester 都动了路由文件，另一次是 Docs Writer 和 Backend Dev 同时写注释覆盖了代码。

解决方式：在 prompt 里指定文件所有权（"Backend Dev owns src/routes/, Tester owns tests/"）。

坑 3：团队成员会卡住

偶尔某个 agent 会卡在某个任务上不动。如果你发现进度条不动了，手动发一条消息给 Team Lead：

Ask the researcher teammate to shut down

或

Shut down all teammates and clean up.

一定要通过 Team Lead 发号施令，直接 kill 进程会导致配置状态不一致。

坑 4：不是所有场景都适合组队

一开始我啥都想用 Agent Teams——改个 README 也组个队。结果发现：

单文件修改、一个 function 的重构、顺序执行的任务——这些用普通 Claude Code 或 Subagent 反而更快。

Agent Teams 有启动开销（20 到 30 秒），适合的是那些需要并行讨论、跨模块协调的场景。杀鸡用牛刀，不划算。

值得用吗？我的大实话

如果满分 10 分：

  • 震撼指数：9/10。第一次看到多 agent 开会协作，确实有种"未来来了"的感觉
  • 实用指数：7/10。bug 不少，需要耐心调教 prompt 和任务分配
  • 性价比：6/10。$20 订阅跑 20 分钟就烧完了，得用 API key 才玩得转
  • 推荐指数：8/10。如果手头有大型项目重构或新模块开发，值得一试

Anthropic 用 Agent Teams 自己搭了一个 C 编译器——2000 个会话、$20,000 API 成本、10 万行代码、连续跑了两周。这个案例让我相信这方向是对的，只是现在还在早期。

对于普通开发者，我的建议是：

  1. 先跑一两次 demo，感受一下
  2. 从 2-3 人的小团队开始，别一上来就搞 7 人团队
  3. 明确文件所有权分配，避免冲突
  4. 准备好钱包——或者用本地模型替代部分廉价 agent

写在最后

回看 2025 到 2026，AI 编码工具的演进路径越来越清晰了：自动补全 → Chat → Copilot → Agent → Agent Teams。开发者的角色从写代码变成了管理 AI 团队——更像一个架构师或项目经理了。

我自己的 workflow 现在是这样的：

  • 日常开发、单文件修改 → Cursor
  • 复杂自动化、终端操作 → Claude Code
  • 跨模块大项目、架构设计 → Agent Teams

这趋势走下去，明年这时候可能我们讨论的都是 10 人 AI 团队怎么管理了……

你对 Agent Teams 怎么看？有上手试过吗？欢迎评论区聊聊。

avatar
文章
阅读
粉丝