Claude Code 里的 Agent / subagent 很容易被误用。很多人一看到“可以派 Agent 并行干活”,第一反应就是:那是不是所有任务都应该分给多个 Agent?实际项目里恰好相反:Agent 是放大器,不是默认模式。任务边界清楚、输出可以独立验收,它才有价值;边界不清楚、需要连续确认、涉及高风险写入时,Agent 反而会制造更多返工。
这篇文章不把 subagent 当成炫技功能介绍,而是从真实开发任务出发,回答三个问题:哪些任务适合交给 Agent,哪些任务应该留在主上下文里直接做,以及怎么验收 Agent 的结果。
如果你还没熟悉基础用法,可以先看 Claude Code 怎么用:新手从安装到完成第一次改代码;如果任务需要先做方案确认,再参考 Claude Code Plan Mode 实战。
什么是 Claude Code 里的 Agent / Subagent
在 Claude Code 的工作流里,Agent 可以理解为一个被派出去完成特定子任务的独立执行者。它通常有自己的上下文窗口,可以读文件、搜索代码、整理结论,最后把结果返回给主会话。
它和主会话的区别不是“更聪明”,而是:
| 维度 | 主会话 | Agent / Subagent |
|---|---|---|
| 上下文 | 持续承接用户意图 | 聚焦一个子任务 |
| 适合任务 | 决策、整合、最终修改 | 搜索、审查、调研、独立分析 |
| 风险 | 容易上下文过长 | 容易脱离主目标 |
| 验收方式 | 用户和主会话直接确认 | 主会话必须复核结果 |
所以不要把 Agent 当成“自动完成所有事情”的黑盒。更准确的心态是:你让它去查一块区域、审一个维度、补一类测试,然后主会话负责判断能不能采纳。