Claude Code Agent Teams 上手指南:启用、协作与最佳实践

Agent Teams 封面图

OpenClaw 社区先做到了多会话协作,Anthropic 直接把它做成了官方功能。 这不是一个小更新,而是 Claude Code 的工作方式从“单兵作战”升级为“团队协作”。这篇文章带你快速上手 Agent Teams:什么时候值得用、怎么开、怎么配、怎么管、哪里会踩坑。

先说结论:这不是“更强的 Sub-agent”,而是“真正的团队”

以前你只有一个会话,所有事情顺序完成:先研究、再改代码、再写测试。Agent Teams 出现后,一个 lead 负责拆解任务,多个 teammate 并行协作,还能互相交流、共享任务列表。

更直观的对比:

  • Sub-agents:像派一个助理去拿答案,回来报告。
  • Agent Teams:像把一群专家放进同一个项目里协作。

如果任务需要互相沟通、互相校验,Agent Teams 才真正发挥价值。

什么时候该用?什么时候是过度设计?

适合用的场景(并行能带来明显收益):

  • 研究/评审:不同队友分别看代码、查资料、提风险点。
  • 跨层开发:一个队友做前端,一个队友做后端,一个队友写测试。
  • 调试:多条假设并行验证,避免单一路径走歪。

不适合用的场景

  • 强顺序依赖(第二步必须等第一步完成)。
  • 同文件高频编辑(容易覆盖冲突)。
  • 很小的任务(协调成本比收益更高)。

一句话:能拆成独立任务的,用团队;必须串行的,用单人或 sub-agent。

如何启用 Agent Teams(30 秒完成)

Agent Teams 目前是实验功能,默认关闭。你有两种方式开启:

方式 1:修改 settings.json(推荐,持久化)

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

方式 2:环境变量(临时)

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

启用后,Claude Code 会识别团队指令。官方文档可参考:
Agent Teams 文档

启动团队:最重要的是“清晰的角色分工”

你不需要特殊语法,只要给 lead 一个清晰任务和分工提示。

示例(高质量提示):

我在设计一个 CLI 工具,扫描代码里的 TODO 并生成报告。创建一个 agent team:

  • teammate A:从用户体验角度给出功能优先级
  • teammate B:提出技术架构与实现路径
  • teammate C:以“反对者”视角挑出风险与替代方案

好的 prompt = 明确角色 + 独立任务 + 预期输出。这一步越清楚,成本越低。

运行中如何控制团队

当团队跑起来后,必须知道 3 个关键操作:

  1. 直接和任意队友对话
  • In-process 模式:Shift + 上/下 切换队友
  • Split-pane 模式:点击对应 pane(需要 tmux 或 iTerm2)
  1. Delegate mode(防止 lead 抢活)
    有时候 lead 会“忍不住自己干”。开启 delegate mode 后,lead 只能协调:分配任务、发消息、管理列表。
  • 切换快捷键:Shift + Tab
  1. 任务分配与回收
  • 可由 lead 指派,也可被队友自动领取
  • 队友完成后建议主动“汇报 + 标记完成”

Agent Teams vs Sub-agents:如何选?

决策问题就一个:是否需要队友之间的沟通?

  • 不需要互相沟通,只要结果 → Sub-agents(便宜、快、适合单点任务)
  • 需要协作、互相对齐 → Agent Teams(贵、但能处理复杂系统)

成本提醒:Agent Teams 可能是 sub-agent 成本的数倍,请在“收益明显”时使用。

最佳实践:少走弯路的 7 条经验

  1. Spawn prompt 要细:不要假设队友知道你的历史上下文。清楚写清目标、范围、输入/输出。
  2. 任务粒度适中:能在 15–40 分钟内完成并交付。
  3. 避免同文件编辑:同一文件交给一个队友,减少合并冲突。
  4. 定期 check-in:每 15–20 分钟主动询问进展,避免跑偏太久。
  5. 先做“研究/评审”试水:最容易看到并行价值。
  6. 任务列表清晰:拆成可验收的子任务,完成后立刻标记。
  7. 用角色命名:如 frontend, backend, test, review,便于协作。

当前已知限制(避免误踩)

  • 会话恢复不支持/resume/rewind 不会恢复队友。
  • 任务状态偶尔延迟:完成了但未标记,需手动更新或提醒。
  • 一个会话只能有一个团队:不能创建多个团队或转移 lead。
  • Split-pane 有终端限制:仅支持 tmux 或 iTerm2。

Key Takeaways

  • Agent Teams 适合并行协作,不适合顺序强依赖任务。
  • 清晰的角色与任务拆解是效率与成本的关键。
  • Delegate mode 可以让 lead 专注管理,不再自己动手。

Agent Teams 封面图

OpenClaw 社区先做到了多会话协作,Anthropic 直接把它做成了官方功能。 这不是一个小更新,而是 Claude Code 的工作方式从“单兵作战”升级为“团队协作”。这篇文章带你快速上手 Agent Teams:什么时候值得用、怎么开、怎么配、怎么管、哪里会踩坑。

先说结论:这不是“更强的 Sub-agent”,而是“真正的团队”

以前你只有一个会话,所有事情顺序完成:先研究、再改代码、再写测试。Agent Teams 出现后,一个 lead 负责拆解任务,多个 teammate 并行协作,还能互相交流、共享任务列表。

更直观的对比:

  • Sub-agents:像派一个助理去拿答案,回来报告。
  • Agent Teams:像把一群专家放进同一个项目里协作。

如果任务需要互相沟通、互相校验,Agent Teams 才真正发挥价值。

什么时候该用?什么时候是过度设计?

适合用的场景(并行能带来明显收益):

  • 研究/评审:不同队友分别看代码、查资料、提风险点。
  • 跨层开发:一个队友做前端,一个队友做后端,一个队友写测试。
  • 调试:多条假设并行验证,避免单一路径走歪。

不适合用的场景

  • 强顺序依赖(第二步必须等第一步完成)。
  • 同文件高频编辑(容易覆盖冲突)。
  • 很小的任务(协调成本比收益更高)。

一句话:能拆成独立任务的,用团队;必须串行的,用单人或 sub-agent。

如何启用 Agent Teams(30 秒完成)

Agent Teams 目前是实验功能,默认关闭。你有两种方式开启:

方式 1:修改 settings.json(推荐,持久化)

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

方式 2:环境变量(临时)

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

启用后,Claude Code 会识别团队指令。官方文档可参考:
Agent Teams 文档

启动团队:最重要的是“清晰的角色分工”

你不需要特殊语法,只要给 lead 一个清晰任务和分工提示。

示例(高质量提示):

我在设计一个 CLI 工具,扫描代码里的 TODO 并生成报告。创建一个 agent team:

  • teammate A:从用户体验角度给出功能优先级
  • teammate B:提出技术架构与实现路径
  • teammate C:以“反对者”视角挑出风险与替代方案

好的 prompt = 明确角色 + 独立任务 + 预期输出。这一步越清楚,成本越低。

运行中如何控制团队

当团队跑起来后,必须知道 3 个关键操作:

  1. 直接和任意队友对话
  • In-process 模式:Shift + 上/下 切换队友
  • Split-pane 模式:点击对应 pane(需要 tmux 或 iTerm2)
  1. Delegate mode(防止 lead 抢活)
    有时候 lead 会“忍不住自己干”。开启 delegate mode 后,lead 只能协调:分配任务、发消息、管理列表。
  • 切换快捷键:Shift + Tab
  1. 任务分配与回收
  • 可由 lead 指派,也可被队友自动领取
  • 队友完成后建议主动“汇报 + 标记完成”

Agent Teams vs Sub-agents:如何选?

决策问题就一个:是否需要队友之间的沟通?

  • 不需要互相沟通,只要结果 → Sub-agents(便宜、快、适合单点任务)
  • 需要协作、互相对齐 → Agent Teams(贵、但能处理复杂系统)

成本提醒:Agent Teams 可能是 sub-agent 成本的数倍,请在“收益明显”时使用。

最佳实践:少走弯路的 7 条经验

  1. Spawn prompt 要细:不要假设队友知道你的历史上下文。清楚写清目标、范围、输入/输出。
  2. 任务粒度适中:能在 15–40 分钟内完成并交付。
  3. 避免同文件编辑:同一文件交给一个队友,减少合并冲突。
  4. 定期 check-in:每 15–20 分钟主动询问进展,避免跑偏太久。
  5. 先做“研究/评审”试水:最容易看到并行价值。
  6. 任务列表清晰:拆成可验收的子任务,完成后立刻标记。
  7. 用角色命名:如 frontend, backend, test, review,便于协作。

当前已知限制(避免误踩)

  • 会话恢复不支持/resume/rewind 不会恢复队友。
  • 任务状态偶尔延迟:完成了但未标记,需手动更新或提醒。
  • 一个会话只能有一个团队:不能创建多个团队或转移 lead。
  • Split-pane 有终端限制:仅支持 tmux 或 iTerm2。

Key Takeaways

  • Agent Teams 适合并行协作,不适合顺序强依赖任务。
  • 清晰的角色与任务拆解是效率与成本的关键。
  • Delegate mode 可以让 lead 专注管理,不再自己动手。

Claude Code 创作者分享的 10 条高效使用技巧

Claude Code Tips Cover

这是一位名为 Boris 的作者在推文中整理的使用心得。他表示这些技巧来自 Claude Code 团队的内部实践,同时也强调:没有唯一正确的用法,每个人都应该根据自己的工作流不断试验与调整。

原文地址:https://x.com/bcherny/status/2017742741636321619

1) 并行:3–5 个 worktree 同时跑

团队的 No.1 技巧:同时开 3–5 个 git worktree,每个 worktree 对应一个 Claude 会话。上下文更干净、并行更高效。

Worktree 并行示例

实践建议:

  • 给 worktree 起名并设 alias(如 za/zb/zc
  • 单独开一个“分析 worktree”用于日志/查询

2) 复杂任务先进入 Plan Mode

先把计划做扎实,再执行才容易一枪到位。

Plan Mode 示例

一些团队成员会:

  • 让一个 Claude 写计划
  • 再让另一个 Claude 以“资深工程师视角”审核

一旦走偏就回到 Plan Mode 重规划,不要硬推。

3) 把 CLAUDE.md 当成自我修正系统

每次纠正 Claude 后,都补一句:

“更新 CLAUDE.md,避免下次再犯。”

CLAUDE.md 记忆示例

持续迭代后,Claude 的错误率会明显下降。

4) 把重复劳动写成 Skill / Slash Command

做超过一天的事,就值得自动化。

团队建议:

  • /techdebt:会话末尾清理重复代码
  • 自动同步 Slack / Asana / GDrive / GitHub 上下文
  • 构建“数据工程师风格”的 agent 写 dbt / review / 测试

5) 让 Claude 自己修 Bug

不要过度指导,把问题喂给它即可:

Slack MCP 修复示例

  • 贴 Slack bug 线程说 “fix”
  • 或直接说 “修复 failing CI tests”
  • 把 Docker logs 直接贴进去

6) Prompt 进阶技巧

  • 让 Claude 审你
    “Grill me on these changes, don’t PR until I pass.”
  • 不满意就推翻
    “Knowing everything you know now, scrap this and implement the elegant solution.”
  • 先写清楚 spec:越具体越少返工

7) 终端与环境配置

团队喜欢 Ghostty(同步渲染、24-bit 色彩、完整 Unicode)。

终端与环境配置示例

提升效率的小习惯:

  • /statusline 显示上下文与分支
  • 终端 tab 颜色区分任务
  • tmux 一任务一 tab
  • 语音输入(Mac 双击 fn)提示词更完整

8) Use Subagents

在需求结尾加一句 “use subagents”,Claude 会开多个子任务并行。

Subagents 并行示例

优点:主上下文更干净、并行探索更快。

9) 用 Claude 做数据分析

团队把 BigQuery CLI 直接接到 Claude Code,6 个月没写 SQL

只要有 CLI / MCP / API 的数据库都能用同样方法接入。

10) 用 Claude 学习新知识

  • /config 开启 Learning / Explanatory 模式
  • 让 Claude 生成 HTML 讲义
  • 让 Claude 画 ASCII 架构图
  • 做“间隔复习”学习 skill:你讲理解,Claude 追问补全

总结:Claude Code 的价值不在单次对话,而在于工作流的长期迭代。并行化、计划驱动、规则沉淀与技能化工具,是提升效率的核心。

Claude Code Tips Cover

这是一位名为 Boris 的作者在推文中整理的使用心得。他表示这些技巧来自 Claude Code 团队的内部实践,同时也强调:没有唯一正确的用法,每个人都应该根据自己的工作流不断试验与调整。

原文地址:https://x.com/bcherny/status/2017742741636321619

1) 并行:3–5 个 worktree 同时跑

团队的 No.1 技巧:同时开 3–5 个 git worktree,每个 worktree 对应一个 Claude 会话。上下文更干净、并行更高效。

Worktree 并行示例

实践建议:

  • 给 worktree 起名并设 alias(如 za/zb/zc
  • 单独开一个“分析 worktree”用于日志/查询

2) 复杂任务先进入 Plan Mode

先把计划做扎实,再执行才容易一枪到位。

Plan Mode 示例

一些团队成员会:

  • 让一个 Claude 写计划
  • 再让另一个 Claude 以“资深工程师视角”审核

一旦走偏就回到 Plan Mode 重规划,不要硬推。

3) 把 CLAUDE.md 当成自我修正系统

每次纠正 Claude 后,都补一句:

“更新 CLAUDE.md,避免下次再犯。”

CLAUDE.md 记忆示例

持续迭代后,Claude 的错误率会明显下降。

4) 把重复劳动写成 Skill / Slash Command

做超过一天的事,就值得自动化。

团队建议:

  • /techdebt:会话末尾清理重复代码
  • 自动同步 Slack / Asana / GDrive / GitHub 上下文
  • 构建“数据工程师风格”的 agent 写 dbt / review / 测试

5) 让 Claude 自己修 Bug

不要过度指导,把问题喂给它即可:

Slack MCP 修复示例

  • 贴 Slack bug 线程说 “fix”
  • 或直接说 “修复 failing CI tests”
  • 把 Docker logs 直接贴进去

6) Prompt 进阶技巧

  • 让 Claude 审你
    “Grill me on these changes, don’t PR until I pass.”
  • 不满意就推翻
    “Knowing everything you know now, scrap this and implement the elegant solution.”
  • 先写清楚 spec:越具体越少返工

7) 终端与环境配置

团队喜欢 Ghostty(同步渲染、24-bit 色彩、完整 Unicode)。

终端与环境配置示例

提升效率的小习惯:

  • /statusline 显示上下文与分支
  • 终端 tab 颜色区分任务
  • tmux 一任务一 tab
  • 语音输入(Mac 双击 fn)提示词更完整

8) Use Subagents

在需求结尾加一句 “use subagents”,Claude 会开多个子任务并行。

Subagents 并行示例

优点:主上下文更干净、并行探索更快。

9) 用 Claude 做数据分析

团队把 BigQuery CLI 直接接到 Claude Code,6 个月没写 SQL

只要有 CLI / MCP / API 的数据库都能用同样方法接入。

10) 用 Claude 学习新知识

  • /config 开启 Learning / Explanatory 模式
  • 让 Claude 生成 HTML 讲义
  • 让 Claude 画 ASCII 架构图
  • 做“间隔复习”学习 skill:你讲理解,Claude 追问补全

总结:Claude Code 的价值不在单次对话,而在于工作流的长期迭代。并行化、计划驱动、规则沉淀与技能化工具,是提升效率的核心。