一个人就是一支队伍：Claude Code Agent Teams 深度上手指南

Vibe Tools Expert Team

发布时间Feb 22, 2026

更新时间Feb 22, 2026

在过去的一段时间里，我们使用 AI 编程的习惯通常是：写一段很长的 Prompt，开启一个巨大的对话框，指望这个“超级工程师”能搞定一切。不管是前端、后端还是测试，所有的上下文都塞进同一个窗口。但这种方式往往会在项目变大时失效，上下文开始溢出，AI 会忘记之前的决策，你不得不反复解释。

现在，Anthropic 为 Claude Code 引入了一个重磅的实验性功能：Claude Code Agent Teams。它彻底改变了游戏规则，将 AI 编程从“写 Prompt”提升到了“团队管理”的维度。

什么是 Claude Code Agent Teams

简单来说，Claude Code Agent Teams 允许你协调多个 Claude Code 实例，像真正的工程团队一样协作。它不再是单个模型在单打独斗，而是一个由以下核心组件构成的系统：

Claude Code Agent Teams 的底层逻辑并非魔法，而是严谨的系统设计。它采用了文件驱动的协作模式：发送消息本质上是在收件箱文件中追加 JSON 数据，领取任务则是更新任务文件。

这种架构带来了两个核心优势：

想要体验 Claude Code Agent Teams，你需要按照以下步骤进行配置。

目前该功能默认关闭。你需要在 shell 环境中设置变量，或者修改 ~/.claude/settings.json 文件：

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

为了实时看到每个队员的进度，建议安装 tmux 或使用 iTerm2。这样 Claude 就能自动开启分屏模式，让你有一种坐在监控室指挥全局的即视感。

在 Claude Code 终端中，你可以用自然语言直接下令：

“创建一个 Claude Code Agent Teams，由一名 UX 设计师、一名后端工程师和一名架构师组成，帮我开发一个 TODO 追踪工具。”

Claude 会自动分析需求，生成任务列表，并派生出各个角色的代理。

切换视角：在 In-process 模式下，按 Shift + Down 可以循环切换不同的队员会话，直接与他们对话。
委派模式 (Delegate Mode)：按 Shift + Tab 进入委派模式。在这种模式下，主代理不会自己改代码，而是全身心投入到协调和任务分配中，这能有效防止主代理“越俎代庖”。
清理现场：任务完成后，对主代理说“Clean up the team”，它会优雅地关闭所有成员并移除临时资源。

虽然 Claude Code Agent Teams 非常强大，但由于它会产生 3 到 4 倍的 Token 消耗，所以需要选对场景。

对于纯研究性或单一文件的任务，传统的 Subagents 仍然是更高效、更省钱的选择，因为 Subagents 主要是单向汇报，不涉及复杂的成员间协作。

使用 Claude Code Agent Teams 的核心心法是：把 AI 当成工程师，而不是魔法。

明确上下文：虽然队员会自动加载项目配置（如 CLAUDE.md），但他们不继承主代理的对话历史。所以，在派生队员时，请在 Prompt 中提供充足的任务细节。
契约先行 (Contract-First)：先让数据库代理定义好 Schema，或者让后端定义好 API 契约，再让前端队员并行施工。这种方式能有效减少因为并行开发导致的逻辑冲突。
拆解任务粒度：如果任务太大，队员可能会由于长时间不汇报而产生偏差。确保每个任务都是一个清晰的交付单元。

Claude Code Agent Teams 的出现，标志着 AI 辅助编程进入了“管理时代”。当你学会如何编排一群 AI 代理，而不仅仅是向一个对话框提问时，你的开发效率将迎来质的飞跃。

博客