一个 Claude 从头干到尾,够吗
基础课里,你让一个 Claude 从头干到尾:它读文件、改文件、跑命令。任务简单时没问题,但一复杂就露馅:
- 上下文越来越长,它越来越「健忘」,前面的决定后面忘了
- 任务太多太杂,它顾此失彼,越改越乱
- 返工成本高,改到一半发现方向错了
这就引出进阶的第一个概念:子 Agent。
codex-review——一个「多 Agent 协作的代码评审工作台」。你手上每天都会接到「审一批代码」的任务,与其让一个 Claude 从头审到尾,不如先理解子 Agent:用多个子 Agent 并行拆解评审任务,让「审逻辑」「审安全」「审风格」各派一个专家。这一节的子 Agent 概念,就是它的地基。什么是子 Agent
子 Agent(Subagent)是 Claude Code 里的「专门干某类活的助手」。它有自己的角色、技能、工具边界,能独立完成一个子任务,再把结果交回主会话。
类比:你不是让一个人同时当「设计师 + 后端 + 测试」,而是派三个专人来,各干各的。主会话负责调度和汇总。
主会话(负责人)
├─ 子 Agent A:设计
├─ 子 Agent B:后端
└─ 子 Agent C:测试
换到我们的 codex-review 上,评审任务天然就是这种「多角色」结构:
主会话(评审总指挥)
├─ 子 Agent A:逻辑评审(业务正确性、边界情况)
├─ 子 Agent B:安全评审(注入、权限、敏感信息)
└─ 子 Agent C:风格评审(命名、格式、可读性)
每个子 Agent 都是一个「评审专家」,专注自己的专业领域。
关键:任务上下文(Context)
每个子 Agent 都有自己独立的上下文——它只看到被分配的那部分任务,不被整个项目的无关信息干扰。
这正是子 Agent 的价值所在:
- 主会话不会被「所有子任务的细节」撑爆
- 每个子 Agent 专注自己那一小块,上下文干净、判断准
| 对比 | 一个 Claude 干全部 | 多个子 Agent |
|---|---|---|
| 上下文 | 越用越长、越挤 | 各自独立、清爽 |
| 专注度 | 分散 | 各司其职 |
| 并行 | 不能 | 能并行 |
在 codex-review 里,「独立上下文」的收益尤其明显:如果让一个 Claude 同时审 30 个文件的逻辑、安全、风格,它的上下文早就被塞满了,审到后面会「忘了前面审过什么」。拆成三个专家,每个只看自己那份,判断质量和速度都更好。
什么时候该用子 Agent
不是所有任务都要拆。判断标准:
- 任务大而复杂 → 拆
- 多文件、多模块 → 拆
- 子任务之间相对独立 → 拆
- 小任务硬拆,反而更慢 → 别拆
对评审场景,一个实用的判断:改动超过 5 个文件,或跨了 2 个以上关注点(逻辑 / 安全 / 风格),就值得拆。 只改了 1 个文件、就是个小修,直接审就行,拆反而浪费。
怎么让 Claude 起子 Agent
通常你在对话里「指派」即可——用自然语言描述子任务,让主会话调度。例如:
我需要分三个子任务并行推进:
1. 让一个子 Agent 分析项目结构
2. 让另一个子 Agent 列出所有 TODO
3. 让第三个子 Agent 检查依赖安全
最后把三个结果汇总给我。
主会话会拆出子任务、派发、回收结果、汇总。
这是最「轻」的起法,适合临时起意。在 codex-review 里,你平时可以这么起一个临时的并行评审:
请并行启动三个评审子 Agent,审一下 src/ 这次的改动:
1. 子 Agent A:审逻辑,重点看业务正确性和边界情况
2. 子 Agent B:审安全,重点看输入校验和敏感信息
3. 子 Agent C:审风格,重点看命名、格式、可读性
每个只输出「必须改 / 建议改 / 可不改」三档结论,最后汇总给我。
注意这里有个伏笔:临时起和做成固定技能,差别很大。 你不可能每次都手打这么长一段——到模块 03 技能系统,我们会把这段固化成一个 codex-review 技能,一句 /review 就起三路并行。现在先学会「手动起」,理解它的机制。
落地练习
② 怎么判断做对了:能看到三个子 Agent 确实各自输出了独立的评审结论,而不是主会话一个人憋出来的;每个结论都给了「位置 + 问题 + 建议」;三份汇总后没有相互矛盾的修改建议。
③ 卡住了怎么办:如果 Claude 只给了一份综合结论、没真正并行,就明确补一句「我要三份独立的评审,分别来自三个不同子 Agent,不要合并」;如果某个子 Agent 没审到点子上,给它更具体的关注点,比如「安全:重点看 SQL 注入和硬编码密钥」。
常见坑:把「起子 Agent」和「单线程套话」搞混
很多新手以为说了「用子 Agent」就真的并行、真的分工了,结果 Claude 只是在一段回复里「假装」分了几段,实际还是同一份思路——这就失去了子 Agent 独立上下文的全部意义。
怎么分辨?看两点:
- 它有没有真的分出去:真正用子 Agent 时,你会看到主会话「派发 → 回收 → 汇总」的过程;如果它一口气写了一大段、里面只是排版分了几个小标题,那就是套话。
- 结论是不是各自独立:真正的子 Agent 会带着自己领域的视角,甚至给出「和其他 Agent 冲突」的建议(比如逻辑上对但风格上有问题),这才说明是独立的。
小结
- 复杂任务单靠一个 Claude 容易上下文爆炸、顾此失彼
- 子 Agent = 有独立角色和上下文的专门助手
- 独立上下文是它的核心优势
- 边界清晰、可独立验证的任务才值得拆
- codex-review 的评审任务天然适合拆成「逻辑 / 安全 / 风格」三路子 Agent
下一节,学怎么把复杂任务拆解和编排——先拆好,才能并行得好。