Claude Code 打造AgentTeam实践

0 阅读2分钟

官网文档地址:协调 Claude Code 会话团队

今天偶然间翻文档,发现了 Claude Code 中有一个AgentTeam开发模式,官方介绍是:协调多个 Claude Code 实例作为一个团队一起工作,具有共享任务、代理间消息传递和集中管理。

以前我做复杂项目,要么单会话串行肝,要么开几个终端手动切,要么用 Subagents 丢任务等结果,全程都是单向汇报、我来统筹,队友之间根本不交流,遇到交叉问题还得我自己整合,效率低还容易漏。

现在用上 AgentTeam 才是真・团队开发:一个主会话当队长,下面多个队友各自独立上下文,能直接互相发消息、质疑方案、认领任务、解依赖,做并行 Code Review、查复杂 Bug、拆模块开发都巨合适。

跟 Subagents 最大区别:

  • Subagents:只干活不交流,只向主代理汇报,成本低
  • AgentTeam:队友之间互相对话、自我协调、辩论方案,适合复杂协作型任务

一、开启步骤(超简单)

AgentTeam 默认是关的,在配置里开一下就行:

打开你的 settings.json~/.claude.json,加上环境变量:

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

重启 Claude Code 就生效了。

二、基本使用方法

  1. 创建团队直接自然语言告诉 Claude 你要干嘛、要几个队友:
创建一个代理团队,分别负责前端、后端、安全审查,一起优化这个项目

它会自动生成队长 + 多个队友,共享任务列表。

image.png

不同任务执行时,如果依赖其他Agent,还会自动阻断任务,等待其他Agent完成。

你还可以在中途添加其他团队成员。

image.png

  1. 和队友交互
  • 单终端模式:按 Shift+Down 切换队友,直接发指令
  • 分屏模式:装 tmux 或 iTerm2,每个队友一个窗格,点一下就能聊

切换不同的队友可以跟不同的队友进行交互,如果需要下发其他的任务,可以跟负责人聊,也就是team-lead。最终的模式就是team-lead + 多agent的模式。team-lead把控全局,负责下发任务。其他子agent共同执行。

3.剔除队友/删除团队

清除单个队友可以要求team-lead做,也可以直接清除整个团队

目前我一般 3–5 个队友一组,拆好文件边界避免冲突,并行开发速度直接起飞。虽然 token 消耗比单会话高,但复杂项目这个效率提升真的值得。