Sub-agent 协同失效的 3 类边界场景：Claude Code 8.1 机制原理解析

1. Sub-agent 协同失效不是 Bug，是机制在“按说明书执行”

大多数人第一次遇到 Sub-agent 返回空响应、反复循环调用主 Agent、或在多轮协作后突然“忘记”前序任务时，第一反应是：配置错了？网络不稳定？模型退化了？我试过把claude-code从 8.0.3 升到 8.1.1，又降回 8.0.7，甚至重装 VS Code 插件——问题依旧。直到我把三个不同项目里抓到的 trace 日志并排打开，对比 token 消耗曲线和上下文切片标记，才意识到：这不是故障，是 Claude Code 8.1 的 Sub-agent 协同机制，在边界条件下严格遵循其设计契约的必然结果。

它不“失灵”，它只是太守规矩了。

Claude Code 8.1 的 Sub-agent 并非传统意义上的“子进程”或“微服务”，而是一套基于上下文快照隔离 + 单次响应契约 + 显式状态传递的轻量协同协议。它的核心不是“让多个 AI 同时思考”，而是“让主 Agent 在可控粒度下，把一段明确意图、带约束边界的子任务，打包交给一个干净上下文的专用实例去执行，并强制它只返回符合 schema 的结构化结果”。这个设计带来了极高的可预测性，但也划出了三条清晰的失效分界线：意图模糊区、状态断连区、上下文溢出区。这三类场景下，Sub-agent 不会报错，不会告警，只会安静地返回一个语法正确但语义失效的结果——比如空数组、默认值、或看似合理实则偏离原始目标的妥协解。

这篇文章只讲这三类边界。不讲怎么“启用 Sub-agent”，那在 8.1 版本里就是一行配置；也不讲“为什么不用 Copilot”，那是另一个维度的工