这里帮你把这段内容拆解成“是什么、为什么、怎么用”三个层次，方便理解记忆。

一、核心概念：Subagent 是什么？

你可以把 Subagent（子代理） 想象成你手下的一名临时专家员工。

• 独立办公室：它有自己的独立“办公室”（独立的上下文窗口），在里面干活不会弄乱你的办公桌（主对话上下文）。
• 临时工性质：和它沟通只需一句话交代任务，它完成后只把“最终报告”拿回来给你，过程中的草稿、搜索记录、杂乱日志你都看不见。
• 专业分工：你可以为反复做的同一类工作，定制一个专门的员工（自定义 Subagent），每次都用同样的指令，非常省事。

核心好处：

• 保留上下文：把繁杂的探索、搜索过程隔离在外，保持主对话清晰。
• 强制执行约束：可以限制它只能用“眼睛”（只读工具），不能动手修改。
• 复用配置：好的员工定义可以在所有项目里通用。
• 控制成本：简单任务可以派给“实习生”（更快更便宜的模型，如 Haiku）。

二、什么时候用它？（使用时机）

遇到以下情况，就值得派一个 Subagent 出马：

1. 任务会污染主对话：比如搜索一堆文件、分析大量日志，这些中间结果你事后根本不想再翻看。
2. 有固定的重复工作：你总在重复“审查代码，然后给出改进建议”这种带固定指令的操作。

三、系统自带的“钦差大臣”（内置 Subagents）

Claude Code 有几个内置的“钦差大臣”，会自动启用。你可以先理解它们，再学怎么自定义。

四、如何创建自定义 Subagent？（快速上手版）

有两种方式，最简单的是用命令界面生成，就像填表招聘一样。

方法：使用 /agents 命令创建（类似填招聘表）

假设你要“招聘”一个专门审查代码的代理，步骤如下：

1. 打开招聘界面：在 Claude Code 里运行命令 /agents。
2. 选择员工类型：切换到 Library（库） 标签，选 Create new agent -> Personal。这会把它存成你的“私人班底”，所有项目都能用。
3. 口述职位描述：选 Generate with Claude，然后对它说：

   A code improvement agent that scans files and suggests improvements for readability, performance, and best practices. It should explain each issue, show the current code, and provide an improved version.
   （它会自动帮你生成这个代理的名字、描述和核心提示词。）

4. 限定工作权限：在工具选择界面，只勾选只读工具（Read-only tools）。这样它就只能看，不能改。
5. 指定能力级别：选择一个模型，比如 Sonnet，在分析能力和速度之间平衡。简单任务可选更快的 Haiku。
6. 选个工牌颜色：选个背景色，方便在界面上认出它。
7. 决定是否记笔记：User scope 选项是给它一个记事本（记忆目录），让它能在多次任务中积累经验。不需要就选 None。
8. 保存并上岗：按 s 保存。之后就可以直接派活：“用我新设的 code-improver 代理审查一下这个项目”。

这样，你就完成了一个自定义 Subagent 的全套创建和使用了。