DellDi信息内容栈
中文English
知识库2026年7月4日

Claude Code Agent-Teams 完整笔记

详细笔记记录Claude Code Agent Teams功能，包括工作机制、安装配置、与Subagents区别、实战演示、成本限制及最佳实践。

#语雀#AI专题#CC 使用技巧#Claude Code#Agent Teams#AI协作#macOS#tmux

文章基本信息

  • 标题：Claude Code Agent-Teams：16个AI同时编码的时代来了 + 公众号：龙哥AI + 核心发布：2026年2月5日 Anthropic 推出 Claude Opus 4.6 的实验性功能 —— Agent Teams + 核心观点：编程范式彻底改变，从「程序员 + 单个AI助手」→ 「架构师 + AI团队」。你不再自己写代码，而是指挥一群AI并行协作。

Agent Teams 到底是什么？工作机制

  • 团队结构：
  • 1个 Team Lead（你或主Claude，负责协调）
  • 多个 Teammates（独立执行任务的AI）
  • 协作方式：
  • 共享 Task List（任务列表，支持依赖、阻塞）
  • Mailbox（信箱，支持互相发消息、单播/广播）
  • 共享 Git 仓库 + 文件锁防止冲突
  • 创建方式：自然语言一句话 示例：「创建一个 Agent Team，用 3 个 Teammates 并行开发我的 Swift 项目，分别负责 Bridging、Engine、Utilities 模块。」 + 两种显示模式：
  • In-Process（默认，后台运行，Shift+Up/Down 切换）
  • Split-Pane（推荐，用 tmux 分屏实时看每个Teammate进度）
  • Delegate 模式（Shift+Tab）：Lead 只协调、不自己写代码，避免抢活。 + In-Process模式（默认）：所有Teammates在主终端内运行 + <font style="color:rgb(199, 37, 78);background-color:rgb(249, 242, 244);">Shift+Up/Down</font>：切换Teammate + <font style="color:rgb(199, 37, 78);background-color:rgb(249, 242, 244);">Ctrl+T</font>：查看任务列表 + 无需额外配置，任何终端都能用

Split-Pane模式（需要tmux或iTerm2）：每个Teammate独立窗格

与 Subagents 的区别（很重要！）

项目 Subagents（轻量） Agent Teams（重协作）
触发方式 主Agent自动启动 用户自然语言让Lead创建
上下文 结果压缩回主Agent 完全独立实例
通信 只向上报告 Teammates 可互相发消息
协调 主Agent集中管理 共享任务列表，自我协调
成本 低（约1.5-3x） 高（5-10x）
适用场景 搜索、审查、简单并行 大型多模块、复杂协作项目

作者实战演示（Tuck macOS 项目）

  • 项目：菜单栏管理工具，1500行规划文档，10个Phase，30+ Swift文件 + 加速效果：
  • 单Agent：全项目 ≈15小时
  • Agent Teams：全项目 ≈7小时（加速 2.1x）
  • Phase 1（核心引擎）：单Agent 2小时 → 3个Agent 并行 50分钟
  • 核心技巧（必看，必记）：
  • 写好 CLAUDE.md（共享给所有Teammates的项目规范、接口、协作规则）
  • 文件严格所有权分离（每个Teammate只碰自己的文件）
  • 立即进入 Delegate 模式
  • 要求Teammates先输出计划，Lead批准后再执行
  • 用 Git Worktree 隔离工作目录
  • 推荐用 Sonnet 模型节省成本
  • 每阶段结束清理旧团队，再建新团队

成本与现实限制（很诚实）

  • 成本：
  • 3人团队 ≈ 单Agent的5-7倍
  • 普通开发者一天可能几百元
  • 值得用的场景：多模块并行、代码审查、大规模重构、竞争性调试 + 不值得用的场景：串行依赖强、同一个文件反复改、极小任务 + 当前限制（实验功能）：
  • 无会话保存（Lead崩了要重启）
  • 每会话只能一个团队
  • 必须用 tmux 分屏
  • 任务偶尔卡住需手动干预

作者最终思考（最有价值部分）

  • 角色转变：你从「写代码的人」变成「写规划的人 + 团队管理者」 + 未来核心技能：
  • 写极致清晰的规划文档（需求、接口、模块边界、验收标准）
  • 架构设计与任务拆解能力
  • Review、集成、最终把关质量
  • 一句话总结：AI越能干活，人类越需要做好「灵魂」工作（愿景、权衡、审美、用户洞察）。

十条最佳实践（直接抄走）

  • 从只读任务练手
  • 一定要写 CLAUDE.md
  • 文件所有权严格分离
  • 每个Teammate控制在5-6个任务
  • 默认开 Delegate 模式
  • 定期检查进度并要求计划批准
  • 优先用 Sonnet 省钱
  • 用 Git Worktree 隔离
  • 前期 Prompt 越详细越好
  • 小项目先练手，逐步扩大团队规模

笔记使用建议

  • 第1周：反复看「机制」+「区别」+「十条实践」，边看边在 Claude Code 里建个2-3人小团队试试 + 第2周：重点练「写 CLAUDE.md」和「任务拆解」 + 第3周：尝试复制作者 Tuck 项目流程，做自己的小工具 + 长期：把「指挥AI团队」当成一门手艺，像管理真人团队一样练习
bash8 行
# macOS安装tmux
brew install tmux

# 配置
# settings.json
{
"teammateMode":"tmux"
}
markdown20 行
# Tuck - macOS Menu Bar Manager

## 技术栈
- Swift + SwiftUI(70%) + AppKit(30%)
- macOS 14 Sonoma+
- 不使用沙箱（需要Accessibility权限）

## 项目结构
详见 shimmying-sparking-wilkinson.md（包含每个Phase的详细代码规格）

## 编码规范
- 使用 @MainActor @Observable 代替 ObservableObject
- 错误处理使用 os.Logger
- 所有私有API封装在 Bridging/ 目录
- SwiftUI和AppKit的桥接统一在各自的Panel/View中处理

## Agent协作规则
- 每个Agent只修改自己负责的文件，绝对不碰其他Agent的文件
- 公共接口变更必须在任务描述中明确说明
- 完成后在任务中标注新增的public API供其他Agent参考

相关内容