子代理与并行把大任务拆开,让几个会话同时干
一个会话的上下文是瓶颈。子代理把探索、审查、重复劳动分出去,git worktree 让多个会话各改各的分支。会拆任务,是从「用它写代码」到「用它做项目」的分水岭。
全部章节
本页
先说结论
- 让主会话保持干净:读大量文件、翻日志、全仓库搜索这类「看得多、留得少」的活,交给子代理,只把结论带回来。
- 需要同时改几件互不相关的事,用
git worktree给每个会话一个独立目录和分支,各跑各的,最后合并。 - 拆任务的标准只有一条:两个任务之间不需要互相知道对方改了什么。
子代理是什么
主会话在对话里可以派出子代理:一个全新的、上下文独立的 Claude Code 实例,带着主会话写给它的一段任务说明去工作,做完把结果交回来。子代理读过的几十个文件、跑过的命令输出都留在它自己那边,主会话只收到一段总结。
这解决的是 日常工作流 里说的问题:主会话的上下文是最贵的资源。让它亲自翻遍 src/ 找一个函数的所有调用点,可能要吃掉几万 token;派一个子代理去翻,主会话只多了一行「共 7 处调用,分别在……」。
你不需要显式调用。说「先搜一遍仓库看看这个接口在哪些地方用到,再改」,它通常会自己决定派子代理。想要更明确,直接说「用子代理去做 X」。
什么活适合分出去
| 适合子代理 | 不适合 |
|---|---|
| 大范围搜索与阅读(找调用点、读陌生模块) | 需要和你来回讨论的设计决策 |
| 独立的审查(「检查这个 PR 有没有安全问题」) | 依赖主会话刚改过的、还没提交的内容 |
| 重复性的批量改动(「把这 12 个文件的日志格式统一」) | 改动之间有先后依赖 |
| 和主任务无关的旁支(「顺便查一下这个库的 breaking change」) | 几行就能做完的小事(派出去的开销更大) |
一个实用的模式是审查分离:主会话写代码,另派一个子代理从头读 diff 挑毛病。第二双眼睛没有主会话的先入之见,更容易发现问题。
自定义子代理
在项目里建 .claude/agents/ 目录,每个 Markdown 文件定义一种子代理:名字、什么时候用、能用哪些工具、系统提示。例如一个只负责审查的子代理(给它 Bash 是为了运行 git diff,提示里要求它不改代码):
---
name: reviewer
description: 代码审查。改完一批文件后用它从头读 diff,找正确性与安全问题。
tools: Read, Grep, Glob, Bash
---
你是严格的代码审查员。只报告确定的问题,每条给文件路径与行号,
说明触发条件与后果。不要改代码。定义好之后,主会话会按 description 自动选用,你也可以直接说「让 reviewer 看一遍」。把这些文件提交进仓库,团队就共用同一套分工。
并行:多个会话同时改
子代理在主会话之内。另一种并行是开多个独立的 Claude Code 会话,各做一件事。前提是它们别互相踩:同一个工作目录里两个会话同时改文件,会出现一个覆盖另一个的情况。
用 git worktree 解决:
git worktree add -b feature/payments ../myapp-payments
git worktree add -b feature/i18n ../myapp-i18n-b 会同时新建分支。每个目录是同一个仓库的一个独立检出,各自在自己的分支上。在每个目录里开一个终端跑 claude,交代不同的任务。做完各自提交,回主目录合并。
也可以让 Claude Code 代劳:claude -w payments 会在 .claude/worktrees/payments 建好 worktree,并直接在里面开会话。它默认从仓库的默认分支新建 worktree-payments 分支;想从当前分支分出,把设置项 worktree.baseRef 设为 "head"。
不管用哪种方式建,worktree 里的配置分三种情况:
每个 worktree 里自动生效的
- 已提交的
CLAUDE.md和.claude/配置:它们随仓库检出,每个 worktree 里都有。
与主检出共用的
- 权限批准:选「不再询问」的规则写进主检出的
.claude/settings.local.json,所有 worktree 共用。在 Windows 上、仓库根就是家目录等情况下例外,规则只留在当前 worktree。 - 没提交的 skills:worktree 根目录下没有
.claude/skills时(比如这个目录整个被 gitignore),读主检出那份;worktree 自己有这个目录时(比如提交过其中几个),只加载自己那份。 .claude/agents、.claude/commands按同样的规则处理。
不会带过去、要手动处理的
.env这类被 gitignore 的文件:worktree 里没有,需要手动复制。- 例外:Claude Code 自己建的 worktree(
claude -w、子代理的 worktree)可以自动带。在项目根目录放一个.worktreeinclude,按.gitignore的语法写;只有既匹配、又被 gitignore 的文件才会复制。
细节见 官方说明 (在新窗口打开)。
什么时候值得这样做:几件事互不依赖、每件都要十几分钟以上、你有空在几个窗口之间看结果。什么时候不值得:任务之间有依赖,或者你根本看不过来,并行只会制造需要你裁决的冲突。
常见的拆法
- 按层拆:一个会话改后端接口,一个会话改前端调用,先约定好接口契约(写在一个文件里,两边都
@进去)。 - 按模块拆:十几个独立的 bug,每个会话领三四个,互不相关。
- 按阶段拆:主会话做实现,子代理做审查,第三个会话写测试。
拆之前花一分钟写清每个任务的输入、输出和边界,比事后合并冲突省得多。
常见问题
子代理会不会漏掉主会话知道的事?
会。它看不到你们之前的对话,也不知道主会话读过哪些文件。它拿到的是主会话里的 Claude 替它写的任务说明。自定义和通用子代理还会加载各级 CLAUDE.md;内置的 Explore、Plan 不加载,所以必须遵守的规则(比如「别动 vendor/」)交代任务时再说一遍。派出去的任务要自包含:路径、要找什么、结果要什么格式。
并行会话的费用是不是翻倍?
总 token 差不多,但每个会话上下文更短,单位效率更高,整体通常更省。
子代理的结果可信吗?
和主会话一样可信,也一样需要核对。审查类子代理的报告,看一眼它引用的行号就知道靠不靠谱。