子智能体与并行：一个人带一支队伍

你让 Claude 排查「订单列表接口为什么慢」。它翻了三十多个文件，跑了几轮 SQL 日志分析，终于找到原因。可接下来让它动手改时，你发现它开始忘记你一开始交代的约束——上下文已经被那些搜索结果和日志塞满了（上下文为什么会「满」，见第 4 课）。

另一个场景：线上有个紧急 bug 要修，手头的新功能又不想停。两件事挤在同一个目录、同一个会话里，改动很容易搅在一起。

这一课讲两种「分身」：子智能体解决上下文被污染的问题，worktree 和后台会话解决多件事同时做的问题。

子智能体：派个助手去干脏活

子智能体（subagent）是主对话派出去的助手。它有自己独立的上下文窗口、自己的系统提示词、自己的工具权限。它在自己的窗口里读文件、跑命令，干完只把一份摘要交回主对话。中间那几十次搜索和几千行日志，都不会进入你的主上下文。

代价也要心里有数：子智能体从零开始，要花时间重新了解情况；它的请求和你的主对话计入同一份用量额度；派出很多个、每个都回一大段报告，主上下文照样会被撑大。

Claude Code 自带几个内置子智能体，平时由 Claude 自动选用：

自定义子智能体：写一个文件就是一个专家

当你发现自己总在用同样的话派同一类活，就该把它固化成文件了。子智能体就是一个带 YAML frontmatter 的 Markdown 文件：

同名时，项目级优先于用户级；组织托管的定义优先级最高，插件提供的最低。

下面是一个贴近国内前端项目的例子：一个只读的「国际化检查员」，专门找 Vue 组件里没走 i18n 的硬编码中文。

---
name: i18n-auditor
description: 检查 Vue/TS 代码中未经 i18n 处理的硬编码中文文案。在新增或修改页面组件后主动使用。
tools: Read, Grep, Glob
model: haiku
---

你是前端国际化检查员。收到任务后：
1. 用 Grep 在指定目录的 .vue 和 .ts 文件中查找中文字符；
2. 排除注释、console 日志和 locales 目录下的语言包；
3. 对每处疑似硬编码，给出「文件:行号、原文、建议的 i18n key」；
4. 只报告，不修改任何文件。最后按文件汇总数量。

几个要点：

• 只有 name 和 description 必填。description 决定 Claude 什么时候自动派它，写清「做什么、何时用」，加上「主动使用」之类的字眼会让它更积极地被调用。
• tools 是白名单，不写就继承全部工具。审查、检查类的子智能体一定要收紧，这既是安全，也是让它专注。
• model 可选 sonnet、opus、haiku、inherit 或完整模型 ID。机械性的扫描用便宜的模型就够了。
• 其他常用字段：disallowedTools（黑名单）、permissionMode、maxTurns、skills（预加载 Skill，见第 5 课）、mcpServers、hooks、isolation。字段名区分大小写、用驼峰写法，拼错不会报错，只会被静默忽略。

调用方式有三档：在提示词里点名（「用 i18n-auditor 检查一下 src/views」），由 Claude 决定是否委派；输入 @ 从列表里选中它，或直接写 @agent-i18n-auditor，保证这次一定由它执行；claude --agent i18n-auditor 则让整个会话都以它的身份运行。

前台还是后台？ 新版本里，Claude 从主对话派出的子智能体默认在后台运行：你可以继续聊别的，它需要权限时会在主会话里弹出提示并注明是哪个子智能体在问，完成后结果作为通知送回来。用 /tasks 可以查看、进入或停止后台的工作。如果你想让一个子智能体带着主对话的全部上下文去干支线任务，可以用 /subtask 任务描述 开一个「分叉」（fork），它不用你重新解释背景。

什么时候该用子智能体

只是想就当前对话里的内容快速问一句，用 /btw 就行，不必派子智能体。

并行开发：用 worktree 隔开文件

子智能体解决的是上下文隔离，但它们默认和你共用同一份工作目录。要让两个 Claude 同时改代码而不互相覆盖，需要 git worktree：同一个仓库的另一个工作目录，有自己的文件和分支，共享提交历史和远程。

Claude Code 内置了这个能力：claude --worktree 名字（简写 -w）会在仓库根目录的 .claude/worktrees/名字/ 下建一个 worktree，切出名为 worktree-名字 的新分支，并在里面启动会话。

# 终端 1：继续做新功能
$ claude -w coupon-feature
# 终端 2：同时修线上 bug，互不干扰
$ claude -w fix-pay-callback
# 想基于某个 PR 继续改，可以直接从 PR 切出（记得加引号）
$ claude -w "#1234"
$ git worktree list
  ~/projects/shop-admin                                   3f2a9c1 [main]
  ~/projects/shop-admin/.claude/worktrees/coupon-feature    3f2a9c1 [worktree-coupon-feature]
  ~/projects/shop-admin/.claude/worktrees/fix-pay-callback  3f2a9c1 [worktree-fix-pay-callback]

用之前要知道的几件事：

• 默认从远程默认分支切出，不是从你当前的分支。这是为了让 worktree 从干净的 main 开始。如果你需要带上本地未推送的提交，在 settings 里把 worktree.baseRef 设为 "head"。要从某个已有分支开始，就用 git worktree add 手动创建，再进去运行 claude。
• worktree 是全新检出，.env 这类被 gitignore 的文件不会自动带过去，node_modules 也要重新装。在项目根目录放一个 .worktreeinclude（语法同 .gitignore），列出要复制的文件，比如 .env.local。
• 把 .claude/worktrees/ 加进 .gitignore，免得主目录里出现一堆未跟踪文件。
• 退出时会检查：worktree 干净就自动删除；有改动或新提交会问你保留还是删除。删除会连同分支一起删掉，没提交的东西就没了。

子智能体也能各用一个 worktree：在定义文件里加 isolation: worktree，或直接对 Claude 说「给你的子智能体各开一个 worktree」。适合批量重构这种多个助手同时改不同文件的活。

更多并行方式：后台会话、agent view 与团队

官方目前把「同时做多件事」的方式分成几类，按你参与的程度由多到少：

后台会话有个贴心的设计：在 git 仓库里，它会在改文件前自动挪进自己的 worktree；完成后会提交，有远程就推送分支，必要时开草稿 PR，但不会推送到 main 或 master，不会强推，也不会合并。派出后，claude attach 短ID 接管、claude logs 短ID 看输出、claude stop 短ID 停止。如果你的 CLAUDE.md 写了「提交由我自己来」，它会照你的规矩办。