Claude Code 子智能体:什么时候用,怎么设置
更新于 2026-11
TL;DR: Claude Code 子智能体是专门接手某类任务的 AI,每个都有自己的上下文、指令和工具,完成后只返回摘要。想并行推进互相独立的工作时最好用;不要把设计方案像接力传水桶一样在子智能体之间传递。

Claude Code 官方文档子智能体页面的截图。
Claude Code 子智能体是什么?
Claude Code 子智能体是作为某类任务专家来工作的 AI。截至 2026 年 11 月,官方文档说明每个子智能体都在自己的上下文窗口中运行,有自定义的系统提示词和特定的工具权限。它们让主对话保持干净,完成后只返回摘要,1 个长对话不再需要装下所有东西。
给 AI 加了各种功能之后,提示词可能变得巨大,运行也不稳定了。是什么原因呢?
那是因为你把设计、开发、测试全都塞给了一个 AI。就算是人,也不可能一个人把所有事都做得完美。关键是用子智能体的思路来分工。
确实,就像组建一支专注特定任务的专家团队。
处理的准确性和可维护性都会大幅提升。
每个 AI 都能专注于自己的任务,那种听起来很像真的幻觉也会减少。这就是把工作拆细。
适合用子智能体的 3 种场景
适合用子智能体的场景,是那些交给单个智能体容易混乱的工作。2026 年 11 月的一段讲解视频提到两个主要情况:想并行推进互相独立的工作时,以及 MCP 工具、技能或指令多到单个智能体难以选择时。每一步都依赖上一步的工作则不适合。
第三种是单个智能体难以解决工具选择或指令冲突的时候。
当可用的 MCP 工具、子智能体或技能很多时,单个智能体很难正确地区分和调用。这时就把职责拆开,把那部分工作交给子智能体。
不管怎样,最主要的是第二种:想并行推进独立的工作时使用。
不过要注意,即使是制定设计方案这种独立工作,也应该避免像接力传水桶那样在子智能体之间一个传一个。
怎么创建子智能体
创建子智能体,就是写一个 Markdown 文件。截至 2026 年 11 月,官方文档的写法是:顶部写 YAML 设置(name、description、tools、model),下面写系统提示词;只给当前项目用就放在 .claude/agents/,所有项目都用就放在 ~/.claude/agents/。你也可以直接让 Claude 帮你写,再按自己项目的需要修改细节,改完几秒内就会生效。
只要给每个智能体明确的角色和完成标准,复杂的项目也能顺利完成。
比技术能力更重要的,是你能把人的工作流程描述得多具体。
先把工作可视化,理清哪些部分交给子智能体。用积累小成功的心态,先从简单的 2 个智能体配置开始。
并行运行:编排者和执行者
编排者-执行者模式是一种工作方式:主智能体负责规划,把任务分给多个子智能体并行执行。2026 年 11 月的讲解把它介绍为一种既能缩短工作时间、又能扩大覆盖范围的方法。只要用自然语言提出请求就能启动,不需要特殊语法,也不需要额外的配置文件。
然后从这里扇出子智能体并行启动,让它们从不同角度并行工作。
这样既能缩短工作时间,又能扩大工作范围。同时让主智能体尽量不做具体执行,而是专注于设计和上游环节。
直接用自己的话把给子智能体的请求打进输入框就行。
如果你说“用 30 个子智能体做这 30 个任务”,它就会照做。你在对话的智能体是父智能体。子智能体就像它生出来、派去干活的孩子。

讲解如何把工作交给专门子智能体的视频画面。
子智能体和顾问的区别
顾问是让 Claude 在任务的关键时刻请教更强模型的功能。截至 2026 年 11 月,官方文档把它列为实验性功能,通过 /advisor 命令设置。很多人把它和子智能体混为一谈,但两者看到的内容和做的事情都不一样,下面这位创作者在一段短视频里讲得很清楚。
顾问会读完整个对话。但它不动手,只返回建议。
常会请教顾问的时机有 3 个:决定做法之前、同一个错误反复出现时、宣布完成之前。什么时候请教由 Claude 决定。
顾问看的是整个对话,子智能体只看委托内容。
另一个区别是做的事。顾问只动嘴,子智能体包揽整件工作。任务越长,记得整个对话的顾问越有用。查资料交给子智能体,拿不准的决定交给顾问。
用 Pachat 多加一个视角
Pachat 是一个网页产品,网址是 pachat.ai,官网的介绍是“Different personal AI agents, in one group chat.”子智能体是在一个工具内部分工,而 Pachat 是让不同 AI 回答同一个问题的地方。
- 写下你的子智能体设计,或任务拆分方案。
- 打开 pachat.ai,把你的 Claude、Grok Bot、Muse 和 ChatGPT 小圆点拉进同一个群聊。
- 贴上方案,问拆分是否合理。它们会互相核对事实、争论到底,最后由你拍板。
延伸阅读:Claude Code 使用指南、Claude Code 智能体团队 和 Claude Code 远程控制。
常见问题
子智能体和智能体团队有什么区别?
子智能体在单个会话内工作,完成后只把摘要返回主对话。截至 2026 年 11 月,官方文档建议:需要多个会话互相沟通、协同时用智能体团队;需要彼此独立、并行运行的会话时用后台智能体。子智能体本身则适合一次性的专门任务。
Claude Code 子智能体保存在哪里?
它们是 Markdown 文件。只给当前项目用就放在 .claude/agents/,所有项目通用就放在 ~/.claude/agents/。截至 2026 年 11 月,Claude Code 会监视这些文件夹,修改几秒内生效,不用重启。团队使用时,把项目文件夹提交到版本控制,大家就能用同一套子智能体。
/agents 命令还能用吗?
截至 2026 年 11 月,文档说明 v2.1.197 及更早版本的 /agents 会打开交互式创建界面,新版本则会提示你直接让 Claude 创建,或手动编辑 .claude/agents/。最简单的做法是对 Claude 说“创建一个只读的代码审查子智能体”,让它帮你写文件。
能限制子智能体使用哪些工具吗?
可以。在 YAML 的 tools 字段里只列出允许的工具,比如 Read、Grep、Glob,就得到一个只读子智能体。官方文档还介绍了 3 个内置子智能体:用于快速只读搜索的 Explore、用于规划的 Plan,以及用于多步骤工作的 General-purpose。2026 年 Explore 是只读的那个。
一次能同时运行多少个子智能体?
把工作拆成互相独立的任务,就能并行运行多个。2026 年 10 月的一段视频演示了直接用自然语言说“用 30 个子智能体做这 30 个任务”。但并行的工作要彼此独立,避免每个子智能体都要等上一个结果的接力式用法。
Pachat 能帮我设计子智能体吗?
可以。Pachat 是网页产品,网址是 pachat.ai,你可以把自己的 Claude、Grok Bot、Muse 和 ChatGPT 小圆点放进同一个群聊。把子智能体的分工方案贴进去,让 3 个以上的 AI 找出遗漏或重叠。它们会互相核对事实、争论到底,最后由你拍板。
想把不同的 AI 放进同一个群聊?从 pachat.ai 开始。
References
- Claude Code Docs, "Create custom subagents," fetched 2026-11-18: https://code.claude.com/docs/en/sub-agents
- Claude Code Docs, "Escalate hard decisions with the advisor tool," fetched 2026-11-18: https://code.claude.com/docs/en/advisor
- @kee11nig, 2025-07-30: https://x.com/kee11nig/status/1950352602660520410
- @akalink_soma, 2026-04-27: https://x.com/akalink_soma/status/2048561651532837346
- @papaneco_life, 2026-10-01: https://x.com/papaneco_life/status/2105642379437060530
- @starriver0513, 2026-10-29: https://x.com/starriver0513/status/2115763904882032831
- @msyn_ai, 2026-11-07: https://x.com/msyn_ai/status/2119091969737855382
- @msyn_ai, 2026-11-12: https://x.com/msyn_ai/status/2120762814990340136



