用途:协调多个 Claude Code 实例组成团队协作,每个成员是独立的 Claude 会话,拥有共享任务列表和代理间消息机制。适合能通过并行探索获益的任务,如研究评审、新模块或功能开发、竞争假设调试、跨层协调(前端、后端、测试各由一名成员负责)。
启用与用法:该功能为实验性且默认关闭,需在 settings.json 中设置环境变量 "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"。用自然语言让 Claude 创建团队并生成成员,例如要求一名成员负责 UX、一名负责技术架构、一名充当反方。可指定成员数量与模型,可要求计划审批(由 lead 审阅批准或驳回并反馈)。
显示模式:in-process 模式所有成员在主终端,Shift+Down 切换,任意终端可用;tmux 或 iTerm2 下可用分屏,每个成员一个窗格;默认 auto。可用 claude --teammate-mode in-process 或设置 {"teammateMode": "in-process"} 覆盖。
控制与任务:任务有 pending、in progress、completed 三种状态,可设置依赖,lead 分配或成员自行认领,Ctrl+T 切换任务列表。in-process 下 Shift+Down 循环、Enter 查看、Escape 中断;分屏下点击窗格即可对话。结束时先让各成员关闭,再由 lead 执行清理。钩子 TeammateIdle 和 TaskCompleted 可实现质量门禁,退出码 2 会发送反馈并阻止空闲或完成。
最佳实践:生成提示中提供足够上下文(成员不继承 lead 的对话历史),从 3-5 名成员起步,每人 5-6 个任务,避免文件冲突,先用于研究/评审。
限制:成员不支持会话恢复(/resume、/rewind 不还原);任务状态可能滞后;每个会话仅一个团队;不支持嵌套团队;lead 固定;成员沿用 lead 的权限模式;分屏需 tmux 或 iTerm2,不支持 VS Code 终端、Windows Terminal 或 Ghostty。存储位置:团队配置在 ~/.claude/teams/{team-name}/config.json,任务列表在 ~/.claude/tasks/{team-name}/。