Brain-Hands 解耦

定义

Brain-Hands 解耦是 Claude Managed Agents 的核心架构原则：把 Agent 系统拆成三个可独立失败、可独立替换的部分——"大脑"（Claude + harness，负责推理与决策）、"双手"（sandbox 与工具，负责执行）、"会话"（append-only 事件日志，负责状态持久化）。三者通过稳定接口通信，任何一侧崩溃或替换都不必拖累另外两侧。

要点

• Harness 离开容器：调用 sandbox 变成 execute(name, input) → string，容器成为 cattle——挂了就重建
• Harness 本身也成为 cattle：状态存在 session 里，崩溃后 wake(sessionId) → getSession(id) 即可恢复，从最后一个事件继续
• 安全边界重构：凭证永远不进入 Claude 可读的沙箱（Git token 仅在初始化时写 remote；MCP 走 vault + proxy，harness 也不知情）
• 性能收益：containers 按需 provision，不再给每个 session 付启动税—— p50 TTFT 下降约 60%，p95 下降超 90%
• 横向 scaling 从"起 N 个重容器"变成"起 N 个无状态 harness，需要时再连 hands"
• 因为 hands 不绑定 brain，brain 之间可以互相传递 hands，为多 Agent 协作提供结构基础

示例

紧耦合早期版本所有组件共享一个容器，文件编辑是 syscall、没有服务边界；代价是容器变成"宠物"：挂了 session 全丢，卡住了无法区分 harness bug、丢包、容器离线，shell 进去调试又会撞上用户数据。客户要连自己 VPC 时，只能 VPC peering 或把 harness 部署到客户环境。解耦之后，这些问题被接口吸收：容器死亡被 harness 捕获成一次 tool-call 错误回传给 Claude；客户资源通过远程 execute 调用即可接入，不再需要网络 peering。

相关概念

• Claude Managed Agents
• Meta-Harness
• Agent Runtime Protocol
• Pets vs Cattle
• Session as Context Object
• Agent Harness
• 工作记忆与完整会话
• 接口厚度
• GAN式多Agent架构
• hermes-agent架构与对比分析〔待补〕
• Harness 嵌合体性 - 解耦是嵌合体薄接口侧的工程化操作
• Harness 与控制论的关系〔待补〕 - 揭示其本质是把控制论拓扑工程化

参考资料

• Scaling Managed Agents: Decoupling the brain from the hands