Appearance
11 · Subagent 与多 Agent 协作
📚 系列导航：上一篇 10 MCP 与外部工具 给 Codex 接上了外部工具。这一篇教你把活儿外包出去——子代理（Subagent），一个带独立上下文、独立工具的专项助手。
01 Subagent 是什么
Subagent 是 Codex 临时雇来的一个专项助手——它在自己的上下文窗口里干活，干完只把结论交回主线，过程中翻的一堆资料不占你的桌面。
| 维度 | 主对话 | 子代理 |
|---|---|---|
| 上下文 | 你和 Codex 的全部历史 | 一片空白，只收到任务交代 |
| 人设 | Codex 的默认设定 | 你给它写的专属人设 |
| 工具 | 你授权过的所有工具 | 可以单独砍掉 |
02 什么时候该用
| 对比项 | 直接在主对话干 | 硬拆给子代理 |
|---|---|---|
| 启动开销 | 没有，张嘴就干 | 子代理从白纸起步，得先花时间摸清状况 |
| 来回沟通 | 你一句它一句，随时改 | 交代不清就得返工 |
| 花费 | 一份 token | 多一个上下文 = 多烧 token |
WARNING
一句话能说清、改动就在眼前的活，绝不外包。
该用的场景：
- 跑测试/翻日志/查文档——产出大量中间垃圾，但你要的只是一句结论
- 专精某类任务——把「以审查员视角挑刺」固化成一个
code-reviewer - 几件互不相干的活并行——开三个子代理分别探索三个模块
03 建一个子代理
方式一：/agents 交互式
text
/agents弹出管理界面，Create new agent → Personal，用大白话描述你要什么样的助手。
方式二：手写配置文件
markdown
---
name: code-reviewer
description: 只读的代码审查员
tools: Read, Grep, Glob
---
你是一个资深代码审查员，只挑刺不改代码。按可读性、命名、潜在 bug 三类列出问题。存放位置：
~/.codex/agents/→ 你的所有项目都能用.codex/agents/→ 仅当前项目，进 git 团队共享
04 触发 Subagent
自动委派： Codex 拿你的话去比对 description，觉得对得上就自动派活。
直接点名：
text
用 code-reviewer 看看我最近的改动text
@agent-code-reviewer 看看这次认证相关的改动05 小结
| 知识点 | 一句话 |
|---|---|
| Subagent | 独立上下文的外包助手，干完只交结论 |
| 适用场景 | 隔离脏活、专精任务、简单并行 |
| 不适用 | 一句话能说清的简单改动 |
| 建子代理 | /agents 交互式或手写 .codex/agents/<name>.md |
NOTE
下一篇：12 Skill：把反复粘贴的步骤打包成可复用的工作流。