Claude Code 设计解析
反向拆解 Claude Code 这个范例级 agent harness,沉淀可迁移到自研 agent 的设计原则。
概述
所有读者:把 Claude Code 当作范例级 agent harness 反向拆解——提取可迁移到自研 agent 的设计原则。
系统提示词组装
Agent 系统作者:Claude Code 的系统提示词是 20 段注册表 + 显式静态/动态边界的装配件。拆开它,看真实代码里的分层是怎么做的。
上下文压缩
Agent 系统作者:Claude Code 的压缩不是一个函数,是五级流水线——microcompact、session memory、auto-compact、reactive、context collapse,各自解决不同问题。
记忆系统
Agent 系统作者:Claude Code 的记忆在源码里是 6 种文件类型 × 4 种内容类型 × 3 种 agent 持久化 scope——拆开看每一层的职责和实现。
Agent 运行循环
Agent 系统作者:一次 Claude Code 对话到底发生了什么——query async generator、每轮 14 步流水线、StreamingToolExecutor、重试 / 恢复 / 熔断路径,全部源码级还原。
权限系统
Agent 系统作者:Claude Code 的权限系统是 7 种 mode × 8 种规则来源 × 11 种决策理由 × 10 种 hook 事件——拆开每一层的源码实现。
执行环境
Agent 系统作者:Agent 实际在哪台机器的哪个目录跑?Claude Code 的 3 种隔离模式(none / worktree / remote)+ 跨平台进程沙箱 + CCR 云端架构。
设计启示
Agent 系统作者:前面几章源码级观察抽出的 10 条跨主题原则,每条绑定到具体源文件——这是一张可以直接评估自研 agent 的检查表。
应用到自研 Agent (AI SDK)
Agent 系统作者(AI SDK 用户):用 AI SDK 构建 agent 时,前 8 章的原则落到 8 个嵌入点的哪一行。本章以 Zapvol 为具体 case 做现状评估 + 演进方向标注。
生命周期状态流
Agent 系统作者:8 个嵌入点不是 8 个独立的 hook——它们共享一套跨步、跨轮、跨 session 的状态。本章按状态流切一刀,追踪一次对话里每条 state 怎么流动。