第13章多智能体协作

约 1831 字大约 6 分钟

2026-08-18

这一章来聊聊 Claude Code 的多智能体玩法，Subagents 和 Agent Teams。学会它，你就能让好几个 Claude 同时干活，互相配合完成大任务。

13.1 为什么需要多个 Claude？

从生活里找个例子

你装修房子的时候，会找一个工人把水电、木工、油漆全干了吗？小活儿可以，大活儿不行——要么工期太长，要么质量不行。

正常做法是，水电工干水电，木工干木工，各干各的，最后一起验收。

用 Claude Code 也是一样。以前你只有一个 Claude，让它查资料、写代码、跑测试，它得一件一件来。而且有个烦人的问题，

让它翻一大堆文件找东西，翻完之后它的"脑子"里塞满了文件内容，真正干活反而变笨了。

多智能体就是解这个问题的。

一个 Claude 干活的两个痛点

痛点	具体表现
串行太慢	查资料 → 写代码 → 跑测试，只能一件件来
上下文污染	翻完 50 个文件，有效信息没多少，垃圾内容把脑子塞满了

一句话搞懂多智能体

让主 Claude 当"包工头"，把辅助活儿外包给专门的"小工"，干完活交报告，不占包工头的脑子。

13.2 Subagents——给 Claude 请"外包小工"

Subagent 是啥？

Subagent（子代理）就是一个独立的小 Claude，有自己的上下文、自己的提示词、自己的工具权限。主对话可以让它去干具体的活儿，它干完之后把结果摘要交回来。

关键点，Subagent 干活的内容不会进主对话的上下文。它翻了 100 个文件，主对话只收到一句"相关代码在第 3 个文件的 120 行附近"。脑子清爽了。

内置的 Subagents

新版 Claude Code 已经自带了几个 Subagent，不需要配置就能用，比如，

Explore，专门负责大范围搜代码、找文件，只读不改
Plan —— 专门负责读代码、设计方案，不动手改东西

你平时让它"帮我找一下 xx 在哪"，它可能就已经悄悄派了个 Explore 出去。这就是为什么有时候你会看到一行提示 "Launching agent..."。

自己定义一个 Subagent

在项目的 .claude/agents/ 目录下建一个 Markdown 文件，比如 code-reviewer.md，

---
name: code-reviewer
description: 专门检查代码质量。写完代码之后主动用它复查。
tools: Read, Grep, Glob
---

你是一个代码审查专家。检查代码时遵循这些规则，
1. 优先找出可能导致运行出错的逻辑问题
2. 其次找性能问题
3. 最后看命名和注释
输出一份简短的审查清单，按严重程度排序。

保存之后，下次你说"帮我审查一下刚才的代码"，Claude 就会把活儿派给这个专家。它只能用 Read、Grep、Glob（只读权限），想让它改代码也改不了——权限随 Subagent 走，更安全。

啥时候用 Subagent？

场景	适不适合	为啥
翻大量文件找东西	✅ 很适合	结果摘要回来，不污染主对话
让多个方案并行试试	✅ 很适合	开几个 Subagent 各试各的
查日志定位问题	✅ 很适合	日志又臭又长，让小工看去
简单的改一行代码	❌ 杀鸡用牛刀	直接改更快
需要来回讨论的设计	❌ 不适合	Subagent 只交报告，不能聊（这种要用下面的 Agent Teams）

13.3 Agent Teams——组一支"施工队"

和 Subagents 有啥不一样？

Subagent 是外包，干完活拿报告走人。Agent Teams 是施工队，队员之间可以互相说话、互相质疑、自己协调分工。

对比项	Subagents	Agent Teams
关系	主人派活给外包	队友之间平等协作
交流	只跟主对话汇报	队员之间可以互相对话
适合	独立的辅助任务	需要讨论、验证的复杂任务
状态	稳定功能	实验性功能（默认关闭）

怎么开启？

Agent Teams 目前是实验性功能，默认不打开。开启方式，

/config

在配置里找到 agent teams 相关选项打开即可（不同版本入口可能略有差异，也可以看官方文档的 Agent Teams 页面）。

一个实际例子

假设你要重构一个老项目，

你对主 Claude 说，"组个队，把支付模块重构了"
主 Claude 拉起一支队伍，比如一个负责梳理现有逻辑，一个负责写新代码，一个负责跑测试把关
队员之间自己沟通，"这个接口我改了签名，你那边调用要同步改"
有分歧的时候，他们互相质疑、验证，最后给你一个结论
你只验收结果

实验性功能提醒

Agent Teams 还在快速迭代中，行为可能有变化。而且多个 Agent 并行写代码有个已知坑——它们可能做出互相不兼容的假设，合并时容易冲突。大项目用之前先在小事上试试水。

13.4 怎么选？一张决策图

记住一个原则，能简单的就简单。多智能体不是炫技，是活儿真的大了才用。开三个 Claude 烧的是三倍的量，任务不大的时候纯属浪费。

13.5 几个实用建议

先从内置 Subagents 用起。Explore 这种内置的已经很好用了，不用急着自定义。
自定义 Subagent 描述要写清楚"啥时候用我"。description 里写"写完代码之后主动用它复查"这种触发时机，主 Claude 才知道什么时候派活。
限制 Subagent 的工具权限。查资料的只给读权限，改代码的才给写权限。权限越小，越不容易出事。
并行任务用 worktree 隔离。让多个 Agent 同时改代码时，给每个分配独立的 git worktree，物理上隔离，避免互相踩脚。
Agent Teams 先试小事。实验性功能，别一上来就重构核心模块。

13.6 这一章聊了啥

概念	一句话
多智能体	让多个 Claude 配合干活，主对话当包工头
Subagent	外包小工，独立上下文，干完交摘要报告，不污染主对话
内置 Subagent	Explore（搜代码）、Plan（做方案）等，开箱即用
自定义 Subagent	`.claude/agents/` 下写 Markdown 文件定义，权限随 Subagent 走
Agent Teams	施工队模式，队员互相对话协作，实验性功能
选择原则	能简单就简单，活儿大了才上多智能体

下一章来聊聊怎么把这些能力组合起来，做几个完整的大项目实战。

第13章 多智能体协作

第13章多智能体协作