@knoYee_: https://x.com/knoYee_/status/2065020276023120302
摘要
Claude Code v2.1.172 新增子 Agent 嵌套能力,最多支持5层嵌套,允许下层 Agent 在遇到复杂子任务时自动生成孙 Agent 分工处理,并介绍了使用场景、配置方法和常见坑点。
查看缓存全文
缓存时间: 2026/06/11 21:45
子 Agent 现在能“生儿子”了?Claude Code 嵌套 5 层实测+详细使用教程
Claude Code v2.1.172 加了一个能力:
子 Agent 可以生成自己的子 Agent。最多 5 层。
Loop Engineering 概念出来不到一周,这个能力就跟进了。
我们需要思考的是这个对于我们来说有什么用,以及该如何使用,接下来,我帮大家拆解一下
一层变多层,变了什么
之前子 Agent 只能一层。
之前的工作流程是:
- 开主会话,主 Agent 拆任务,分给子 Agent。子 Agent 干完,结果送回主 Agent。
问题也随之而来:
- 子 Agent 遇到复杂问题不能再拆,只能自己硬扛,或者丢回给主 Agent 再分。
现在不一样了。
- 子 Agent 干活过程中发现某个子任务自己啃不动,可以自己生一个孙 Agent。
比如安全审查 Agent 发现 12 个第三方依赖包,它不熟悉每个包的漏洞情况。
-
它可以生一个孙 Agent。
-
孙 Agent 专门对照 CVE 数据库逐个检查。跑完之后,把漏洞编号和影响范围报告给子 Agent。
-
子 Agent 再把这部分结果汇总进安全审查报告。
孙 Agent 还能再生一层。
最多 5 层。
-
每层都有明确分工和验收标准。
-
上层的 Agent 当甲方——提需求、验产出、汇总结果。
-
下层的 Agent 当乙方——在窄领域里专做一件事。
什么时候该用,什么时候不该用
嵌套不是免费的。
每多一层,信息传递就多一步损耗。
子 Agent 把孙 Agent 的报告摘要给主 Agent,主 Agent 再摘要给你。
到了第 4 层、第 5 层,最初的细节可能已经丢了大半。
所以判断标准很简单:
任务是树状的,该用。
- 比如代码审查。
主 Agent 审结构,子 Agent 审安全。子 Agent 发现依赖有问题,再生孙 Agent 做依赖审计。
- 比如数据分析。
主 Agent 定方向,子 Agent 写查询。子 Agent 发现数据源有问题,再生孙 Agent 做清洗。
这类任务每一步都可以并行,每个子任务也有独立的验收标准,适合嵌套。
任务是线性的,不该用。
比如改几行代码、查 API 文档、格式化文件。
一层够了,嵌套只会增加延迟。
还有一个更直观的判断方法:
你平时做这个任务,会不会中间需要叫一个专做某事的同事帮忙。
会,就值得嵌套。
不会,一层够了。
怎么配
在 .claude/agents/ 目录下,每个 Agent 一个文件。
一个审查 Agent 的例子:
**你是代码审查 Agent。审查项目结构、代码规范和安全隐患。
当遇到以下情况,生成一个专门的子 Agent:
- 第三方依赖需要安全审计,你不熟悉这些包
- 性能问题需要 profiling,超出你的能力范围
- 数据库查询需要优化专家介入
生成的子 Agent 必须:
- 只做一件窄事
- 带着明确的验收标准,比如“输出每个漏洞的 CVE 编号和影响版本”
- 产出直接返回给你,不交给主 Agent
- 完成后自动销毁**
不用配层数。
Claude Code 自动管,上限 5 层。
一个例子
主 Agent 接到一个 50 文件的 Web 项目审查。
它先拆了三块:
-
代码规范审查给子 Agent A。
-
安全漏洞审查给子 Agent B。
-
性能审查给子 Agent C。
-
子 Agent B 扫描依赖时发现了 12 个第三方包。
-
它判断自己不是每个包都熟悉,于是生了一个孙 Agent。
-
孙 Agent 对照 CVE 数据库逐个检查这 12 个包,发现 3 个有高危漏洞。
-
孙 Agent 把 CVE 编号、影响版本、修复建议返回给子 Agent B。
-
子 Agent B 再汇总进安全审查报告。
子 Agent A 扫到一半,发现项目里混了三种命名风格。
它也生了一个孙 Agent,让它逐个文件标注风格类型,并给出统一建议。
孙 Agent 跑完 50 个文件,返回一份命名规范问题清单。
最后,主 Agent 汇总三个子 Agent 的结果,生成最终审查报告。
你只发了一条指令:
审查这个项目
- 中间的子 Agent 决策、孙 Agent 生成、结果汇总——全是自动的。
两个踩到的坑
第一个,嵌套过程看不见。
主 Agent 告诉你子 Agent 的结果,但不一定告诉你子 Agent 里面生了几层。
如果孙 Agent 的结论错了,子 Agent 可能基于错误结论继续干活。
查问题的时候,要一层层往下翻。
先确认子 Agent 判断对不对,再确认孙 Agent 数据准不准。
第二个,超过 3 层之后,信息压缩太狠。
子 Agent 把孙 Agent 的完整报告摘要成一段话,主 Agent 再摘要成一句话。
5 层链路跑完,最底层的细节可能已经被压缩掉了。
所以 3 层以上的嵌套要自己判断:
摘要传递过来的信息,还能不能支撑决策。
怎么升级
升级到 v2.1.172:
npm update -g @anthropic-ai/claude-code
先在 .claude/agents/ 下建一个审查 Agent。
拿一个有外部依赖的项目跑一次。
重点看三件事:
-
子 Agent 有没有生成孙 Agent。
-
孙 Agent 的产出有没有被正确引用。
-
两层嵌套跑通之后,再往上加。
这也是 Loop Engineering 之后更值得关注的方向,在传统的工作流之上,任务系统自己开始长出组织结构。
相似文章
@0xCodez: https://x.com/0xCodez/status/2058513716509913581
关于使用 Claude Managed Agents 构建多智能体团队的全面指南,涵盖角色设计、模型混合和并行执行,以将团队从1个扩展到20个智能体。
@FinanceYF5: Claude实时生成编排脚本,并行运行大量子agent处理复杂任务。支持Max、Team、Enterprise及API端。 注意:token消耗显著高于普通会话
Claude Code推出动态工作流功能,可实时生成编排脚本并并行运行大量子agent处理复杂任务,支持Max、Team、Enterprise及API端,但token消耗显著高于普通会话。
@GitHub_Daily: 用 Claude Code 做复杂项目,单个 Agent 能力有限,想让多个 Agent 协作分工,但手动配置团队结构和技能文件太繁琐。 最近找到 Harness 这个 Claude Code 插件,一句话描述你的项目,它就能自动生成一整…
Harness 是一个 Claude Code 插件,能根据一句话描述自动生成多 Agent 团队架构,内置 6 种协作模式和 100 套现成配置,帮助 Claude Code 从单兵作战变为团队协作。
@justloveabit: 100个开箱即用的子代理,直接把Claude Code从“助手”升级成“完整AI公司”。 大多数人用Claude Code还停留在“单代理聊天”。 真正的高手,已经在用 100+ 专精Subagents 搭建自己的AI工程团队了。 神级仓…
介绍一个收录了100多个子代理的Awesome仓库,可将Claude Code从单代理助手升级为多代理协作的AI开发平台,并提供了快速上手指南和顶级子代理推荐。
@vincemask: Claude 的高级用法,在于搭建一套能够自动拆解任务、生成提示词、分配角色并审查结果的 Agent 系统。 一套高效的 Claude 工作流通常包括: 1、使用 CLAUDE.md 等文件沉淀长期项目上下文 2、让多个 Agent 分别…
介绍了Claude的高级用法,即搭建自动拆解任务、生成提示词、分配角色并审查结果的Agent系统,包括使用CLAUDE.md等文件沉淀上下文,多Agent协作构建自动化工作流。