Claude Code Agent Teams指南

版本前提:Claude Code 2.1.32-2.1.33: 引入 Agent Teams(预览版)、Claude Opus 4.6 支持及持久化记忆

启用配置

为了启用 Agent Teams 功能,请按照以下 JSON 配置进行设置:

复制代码
{
    "env": {
        "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
    },
    "teammateMode": "tmux",
    "model": "opus",
    "agentSettings": {
        "teammateModel": "sonnet"
    }
}

重要提示 :当选择 tmux 作为队友模式时,如果遇到现有窗口显示异常的情况,请确保完成或关闭当前会话后再重新启动 tmux。

状态检查与管理命令
  • 激活 Agent Teams:

    export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

  • 初始化并行任务:

    claude "创建一个由三名成员组成的团队来审查此PR"

  • 查阅团队详情:

    cat ~/.claude/teams/{team-name}/config.json

  • 列出所有相关任务:

    ls ~/.claude/tasks/{team-name}/

  • 清除指定团队资源:

    rm -rf ~/.claude/teams/{team-name} ~/.claude/tasks/{team-name}

iTerm2 对 Split Panes 模式的支持

设置步骤
  1. 在 settings.json 文件中将 teammateMode 设置为 tmux。该设置将自动检测是否使用了 tmux 或 iTerm2。

    {
    "teammateMode": "tmux"
    }

  2. 确认 settings.json 中的完整配置如下所示:

    {
    "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
    },
    "teammateMode": "tmux"
    }

  3. 安装 tmux 并在 iTerm2 内开启控制模式:

    • 使用 Homebrew 安装 tmux:

      brew install tmux

    • 开启 tmux 控制台模式:

      tmux -CC

  1. 额外针对 iTerm2 的要求包括:
    • 安装 it2 CLI 工具:
      • 参考 GitHub 页面获取手动安装指南。
      • 或者通过运行下面的命令进行安装:

      uv tool install it2

    • 启动 iTerm2 的 Python API 支持:
      • 打开 iTerm2 应用程序。
      • 从菜单栏选择 iTerm2 -> Install Shell Integration...。
      • 进入 iTerm2 -> Preferences -> General -> Magic,勾选 Enable Python API 选项。
  1. 在新打开的终端窗口里启动 Claude:

    claude

  2. 示例任务分配给 Claude 以展示多视角协作能力:

    • 创建一个多角色团队,分别负责架构评审、开发评审以及测试评审,并特别关注项目中的 CPU 和内存消耗问题。
    • 任务文件示例:@code-review-team.md
      以上步骤详细说明了如何在 Claude Code 4.6 版本中利用 Agent Teams 功能来处理复杂的工作流程。

单次会话强制模式:

复制代码
claude --teammate-mode in-process

显示模式选项:

  • "in-process" - 所有 teammates 在主终端运行,用 Shift+Down 切换
  • "tmux" - 每个 teammate 独立 pane(支持 tmux 或 iTerm2)
  • "auto"(默认)- 在 tmux 会话中自动使用 Split Panes,否则用 In-Process

iterm2原生支持分屏(会cpu卡死)

复制代码
claude --teammate-mode tmux

请用 team 模式完成一个只读任务:

  1. 创建 3 个 agent(架构、后端、前端)并行工作;

  2. 不修改任何代码、不运行写操作;

  3. 分别汇报:项目结构、主要 API 路由位置、主要页面组件位置;

  4. 最后给出一份合并总结,并说明每个 agent 的分工与产出。

为了测试iTerm2的Agent功能,我们直接使用了Claude进行验证,但未观察到自动分屏的现象。

官方文档: Orchestrate teams of Claude Code sessions - Claude Code Docs

相关推荐
Flynt14 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
ServBay15 小时前
Local harness 将退役,VS Code 本地开发要不要搬到云端?
后端·ai编程·visual studio code
T_Wizard16 小时前
AI 回复为什么要转圈 3 秒才「啪」一下全出来?把流式输出拆开看,顺便踩了 6 个坑
java·ai编程
0zien016 小时前
【AI编程 - 第二弹】宝石TD
ai编程
IT规划师17 小时前
热点速递 | 未来软件工程六大战略技术趋势
ai编程
qinglongcn17 小时前
怎么让 200 轮的长任务不崩——三层保全策略
agent·ai编程
颜进强17 小时前
微信小微AI-灰度与命中排查|代码全对、版本已发,为什么同事就是问不中?
前端·ai编程·全栈
颜进强17 小时前
微信小微AI-评测|文档质量直接被判 0 分:小微团队评测那些没人告诉你的硬指标
前端·ai编程·全栈
颜进强17 小时前
微信小微AI-提审与发布|评测过了不等于能上线:四道前置条件,缺一道都白提交
前端·ai编程·全栈
小虎AI生活17 小时前
太好了!豆包终于接入了多模型,正面硬刚WorkBuddy
aigc·ai编程