type
Post
status
Published
date
Oct 14, 2025
slug
claude-code-advanced-sub-agents-vibe-coding-01-9d6w5w
summary
📌 来自：faafospecialist.substack.com (Substack) | 💡 子智能体不是直接听你的，而是听“老大”的。
本文是“Vibe Coding（氛围编程）”系列的第一篇，深入探讨了 Claude Code 中 Sub-agents（子智能体）的工作原理。作者通过实战经验指出，理解 Main Agent（主智能体）与子智能体之间的层级委派关系是核心，并详细分析了配置 Sub-agents 时的常见误区、优缺点以及在实际开发中如何避免 Token（令牌）浪费。 | 🔑 关键词：Substack、faafospecialist.substack.com、FA&FO | 🤖 由Gemini 3 Flash (Google API)分析生成
tags
Substack
faafospecialist.substack.com
FA&FO
category
Substack文章
icon
📰
password
本文是对 faafospecialist.substack.com (Substack) 的学习笔记。所有观点归原作者所有，建议阅读原文获取完整内容。
💡 子智能体不是直接听你的，而是听“老大”的。
本文是“Vibe Coding（氛围编程）”系列的第一篇，深入探讨了 Claude Code 中 Sub-agents（子智能体）的工作原理。作者通过实战经验指出，理解 Main Agent（主智能体）与子智能体之间的层级委派关系是核心，并详细分析了配置 Sub-agents 时的常见误区、优缺点以及在实际开发中如何避免 Token（令牌）浪费。
作者：Goon，发布于 2025 年 8 月 3 日。
我计划记录并分享在为 DevPocket.app 应用进行 Vibe Coding（氛围编程）过程中使用 Claude Code 的所有经验！之所以称之为 Vibe Coding，是因为我只专注于下达指令，不再过多地审查代码——虽然不知道这最终会产生什么结果。
DevPocket.app —— 是时候丢掉笔记本电脑，在口袋里写代码了！这个系列预计会有 8 篇文章：
[VB-01] 在 Claude Code 中使用 Sub-agents（子智能体）的第一步
[VB-02] 关于 Claude Code 工具集的一切
[VB-03] Vibe Coding 时如何写 Prompts（提示词）
[VB-04] 子智能体从基础到深度探索： 我错了！
[VB-05] “欺骗”子智能体： 优化 System Prompts（系统提示词）！
[VB-06] Commands（命令）与 Hooks（钩子）—— 提高 Claude Code 效率
[VB-07] 优雅地进行 UI 的 Vibe coding？
[VB-08] 用于销售与营销的 Claude Code
今天我们将介绍在 Claude Code 中使用 Sub-agents（子智能体）的第一步——你自己的 Agent（智能体）团队，每个智能体都专注于不同的任务。这是 Claude 一个非常强大的功能，但正如我在前一篇文章中提到的，有效地利用它确实并不简单。
在本文中，我们将根据我的个人经验，剖析如何构建有效的子智能体并避免最常见的错误。
（*）特别说明：我在文章末尾有重要的侧记！感谢阅读！欢迎免费订阅以接收新文章并支持我的工作。
1. Sub-agents（子智能体）是如何工作的？正确理解信息流
这是许多人经常跳过或不知道的最重要的部分（包括我，嘿嘿）。
始终从 Main Agent（主智能体/智能体组长）开始，向项目中的其他智能体委派任务。
子智能体的工作流程并不是直接从它们到你，而是一个 Delegation（委派）链：
你向 Main Agent（主智能体）发出指令（Prompt）。
Main Agent 根据你的指令，决定并指挥合适的 Sub-agents（子智能体）。
Sub-agents 独立运行以执行任务。
完成后，Sub-agents 将结果汇报给 Main Agent。
最后，Main Agent 整合信息并汇报给你。
核心点：子智能体不直接与你交流，它们只与 Main Agent 交流。误解这一点会导致写错 Prompts（提示词）、弄错工作流，并且无法达到预期效果。
它们的工作流程需要有清晰的 Delegation hierarchy（委派层级）。例如，当我第一次尝试时，我立刻创建了 2-3 个智能体，但在输入指令时，根本没看到任何智能体被召唤。事实证明，你需要先创建一个 Main Agent（就像一个领导），然后编写 System Prompt（系统提示词）以便能够召唤它来分配工作，之后它才会向下委派给团队中的智能体去工作。
注意：智能体之间并不共享 Memory（记忆），它们在独立的 Sessions（会话）中工作，只有在任务完成后才会汇报。这导致在 Claude Code 中使用 Sub-agents 会消耗相当多的 Tokens（令牌），比以前直接使用 Claude Agent 要多得多。
注意：花时间仔细阅读 Anthropic 的 User guide（用户指南），不要只是把它喂给 AI 进行总结，或者直接喂给 Claude Code 让它去用。我们需要理解“问题的本质”才能有效地应用它。
2. 我在处理 Sub-agents 时犯的两个错误
由于对上述信息流的误解，我们经常会犯这两个大错：
错误一：没意识到 /.agent 文件中的内容是 System Prompt（系统提示词）
你在子智能体的配置文件中（例如 `.agents/hello-world`）所写的内容不是 User Prompt（用户提示词）。它是 System Prompt（系统提示词）——定义了角色、目的、核心行为以及何时应该被激活。
错误二：指示子智能体向错误的受众做出响应
因为子智能体是向 Main Agent 汇报的，所以你必须指示它如何与其“上级”沟通。例如，在子智能体的提示词中，不要写“请回复用户...”，而应该写：“嘿 Claude（主智能体），请将以下内容回复给用户...”。这有助于 Main Agent 理解信息并准确地将其转达给你。
3. Sub-agents（子智能体）的优缺点
优点
Context preservation（上下文保留）： 如上所述，智能体不共享记忆，每个子智能体在自己的 Context window（上下文窗口）中运行，虽然消耗更多令牌，但这也有好处——它不会“污染”你的主对话。在处理大型且复杂的 Codebases（代码库）时，这非常有用。
Specialization（专门化）： 你可以为每个特定任务创建极其专业的智能体（例如，专门用于重构代码的智能体、专门用于编写测试的智能体等）。
Reusability（可复用性）： 一旦创建，你可以在许多不同的项目中重复使用这些智能体。
Permission control（权限控制）： 你可以限制子智能体允许使用的 Tools（工具），从而增强安全性。
High focus（高度聚焦）： 因为它们只做一件事，子智能体不太可能产生 Hallucinate（幻觉）或犯错。
缺点
Context isolation（上下文隔离）： 这是上述优点的反面。因为没有对话历史，Main Agent 必须在单个命令中提供所有必要的信息。
难以调试： 子智能体的内部工作流被抽象成了通知消息。当它们结束时，所有活动都会消失，这使得查找和修复错误变得更加困难（你不能一直坐在那里盯着屏幕看它们在做什么）。
Choice overload（选项过载）： 当你拥有过多的子智能体时，Main Agent 可能会对该调用哪个智能体感到“困惑”。编写清晰准确的描述极其重要。
Dependency Coupling（依赖耦合）： 如果你创建了一连串相互依赖结果的智能体，更改一个智能体可能会破坏整个链条。
任务处理时间非常慢： 就像组织的运作方式一样，笨重的系统意味着漫长的处理时间，因为必须经过许多审批层级——有些任务可能需要长达一小时。甚至超过一个小时（还没完成！）。
结论
Sub-agents（子智能体）是一个极其强大的功能，开启了编程自动化的新纪元。它允许我们以有组织的方式构建复杂的多智能体系统。未来，其他 AI 系统（非编程领域）也将拥有类似的运作方式。
掌握这项技术的关键是理解信息流并以 Delegation（委派）的思维思考。不要只是分配任务，要告诉你的智能体如何工作以及如何汇报。
个人观点（我在开头提到的特别侧记，嘿嘿）
阴谋论（提醒：这是我的个人观点——纯属娱乐——别太当真）：“我觉得子智能体的创造……只是为了让我们消耗更多的美元 Tokens，哈哈。”
并不是每个任务都需要使用子智能体！为什么？再读一遍上面的“缺点”部分。对于小任务，直接向 Claude Code 发送指令以加快处理速度并节省令牌。只对具有复杂处理流程的困难任务使用智能体。不要杀鸡用牛刀。
最后，这个 Vibe Coding 系列的第一篇文章本应该从最基础的东西开始，但因为大家对 Sub-agents 话题非常感兴趣，所以我先写了它。在未来的文章中，我将写更多关于使用 Sub-agents 的高级技巧和有效使用的 Tricks（技巧）（*）。
但请记住：并不是每个任务都需要使用子智能体！并不是每个任务都需要使用子智能体！并不是每个任务都需要使用子智能体！（重要的事情说三遍）。
（*）Facebook 上的朋友开玩笑说我经常分享 Tricks（技巧）。所有这些技术和工作流都已预先配置好，可以在 ClaudeKit（ClaudeKit.cc）中直接使用。
📌 关键收获
对 Grace 的启示
**管理思维的转变**： 把 Sub-agents 看作是你的“外包团队”。在独立站运营中，你可以模仿这种结构：一个 Main Agent 负责整体营销策略，下设专门负责 SEO、文案创作、广告投放的子智能体。记住，你只管“项目经理”（Main Agent）。
**成本与效率的权衡**： Vibe Coding 虽好，但 Token 消耗极快且速度慢。对于简单的 CSS 修改或文案微调，直接在主对话框完成；只有涉及复杂的系统重构或多文件联动时，才启动子智能体。
**汇报机制的优化**： 在写 AI 工作流（Workflow）时，明确“谁向谁汇报”。给子智能体的指令要包含“如何向主智能体反馈”，这样能显著减少 AI 逻辑混乱导致的报错。
并不是每个任务都需要使用子智能体。
想了解更多细节？ 查看原文 →
- Author:EcomGrace
- URL:http://ecomgrace.com/article/claude-code-advanced-sub-agents-vibe-coding-01-9d6w5w
- Copyright:All articles in this blog, except for special statements, adopt BY-NC-SA agreement. Please indicate the source!
