claude-code-haha/docs/desktop/agents.md

title, nav_title, description, order

title	nav_title	description	order
子 Agent 与任务拆分	子 Agent	什么时候该派子 Agent、内置的有哪些、怎么捏一个自己的。	3

子 Agent 与任务拆分

子 Agent 就是 Claude 派出去的分身：给它一个明确的小任务，它自己带着独立上下文去干，干完只把结论交回来。

好处是主对话不会被一堆中间过程撑爆。比如「在这个仓库里找出所有调用 validateUser 的地方」，如果主 Agent 亲自去搜，几十个文件的内容全会挤进上下文；派个子 Agent 去，回来的只有一份清单。

什么时候该派

• 要翻很多文件才能回答的问题 — 找用法、理清依赖、统计某种模式在哪些地方出现。
• 可以并行的独立工作 — 前端一个、后端一个、测试一个，同时开工。
• 需要多个角度看同一件事 — 比如让几个 Agent 各自审一遍同一段代码。

反过来，你已经知道文件在哪、改哪一行，那就直接说，不用绕这一圈。

派出去的子 Agent 会出现在活动面板的「SubAgent」区块，工具活动实时冒泡，点进去能看它完整的运行记录和最终结果。后台跑的也一样，不用等它结束才知道在干什么。

内置 Agent

不用配置就能用的几个：

名称	干什么的
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」，要填的字段：

1. 配置范围 — 用户还是项目。选「项目」时下面会让你确认目标项目路径。
2. 名称 — 1–64 位小写字母、数字、连字符或下划线，比如 code-reviewer。这是主 Agent 调用它时用的名字。
3. 描述 — 说明主 Agent 应该在什么场景下委派给它。这一条最重要：主 Agent 就是靠它决定要不要派这个 Agent，写含糊了就永远不会被叫到。
4. 系统提示词 — 定义这个 Agent 的职责、边界和预期输出。
5. 模型 — 继承主 Agent，或指定 Haiku / Sonnet / Opus / Fable，也可以填自定义模型 ID。简单重复的活给 Haiku 更快更省。
6. 思考强度 — 继承，或单独指定低 / 中 / 高 / 极高 / 最大。模型不支持某档时会自动降级或忽略。
7. 工具 — 三选一：全部工具、不允许使用工具、自定义列表。选自定义时按读取与搜索 / 修改文件 / 执行命令 / 工作流分类勾选，下面还有一个自由输入框，用来填 MCP 工具名或者 Bash(git:*) 这样的权限规则。
8. 颜色 — 用来在界面上区分，可选。

保存后写入对应目录的 Markdown 文件，桌面端会尝试刷新当前会话。刷新失败不会回滚已经写好的文件，重启后仍然有效。

:::tip 只给必需的工具。一个只负责读代码给结论的 Agent 不需要 Write 和 Bash——权限收窄了，它跑偏的空间也就小了。 :::

想了解 Agent 文件格式、来源优先级和继承规则，看Agent 系统原理。