AI 原生开放教材

外观

Harness Books工程手册·中文原文 ↗原件 ↓仓库 ↗

Harness Books / 驾驭工程 ​

English README

两本关于 Harness Engineering 的书。它们追问同一个工程问题：一个会写代码的模型进了终端、仓库、权限系统和团队流程，系统凭什么还能保持边界、连续性和后果控制。

Harness Engineering：Claude Code 设计指南
Harness Engineering：Claude Code 设计指南
在线阅读 · [PDF 下载](https://harness-books.agentway.dev/book1-claude-code/exported/book1-claude-code.pdf) 		Claude Code 和 Codex 的 Harness 设计哲学
Claude Code 和 Codex 的 Harness 设计哲学
在线阅读 · [PDF 下载](https://harness-books.agentway.dev/book2-comparing/exported/book2-comparing.pdf)

这两本书不打算把源码拆成零件逐条讲解。它们关心的是 harness 怎样组织约束与执行，怎样把一个本质上不稳定的模型，收束进可持续运行的工程秩序里。Prompt 分层、Query Loop、权限判定、上下文治理、失败恢复、多 agent 验证、本地规则和团队制度，合在一起才构成 harness 的器官系统。工程里最怕的事，不是模型偶尔犯傻，而是系统对后果毫无准备。

核心判断 ​

  • Harness Engineering 讨论的是约束结构怎样组织执行。
  • 一个会写代码的模型进入真实工程环境以后，主要问题不再是回答质量，而是行为后果。
  • Prompt、工具、权限、状态、恢复、验证和制度，不是外围配件，而是同一套控制结构的不同器官。
  • 比较不同 agent 系统，重点不该是功能表，而该是秩序被安放在哪一层。
  • 一个团队如果不能把个人经验沉淀成可复用制度，就很难把 agent 变成稳定系统。

两本书，各自关注的核心问题 ​

第一本：Claude Code 设计指南 ​

第一本书拿 Claude Code 当观察对象，重点放在运行时骨架上。它关心的是，一套系统为什么最终必须长出控制面、Query Loop、工具权限、上下文治理、恢复路径、多 agent 验证和团队制度这些结构。

如果你更关心这些问题，建议先读第一本：

  • 为什么 Harness Engineering 不是 Prompt Engineering 的放大版
  • Prompt 为什么本质上是控制面，而不是聊天输入框
  • 模型犯错为什么应该被视为运行时常态，而不是异常事件
  • 多 Agent 和验证机制为什么不能混成一团
  • 团队怎么把个人经验固化成可复用的工程制度

第二本：Claude Code 与 Codex 比较书 ​

第二本书把 Claude Code 和 Codex 放在一起，关注的是两套 harness 各自把秩序安放在哪一层。有人更从运行时纪律出发，有人更从结构化控制层出发；系统都能运转，权力分配方式却并不一样。

如果你更关心选型、架构判断或自己做系统时该学谁，建议读第二本：

  • Claude Code 和 Codex 在控制面设计上最大的分歧是什么
  • Query Loop、Thread、Rollout、State 的职责边界怎么对齐来看
  • 权限、沙箱、策略语言各自承担什么治理角色
  • 技能、Hook、本地规则怎样把“组织习惯”写进系统
  • 如果要自己做 harness，应该先学谁、先学哪一层

建议阅读路径 ​

  • 想先建立完整框架 → 先读第一本，再读第二本。
  • 已经熟悉 agent coding 工具，想直接看架构分歧 → 先读第二本。
  • 只关心结论 → 第一本“第 9 章 十条原则” + 第二本“第 7 章 殊途同归，还是各表一枝”。
<details> <summary><strong>完整目录</strong></summary>

Book 1 — Harness Engineering：Claude Code 设计指南 ​

Book 2 — Claude Code 和 Codex 的 Harness 设计哲学 ​

</details>

想继续实践？试试 AgentWay ​

AgentWayAgentWay 是和本书主题相关、但彼此独立的实践平台。Harness Books 负责把控制结构、判断方式和架构分歧讲清楚；AgentWay 更偏向把这些方法继续落到训练路径、练习、项目演练和 agent PoC 上。如果你不想停留在“已经看懂”，而是想继续动手实践，可以单独了解它。

本地构建 ​

分别构建两个 Honkit 站点，再组装为统一的 Pages 静态站点：

bash
cd book1-claude-code && npx --yes honkit build . _book && cd ..
cd book2-comparing && npx --yes honkit build . _book && cd ..
python3 tools/book-kit/build_pages_site.py

最终输出目录为 dist/。

<sub>Keywords: Harness Engineering, Claude Code guide, Claude Code vs Codex, AI coding agent, control plane, query loop, agent recovery, agent verification, local governance, approval policy · 驾驭工程, Claude Code 指南, Claude Code 与 Codex 对比, AI 编程代理, 控制面, 查询循环, Agent 恢复, Agent 验证, 本地治理, 审批策略</sub>