用途：让多个 Claude Code 会话在同一代码库中同时工作，第一个会话自动成为团队领导，负责协调、委派与审查，后续会话作为队友加入。与子代理的区别是，队友是完整的 Claude Code 会话，拥有独立上下文窗口、可用全部工具，并能彼此直接发消息，而不只是向父级汇报。
启用方式：设置环境变量后启动，第一个会话即团队领导。
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude # starts as team lead
主要能力：共享任务列表（任务状态为 pending → in-progress → completed，另有 blocked 等待依赖）、邮箱消息、文件锁认领（编辑前先认领文件以避免冲突，任务完成后释放）、计划审批（队友先写简要计划，领导批准或纠正后再实现）、委派模式（按 Shift+Tab 切换，领导只协调、不直接改代码）。另有 Hook 事件：TeammateIdle、TaskCreated、TaskCompleted。
使用方式与建议：团队规模以 3-5 人为佳，2 人适合一人构建一人审查，超过 5 人协调开销大于并行收益；每个队友约 5-6 个任务。拆分任务需触及不重叠文件、可独立验证、有明确完成标准；任务可声明依赖，队友自动领取已解除阻塞的任务。展示方面可用 Shift+Down 在进程内切换查看队友，或对超过 2 名队友使用分屏（tmux 用 tmux split-window -h，iTerm2 用 Cmd+D），每个窗格运行自己的 claude 会话。
适用场景：不重叠文件的并行工作、跨层改动（API、UI、测试）。背景探索宜用子代理，隔离分支用 worktree，竞争方案用多个 worktree 比较，大规模迁移用 /batch 命令。
限制与反模式：超过 5 名队友、任务共享可变状态或同一文件、跳过计划审批、领导亲自实现而不协调、未设置依赖导致竞争。文档：https://code.claude.com/docs/agent-teams