Claude Code Subagent Patterns
五种经过实战检验的克劳德代码子代理模式——并行研究、隔离工作树、专家委托、上下文保护和管道编排——具有生产使用的true实提示和权衡。
- Claude Code
- Agent SDK
- CLI
- Bash
- Proprietary
- 更新于 2026-05-29
—
- 代理（“查找身份验证处理程序”，subagent_type =“探索”，prompt ="…"）
- Agent(“地图状态管理”, subagent_type=“探索”, Prompt="…")
- Agent（“查找已弃用的 fn Z 用法”，subagent_type =“探索”，prompt ="…"）
**它避免了故障模式。** 上下文窗口膨胀。 你的父母保持轻松，可以进行实际的实施对话。**权衡。** 您需要为三个子代理调用付费，而不是为一次父代理对话付费。 对于重要的搜索，数学获胜——探索子代理在许多工具中展开并仅返回综合答案。## 模式 2：工作树隔离风险编辑**问题。** 您希望子代理尝试重构，但如果它出现问题，您不想手动"git reset --hard"。 您还希望子代理能够运行测试而不干扰主工作树中的活动更改。**模式。** 在代理调用上使用工作树隔离参数。 子代理在从当前状态分支出来的临时 git 工作树中运行。 如果发生更改，您将返回工作树路径，并可以在闲暇时进行审查、挑选或丢弃。 如果不进行任何更改，工作树将自动清理。代理({ description: “尝试控制器级重构”， 隔离：“工作树”， 提示：“重构controllers/orders.rb以提取验证逻辑……” })**它避免了失败模式。** 半成品重构会污染你的工作树代理({ description: “尝试控制器级重构”， 隔离：“工作树”， 提示：“重构controllers/orders.rb以提取验证逻辑……” })因为无论如何你都必须合并回来。 将此保留用于探索性或有风险的更改。## 模式 3：专家代表团**Problem.** Code review, security audits, accessibility audits, and SQL query optimization all benefit from a focused mindset that's hard to maintain when you're also writing the feature. Generic Claude is good at all of these, but specialized prompting is better.**模式。** 使用 `subagent_type` 参数委托给专家。 "代码审查者"子代理读取差异并以置信度报告结果。 安全审核员戴着威胁建模眼镜读取相同的差异。 您可以留在父母的对话中来构建该功能。```` 代理({ description: "独立代码审查"， subagent_type: "代码审阅者", 提示："查看分支功能/支付网关的更改。我想要第二个 关于重试逻辑的意见 - 我已经检查了幂等性，但想要 独立验证。 报告：在并发故障下这安全吗？" }) ````**它避免了失败模式。** "我写了它，所以它一定是正确的"盲点。 没有上下文的单独代理``` 代理({ description: "独立代码审查"， subagent_type: "代码审阅者", 提示："查看分支功能/支付网关的更改。我想要第二个 关于重试逻辑的意见 - 我已经检查了幂等性，但想要 独立验证。 报告：在并发故障下这安全吗？" }) ```父上下文充满了堆栈跟踪、日志转储和死胡同false设分支。 你需要"去检查一些东西"，需要读取8个文件。 内联执行此操作将使您陷入压缩，并且您将失去将调试状态保持在一起的承载上下文。**模式。** 将您的父会话视为战略层，并将每次探索性潜水推送给子代理。 家长说"找出 X"——子代理返回"答案是 Y，这是单行证据"。 您的调试状态保持不变。这是收回成本最快的模式。 当探索被卸载时，在第 1 小时就达到上下文压缩的两小时调试会话可以在整个持续时间内干净地运行。**它避免了故障模式。** 调试过程中过早的上下文压缩，这通常会丢弃原始症状或关键再现步骤。**权衡。**您失去了"看到"探索的能力。 如果子代理的报告不完整，您必须生成另一份具有更严格提示的报告，而不是询问后续情况。## 模式 5：使用自定义代理进行管道编排**问题。** 您的团队有一份包含八个步骤的书面审核清单。 初级工程师在匆忙时会跳过步骤 3、5 和 7。 您希望执行清单，但又不想成为公关审查警察。**模式。** 将清单编码为存储库中的自定义子代理。 任何安装了 Claude Code 的人都可以调用它。 检查表变得可执行：它针对每个步骤生成结构化报告。```` .claude/agents/migration-reviewer.md # 自定义子代理定义 .claude/agents/security-gate.md .claude/agents/perf-budget-checker.md ````当团队成员运行协调器时，它可以扇出到所有三个：迁移审核器审核 SQL、安全门审核身份验证接触、性能预算检查器审核接触请求热路径的任何内容。 每个都会返回一份结构化报告。 协调器聚合。**它避免了失败模式。** 在"团队的审查标准"和"当有人匆忙时实际检查的内容"之间漂移。**权衡。**自定义代理是版本控制的工件。 它们像任何其他代码一样需要维护。 安排季度审查，否则就会烂掉。## 基本原则五个都``` .claude/agents/migration-reviewer.md # 自定义子代理定义 .claude/agents/security-gate.md .claude/agents/perf-budget-checker.md。 父级是模型进行重要思考的地方。 子代理是它获取输入而不用从工作记忆中支付费用的方式。这与 2024 年至 2025 年初主导的"一个超级代理人包揽一切"本能相反。这种模式在环境压力下崩溃了。 2026 年的答案是委托专业化和严格的信息边界——一个小委员会而不是一个人。## 设置生产就绪的 Claude 代码要大规模运行多代理工作流程，您需要三部分基础设施：1. A reliable host for long-running sessions. If you’re running Claude Code in CI or against a server-side codebase, you need a VPS that won’t drop your SSH session or get throttled. HTStack — Hong Kong VPS with low-latency access from mainland China and stable BGP routing. Same IDC that hosts dibi8.com, so we run our own multi-agent pipelines on it. Solid value tier for $5-12/month.2. 用于并行实验的云游乐场。 当您扇出 6 个以上的子代理（每个子代理都需要自己的工作树）时，您需要备用 CPU。 DigitalOcean — 跨越 14 个以上全球区域的 60 天 200 美元免费赠金。 独立开发者使用它来托管 Claude Code 编排器以及他们的主应用程序，而不会出现资源争用。3. 技能包。 如果您是 Claude Code 子代理的新手，那么曲线最陡的部分是编写不会失败的自定义代理定义。 我们在 Gumroad 上将五项经过实战考验的技能打包为 19 美元的捆绑包（请参阅角落里浮动的 CTA），其中包括提供上述模式的协调器提示。## 相关阅读- OpenAI Codex CLI vs Claude Code — How Codex’s solo-agent approach compares to Claude Code’s subagent model. - Gemini CLI 与 Claude Code — Gemini 的并行研究策略与 Claude Code 子代理扇出。
- Cursor vs Claude Code — IDE 嵌入式代理与 CLI 驱动的协调器。
- MCP Servers 2026 Rankings — How MCP servers extend subagent capability beyond the bundled tool set.
- AI Coding Agent Landscape — The broader ecosystem picture.## 判决到 2026 年，子代理将不再是可选的。如果您仍然在单个 Claude 对话中完成所有任务，那么您就要为过早的上下文压缩和丢失推理状态的特权付出代价。 上述五种模式——并行扇出、工作树隔离、专家委派、上下文保护、管道编排——每种模式的学习成本大约为一个小时，并且每种模式每周可以节省数倍的时间。从模式 1（并行研究扇出）开始——这是最低摩擦的采用点，并且收益是立竿见影的。 当你的训练时间越来越长、任务越来越重时，就可以将其他任务分层进行。“继续在主会话中输入内容"的本能很难消失。 覆盖它。 生成子代理。
💬 留言讨论