wquguru/harness-books

这是什么？

核心功能

• 01讲解代理系统中的查询循环、工具权限、上下文治理和错误恢复。
• 02比较 Claude Code 与 Codex 在控制平面、沙箱和策略语言上的设计差异。
• 03说明 skills、hooks 和本地规则如何把团队习惯固化进代理系统。
• 04提供中英文在线阅读，并可下载 PDF。
• 05附带 Python 构建脚本，可在本地生成双语书籍站点。

适用场景

• 想自研编码代理、需要了解其控制层设计的开发者。
• 负责在团队内规范 AI 编码工具使用方式的工程负责人。
• 在选择工具前，希望对比 Claude Code 与 Codex 架构的工程师。

快速上手

1. 1

   在线阅读这两本书

2. 2

   本地构建第一本书（英文）

   python3 tools/book-kit/build_honkit.py book1-claude-code --locale en
3. 3

   组装统一的 Pages 站点

   python3 tools/book-kit/build_pages_site.py

使用前须知

• !该项目是两本书而非软件，且未列出许可证。
• !本地构建需要运行 Python 构建脚本，输出写入 dist/ 目录。

标签

常见问题

harness-books 是什么？

两本讲解代码智能体 harness 设计的免费书籍，以 Claude Code 和 Codex 为对象。 Harness Books 是一套关于 harness 工程的两本书。harness 指代码模型进入终端、代码仓库、权限系统和团队流程之后，用来约束和管理它的整套系统。书中讨论提示词分层、查询循环、工具权限、上下文治理、错误恢复、多智能体验证以及团队规则，目标是让这类系统保持边界清晰、可持续运行并且可以追责。

harness-books 可以免费使用吗？用的什么许可证？

harness-books 没有声明许可证。代码虽然公开，但没有许可证就没有明确的使用授权，正式使用前建议先联系作者。

harness-books 还在维护吗？

超过半年未提交。harness-books 最近一次提交是在 2026年4月19日。

harness-books 适合用来做什么？

想自研编码代理、需要了解其控制层设计的开发者。 负责在团队内规范 AI 编码工具使用方式的工程负责人。 在选择工具前，希望对比 Claude Code 与 Codex 架构的工程师。

harness-books 怎么安装和运行？

在线阅读这两本书 本地构建第一本书（英文）: python3 tools/book-kit/build_honkit.py book1-claude-code --locale en 组装统一的 Pages 站点: python3 tools/book-kit/build_pages_site.py

在哪里获取 harness-books？

源代码和安装说明在 GitHub 上：https://github.com/wquguru/harness-books