English | 中文

御舆：解码 Agent Harness

Claude Code 架构深度剖析

"一器而工聚焉者，车为多。" ——《考工记》

两千年前，造一辆马车是最复杂的系统工程：舆承载乘者，辕定方向，辐传动力，軎辖为约束——每个构件各司其职，合而为一，车方能行。

今天，构建一个 AI Agent 亦是如此：对话循环为辕，工具系统为辐，权限管线为軎辖，而将这一切承载于其上、使智能体真正运转的运行时框架—— Agent Harness——正是那个舆。

古人御舆，驾驭的是天地之间最精密的机械；今人御舆，驾驭的是硅基时代最复杂的智能体系统。

本书因此得名 舆书。

当所有人都在教你怎么 用 AI Agent——这本书带你拆开它。

---

对话循环如何驱动？工具权限为何是四阶段管线？上下文压缩怎样在 token 预算内运转？子智能体如何通过 Fork 继承父级上下文？

读懂 Claude Code 的设计决策，你就拥有了一套可迁移到任何 Agent 框架的心智模型。

---

这本书有什么不同

不做使用教程，不列 Prompt 技巧。

市面上充斥着"如何写好 Prompt"和"如何调用 Agent API"的指南。但如果你想知道一个生产级 Agent 系统的骨架是怎么搭的——几乎没有资料可查。这本书填补了这个空白。

特色	说明
架构分析而非 API 文档	不讲"怎么调用"，讲"为什么这样设计"——追溯动机、分析权衡、指出反模式
设计哲学而非使用教程	从异步生成器到断路器模式，每章提炼可迁移的设计原则
可迁移的认知模型	无论你用 LangChain、AutoGen、CrewAI 还是从零构建，书中 139 张架构图直接复用

书中的数据一览

指标	数量
全书字数	42 万字（中文）/ 75K+ words（English）
正文章节	15 章 + 4 篇附录
Mermaid 架构图/流程图/状态机	139 张
覆盖核心子系统	工具系统、权限管线、上下文压缩、记忆系统、钩子系统、子智能体调度、MCP 集成、技能插件、流式架构、Plan 模式
分析的设计决策	50+ 个"为什么这样设计"
术语条目（中英对照）	100 条
功能标志	89 个
注册工具	50+ 个

声明： 本书基于对 Claude Code 公开文档和产品行为的架构分析编写，未引用、未使用任何未公开或未授权的源码。Claude Code 为 Anthropic PBC 产品，本书不隶属于、未获授权于、也不代表 Anthropic。

---

快速导航

时间紧张？ 01 → 02 → 04 → 15，拿到核心认知和动手能力就够用

有经验？ 直接读 Part 2 + Part 3，遇到概念缺口回溯 Part 1

系统学习？ 从头到尾，每章做练习，最后 Ch15 构建自己的 Harness（约 2–3 周）

查资料？ 直接翻 附录 A（模块定位）/ B（工具）/ C（功能标志）/ D（术语）

---

目录

Part 1. 基础篇 — 建立心智模型

理解 Agent 编程的范式转移，建立对 Agent Harness 的整体认知框架。

#	章节	核心内容
01	智能体编程的新范式	Copilot → Claude Code 演进；Agent Harness 五大设计原则；Bun + React/Ink + Zod v4 技术栈
02	对话循环 — Agent 的心跳	while(true) 异步生成器主循环；五种 yield 事件；十种终止原因；QueryDeps 依赖注入
03	工具系统 — Agent 的双手	Tool 五要素协议；buildTool 故障安全工厂；45+ 工具 × 12 类；并发分区贪心算法
04	权限管线 — Agent 的护栏	四阶段管线；五种权限模式谱系；Bash 规则匹配；推测性分类器 2 秒 Promise.race

Part 2. 核心系统篇 — 深入子系统

拆解 Agent Harness 的四大核心子系统——配置、记忆、上下文、钩子。

#	章节	核心内容
05	设置与配置 — Agent 的基因	六层配置优先级链；合并规则；安全边界与供应链攻击防御；双层功能门控
06	记忆系统 — Agent 的长期记忆	四种封闭式记忆类型；"只保存无法推导的信息"；MEMORY.md 索引；Fork 记忆机制
07	上下文管理 — Agent 的工作记忆	有效窗口公式；四级渐进压缩（Snip→MicroCompact→Collapse→AutoCompact）；断路器模式
08	钩子系统 — Agent 的生命周期扩展点	五种 Hook 类型；26 个生命周期事件；JSON 响应协议；六层优先级；三层安全机制

Part 3. 高级模式篇 — Agent 的组合与扩展

探索 Agent 如何组合、编排和扩展——从子智能体到 MCP 协议桥接。

#	章节	核心内容
09	子智能体与 Fork 模式	三种 Agent