Claude Code Agent Teams 学习笔记2

最近 Claude Code 更新了 Agent Teams（多智能体协作）功能。简单来说，它允许启动一个 Team Lead 会话，带上一群 Teammates 分头行动。

这和之前的 Subagents（子智能体）有本质区别：Subagents 是临时的“外包”，干完活拿结果就走；Agent Teams 是真正的“团队”，队员有独立上下文，能互相发消息，还能共享任务列表协同推进。

开启方式

这个功能目前还是实验性质，默认是关掉的。需要在环境变量或 settings.json 里手动打开：

// settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

核心玩法：如何带队

启动团队很直接，直接描述需求和团队结构。比如：

# 让领队带三个队员审查 PR
claude "Create an agent team to review PR #142. Spawn three reviewers:
- One focused on security
- One checking performance
- One validating test coverage"

1. 任务管理

团队共用一个任务列表。Lead 负责派活，队员干完手头的活会自动去领下一个没被占用的任务。可以按 Ctrl+T 随时查看当前的进度表（pending -> in progress -> completed）。

2. 通信与切换

队员运行在独立的实例里，互不干扰。

切换视角：在 in-process 模式下，用 Shift+Up/Down 就能在不同队员的终端窗口里穿梭。每个队员都有专属的颜色标识（蓝、绿、黄等），一眼就能认出当前在和谁说话。
插手干预：按 Enter 进某个队员的会话，看他不顺眼或者跑偏了，直接输入消息修正，或者按 Escape 掐断它这一轮。

3. 协作模式

审批流：可以要求队员在动代码前必须拿到你的审批（Require plan approval）。
Delegate Mode：按 Shift+Tab 开启委托模式。这时候 Lead 只管调度和沟通，一行代码都不亲自动手，彻底当甩手掌柜。

适用场景

什么情况该上 Agent Teams？

多维度审查：比如同时查安全、性能、覆盖率。
并行开发：一人写前端，一人撸后端，互不干扰。
排查疑难杂症：派两三个人分头去试不同的猜测。

注意：如果是那种一步接一步的线性任务，或者都要改同一个文件，还是老老实实单兵作战，强行上团队只会增加沟通开销（Token 也会烧得很快）。

限制

资源消耗：每个 Teammate 都是独立的 Claude 实例，意味着 Token 消耗是翻倍的。
状态滞后：任务列表的状态更新偶尔会有点延迟。
环境适配：有些终端（如 VS Code 集成终端）还不支持分屏（split pane）模式。
清理：记得活干完了让 Lead 运行 Clean up the team，把资源都释放掉。

目前看来，Agent Teams 非常适合作为复杂工程任务的“指挥中心”。比起单打独斗，这种能并行、能讨论的模式在处理大规模代码重构或系统性调研时优势非常明显。