DEV Community

Cover image for Claude Code Agent Teams：一个人写代码的时代，结束了
dudumd
dudumd

Posted on

Claude Code Agent Teams：一个人写代码的时代，结束了

#ai #claude #tutorial

从单兵作战到 AI 团队协作 —— 手把手教你启用最强编程新功能

阅读时长：8 分钟 ｜ 难度：入门级 ｜ 建议收藏

🔥 先说一个让我震惊的事

Anthropic 有个工程师，用 16 个 Claude 同时写代码，花了 2 万美金 API 费用，跑了将近 2000 个 Claude Code 会话。

产出是什么？

一个 10 万行的 Rust C 编译器，能编译 Linux 内核。

你没看错。不是一个人写的，是一个 AI 团队写的。

这就是 Agent Teams 的威力。

而现在，这个功能对每个 Claude Code 用户开放了。只需要加一行配置。

🤔 到底什么是 Agent Teams？

先别急着看教程，我们搞清楚一个根本问题：

以前的 Claude Code 就像你雇了一个很厉害的全栈工程师。虽然他什么都会，但一次只能干一件事 —— 写完后端写前端，写完前端跑测试，串行推进。

Agent Teams 的本质是： 你不再是雇了一个人，而是拥有了一整个技术团队。

你跟「技术总监」（Team Lead）下达任务，他会自动派生出多个独立的 Claude 实例，每个实例各司其职、并行工作、互相通信。

▎跟 Subagent 有什么区别？

这是很多人困惑的地方。一张表说清楚：

对比维度 Subagent Agent Teams
通信方式 只能汇报给主 Agent 队友之间可以直接对话
独立性 共享主会话上下文 每人独立上下文窗口
协调能力 主 Agent 是唯一中转 去中心化，自组织
适用场景 简单的并行子任务 复杂的需要协作的项目
交互方式 不可观察、不可干预 可切换、可观察、可介入

💡 一句话总结：Subagent 像是你的下属向你汇报工作，Agent Teams 像是一群同事围着白板讨论方案。

📋 启用前，你需要准备什么？

别急着复制配置，先确认三件事：

▎1. 确认你的订阅计划

Agent Teams 需要 Claude Pro（$20/月）或 Claude Max（$100-$200/月）计划。

Pro 计划每天大约能跑 2-3 次 Agent Teams 任务。如果你是重度使用者，建议上 Max —— 每 5 小时可以跑 8-10 个复杂任务，做专业项目的话，第二个任务就已经回本了。

▎2. 确认 Claude Code 版本

Agent Teams 需要 Claude Code v2.1.32 以上版本。检查方法：

claude --version
Enter fullscreen mode Exit fullscreen mode

如果版本不够，更新一下：

npm install -g @anthropic-ai/claude-code@latest
Enter fullscreen mode Exit fullscreen mode

▎3.（可选）安装 tmux

tmux 可以让每个 Agent 拥有独立的终端面板，方便你同时观察所有队友的工作状态。不装也行，只是所有输出会挤在一个窗口里。

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
Enter fullscreen mode Exit fullscreen mode

🚀 三步启用 Agent Teams

整个过程不超过 30 秒。

▎第一步：找到配置文件

Claude Code 的设置文件在你的用户目录下：

# macOS / Linux
~/.claude/settings.json

# Windows
%USERPROFILE%\.claude\settings.json
Enter fullscreen mode Exit fullscreen mode

▎第二步：添加环境变量

打开 settings.json，在 env 字段中加一行：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}
Enter fullscreen mode Exit fullscreen mode

💡 如果你的 settings.json 里已经有其他 env 配置，只需要在 env 对象里加上这一行就行，别覆盖了原有配置。

▎第三步：重启 Claude Code

关掉当前会话，重新打开 Claude Code。Agent Teams 功能立即生效。

没有第四步了。就是这么简单。

✨ 第一次使用 Agent Teams

启用之后，你不需要学任何新命令。直接用自然语言告诉 Claude 你想组建什么样的团队就行。

▎场景一：代码审查

以前你让 Claude 审查 PR，它会从头到尾看一遍，容易顾此失彼。现在：

Create an agent team to review PR #142.
Spawn three reviewers:
- One focused on security implications
- One checking performance impact
- One validating test coverage
Have them each review and report findings.
Enter fullscreen mode Exit fullscreen mode

三个专家同时审查，安全、性能、测试三个维度一个不落。

▎场景二：全栈开发

一个 feature 涉及前端、后端、测试？拆成三个人同时做：

Create an agent team to build the user dashboard.
One teammate on the API layer,
one on the frontend components,
one on the test suite.
Enter fullscreen mode Exit fullscreen mode

关键在于：当 API 队友定义好了接口类型，它会直接通知前端队友，不需要你手动中转。

▎场景三：竞争性调试

遇到一个诡异的 bug？让三个 Claude 各提一套假设，同时验证：

I have a race condition in the payment service.
Create an agent team with three debuggers:
- One investigating the database connection pool
- One checking the async queue implementation
- One reviewing the transaction locking logic
Have them test their hypotheses and converge.
Enter fullscreen mode Exit fullscreen mode

三条线并行排查，谁先找到谁说话。传统方式可能要串行排查几小时的问题，十几分钟搞定。

⚙️ 两种工作模式，怎么选？

In-process（默认） tmux 分屏模式
显示方式 所有队友在同一个终端窗口 每个队友独占一个面板
切换方式 Shift + Down 切换队友 tmux 面板自由切换
适合谁 刚上手，任务简单 重度用户，需要全局视野
额外依赖 无 需要安装 tmux

想切换到 tmux 模式？在 settings.json 里加一行：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "teammateMode": "tmux"
}
Enter fullscreen mode Exit fullscreen mode

💰 关于费用，说点大实话

Agent Teams 会消耗更多 Token。 这是必须面对的事实。

每个队友都是一个完整的 Claude 实例，拥有独立的上下文窗口。3 个队友 ≈ 3 倍 Token 消耗。

有人测试过，用 Agent Teams 生成一周的社交媒体内容，5 个 Agent 并行工作 15 分钟，总花费约 $7.80。同样的事手动做，至少要半天。

什么时候值得用？

  • ● 任务可以拆成独立模块并行推进
  • ● 质量控制比速度更重要（多角度审查）
  • ● 跨层协调（前端 + 后端 + 测试同步推进）
  • ● 竞争性调试（多种假设同时验证）

什么时候别用？

  • ● 简单的单文件修改
  • ● 任务之间强依赖、必须串行的
  • ● 日常小问题，一个 Claude 就够的

💡 原则：如果一个人就能干好，不要组团队。这跟管理真人团队是一个道理。

🎯 5 个让你事半功倍的进阶技巧

▎技巧一：在 Prompt 里明确分工

不要说「帮我处理这个项目」。要说清楚每个队友负责什么、边界在哪。模糊的指令会导致队友之间踩脚。

▎技巧二：控制队友数量

最多可以开 10 个队友，但不代表你应该开 10 个。大多数任务，2-4 个队友是最佳平衡点。人多了协调成本反而上去。

▎技巧三：善用 CLAUDE.md

每个队友启动时会自动加载项目根目录的 CLAUDE.md。把项目规范、代码风格、架构约定写在里面，所有队友就有了统一的「团队手册」。

▎技巧四：可以中途介入

发现某个队友方向跑偏了？用 Shift+Down 切过去直接跟它对话纠正，不需要停掉整个团队。

▎技巧五：先用 Plan Mode 审批

在 prompt 里加一句 Require plan approval before any teammate makes changes，队友执行前会先给你看方案，你确认后才动手。适合对代码质量要求高的场景。

⚠️ 当前的局限性（坦诚说）

Agent Teams 仍然是实验功能，有几个已知问题：

  • 会话恢复：如果 Claude Code 意外关闭，队友状态可能无法完美恢复
  • 任务协调：极少数情况下，两个队友可能同时修改同一个文件产生冲突
  • 关闭行为：团队结束时，个别队友可能没有被完全清理
  • Token 消耗不可预测：复杂任务的实际 Token 用量可能远超预期

这些问题 Anthropic 在持续修复中，每个版本都在变好。但现阶段用的时候，保持对成本的关注。

📝 最后说几句

Agent Teams 不是一个锦上添花的小功能。它代表了一个根本性的范式转变：

从「人指挥一个 AI」到「人管理一个 AI 团队」。这中间的能力鸿沟，会在 2026 年迅速拉开。

现在开始建立「多 Agent 协作」的思维方式和肌肉记忆，是你能做的最有性价比的投资之一。

毕竟，配置只需要 30 秒。而你获得的，是一整个团队。

觉得有用？转发给你那个还在单兵作战的同事吧 👊

点赞 + 收藏 = 下次更新不迷路

Top comments (0)