| title | 子 Agent 与任务拆分 |
|---|---|
| nav_title | 子 Agent |
| description | 什么时候该派子 Agent、内置的有哪些、怎么捏一个自己的。 |
| order | 3 |
子 Agent 就是 Claude 派出去的分身：给它一个明确的小任务，它自己带着独立上下文去干，干完只把结论交回来。
好处是主对话不会被一堆中间过程撑爆。比如「在这个仓库里找出所有调用 validateUser 的地方」，如果主 Agent 亲自去搜，几十个文件的内容全会挤进上下文；派个子 Agent 去，回来的只有一份清单。
- 要翻很多文件才能回答的问题 — 找用法、理清依赖、统计某种模式在哪些地方出现。
- 可以并行的独立工作 — 前端一个、后端一个、测试一个，同时开工。
- 需要多个角度看同一件事 — 比如让几个 Agent 各自审一遍同一段代码。
反过来，你已经知道文件在哪、改哪一行，那就直接说，不用绕这一圈。
派出去的子 Agent 会出现在活动面板的「SubAgent」区块，工具活动实时冒泡，点进去能看它完整的运行记录和最终结果。后台跑的也一样，不用等它结束才知道在干什么。
不用配置就能用的几个：
| 名称 | 干什么的 |
|---|---|
general-purpose |
通用兜底。复杂问题研究、找代码、多步骤任务，不知道派谁就派它 |
Explore |
专门快速探索代码库。按模式找文件、按关键词搜代码、回答「这块是怎么工作的」 |
Plan |
架构师。设计实现方案，返回分步计划、关键文件和取舍 |
claude-code-guide |
回答关于 Claude Code、Agent SDK 和 Claude API 本身的问题 |
verification |
收工前的验收。跑构建、测试、linter，给出通过 / 失败 / 部分通过的结论 |
statusline-setup |
配置 Claude Code 状态栏 |
在会话里可以直接说「用 Explore 去找一下……」，也可以让 Claude 自己判断该派谁。
打开 设置 → Agents。顶部三张卡是总数、生效中、来源类型数，下面按来源分组：
用户 → 项目 → 本地 → 托管 → 插件 → CLI 参数 → 内置
同名的 Agent 上面的来源会盖住下面的，被盖住的那个会标「被 X 覆盖」。日常主要看两组：
- 用户 — 你自己建的，对所有项目生效，文件在
~/.claude/agents/。 - 项目 — 只在当前项目生效，文件在项目里的
.claude/agents/，会跟着仓库一起分发。
点任意一条进详情页，能看到它的模型、思考强度、工具范围和完整系统提示词。内置和插件来源是只读的，详情页右上角会有一个「只读」标记。
鼠标移到列表里的某一行上，右侧会出现操作按钮：用户和项目 Agent 是「编辑」和「删除」，内置 Agent 是「调整模型」。详情页右上角也有同样的入口。
内置 Agent 各自钉了默认模型——Explore 和 claude-code-guide 走 Haiku，statusline-setup 走 Sonnet——图的是快和省。如果你更在意它们的结果质量，可以单独换掉。
在列表里点内置 Agent 那一行的「调整模型」，或者进详情页点右上角的同名按钮。能改的只有两项：
- 模型 — 「内置默认」「继承主会话」、Haiku / Sonnet / Opus / Fable 别名，以及当前 Provider 已配置的模型。
- 思考强度 — 「内置默认」或低 / 中 / 高 / 极高 / 最大。
系统提示词、工具范围和颜色不能改，仍由 Claude Code 固定。
:::tip
「内置默认」和「继承主会话」是两回事。以 Explore 为例，前者是它出厂就钉着的 Haiku，后者是跟着你主对话当前用的模型走。想恢复出厂设置就选「内置默认」，或者直接点「恢复内置默认」。
:::
覆盖写进 ~/.claude/settings.json 的 builtInAgentOverrides，对所有项目生效。恢复默认时这条记录会被整个删掉，不会在配置文件里留下空壳。
Agent 配置只保存模型 ID，不绑定 Provider。选择器会列出当前 Provider 的可用模型；如果以后切换 Provider，别名会按新 Provider 的映射解析，完整模型 ID 则需要新 Provider 也支持。
如果你自己建了一个同名的用户 Agent（比如手写一个 name: Explore 的 md 文件），它会完全盖住内置的那个，此时改内置的模型不会有任何效果——弹窗里会提示这一点。
点右上角「创建 Agent」，要填的字段：
- 配置范围 — 用户还是项目。选「项目」时下面会让你确认目标项目路径。
- 名称 — 1–64 位小写字母、数字、连字符或下划线，比如
code-reviewer。这是主 Agent 调用它时用的名字。 - 描述 — 说明主 Agent 应该在什么场景下委派给它。这一条最重要：主 Agent 就是靠它决定要不要派这个 Agent，写含糊了就永远不会被叫到。
- 系统提示词 — 定义这个 Agent 的职责、边界和预期输出。
- 模型 — 继承主 Agent，选择 Haiku / Sonnet / Opus / Fable 别名，或选择当前 Provider 已配置的模型。简单重复的活给 Haiku 更快更省。
- 思考强度 — 继承，或单独指定低 / 中 / 高 / 极高 / 最大。模型不支持某档时会自动降级或忽略。
- 工具 — 三选一：全部工具、不允许使用工具、自定义列表。选自定义时按读取与搜索 / 修改文件 / 执行命令 / 工作流分类勾选，下面还有一个自由输入框，用来填 MCP 工具名或者
Bash(git:*)这样的权限规则。 - 颜色 — 用来在界面上区分，可选。
保存后写入对应目录的 Markdown 文件，桌面端会尝试刷新当前会话。刷新失败不会回滚已经写好的文件，重启后仍然有效。
:::tip 只给必需的工具。一个只负责读代码给结论的 Agent 不需要 Write 和 Bash——权限收窄了，它跑偏的空间也就小了。 :::
想了解 Agent 文件格式、来源优先级和继承规则，看Agent 系统原理。