harness-books

读懂 Claude Code 与 Codex 的设计内核，掌握智能体工程精髓

harness-books 是一个关于 AI 智能体工程（harness engineering）的开源书籍项目，深入剖析 Claude Code 与 Codex 两大编码智能体背后的设计哲学。它系统阐述了约束设计、查询循环、上下文治理和多智能体验证等核心主题，旨在帮助开发者理解如何构建可靠、可控的 AI 智能体系统。项目以两本书的形式呈现，内容兼具理论深度与实践指导，适合 AI 工程师、产品经理及技术决策者阅读，以掌握智能体工程的关键原则与最佳实践。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3138

维护状态低维护

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队wquguru

所属国家

官网地址http://harness-books.agentway.dev

GitHubhttps://github.com/wquguru/harness-books

定价模式free

价格说明开源书籍项目，无在线服务，可免费获取内容。

访问状态

是否开源是

开源协议

主要语言Python

技术栈/模型agentic-ai,ai-agents,ai-engineering,claude-code,codex,context-engineering,developer-tools,llm,prompt-engineering

GitHub 星标★ 3138

30天Star增速

HF 下载量

上线时间2026-04-01 00:00:00

最近更新2026-09-23 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：云服务 4 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

可正常访问互联网
现代浏览器（Chrome、Firefox、Safari、Edge 等）
如需离线阅读，需具备 PDF 阅读器

安装与启动步骤

1访问官方站点

README 未提供任何本地安装或构建说明，本项目以在线书籍形式发布，直接在浏览器打开官方站点即可。
2阅读第一本书

打开 Claude Code 设计指南的在线阅读页，逐个章节浏览。站点路径中的 /en/ 表示英文版。
3阅读第二本书

打开 Claude Code 与 Codex 对比一书的在线阅读页，与第一本配合阅读效果更好。

4下载 PDF 离线看

README 给出了两本书的 PDF 直链，可用 curl 下载到本地后用 PDF 阅读器打开。

curl -L -o book1-claude-code-en.pdf https://harness-books.agentway.dev/en/book1-claude-code/exported/book1-claude-code-en.pdf
curl -L -o book2-comparing-en.pdf https://harness-books.agentway.dev/en/book2-comparing/exported/book2-comparing-en.pdf

如何确认成功

浏览器成功打开 harness-books.agentway.dev 并显示书籍正文或目录，即表示可正常阅读。

常见问题

Q：需要安装 Python 或克隆仓库吗？

A：

Q：README 里没有安装说明，是否可以本地部署？

A：README 只提供在线阅读与 PDF 下载链接，未给出任何安装、构建或部署命令，因此无法依据它进行本地部署，建议直接阅读线上版本。

Q：有中文内容吗？

A：仓库根目录提供了中文 README（./README.zh-CN.md）；在线书籍链接使用的是 /en/ 英文版路径，可尝试去掉 /en/ 查看是否有中文页面。

Q：两本书有什么区别？

A：第一本《Harness Engineering: A Design Guide to Claude Code》聚焦 Claude Code 的设计指南；第二本对比 Claude Code 与 Codex 两大编码智能体的设计哲学。

注意事项

README 未提供本地安装、构建或运行命令，本教程仅基于其给出的在线阅读与 PDF 链接整理。
书中内容侧重约束设计、查询循环、上下文治理与多智能体验证等工程理念，并非逐行源码解读。
README 节选内容不完整（正文在 Prompt layerin 处截断），如需更多细节请查阅完整仓库与官网。

核心亮点

直击两大主流编码智能体的设计哲学，内容稀缺且深度高
系统覆盖约束、查询循环、上下文治理等关键工程主题
以书籍形式组织，结构清晰，适合系统学习而非碎片阅读

不足之处

文档/社区待观察
内容偏理论，缺乏可运行的代码示例或实践模板

适用场景

AI 工程师设计自主智能体系统时参考设计模式
技术团队评估或对比 Claude Code 与 Codex 的架构差异
产品经理理解智能体能力边界，制定产品策略

替代项目

anthropic-cookbook、openai-cookbook、awesome-ai-agents

项目介绍

harness-books 是智能体领域的开源项目，由 wquguru 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（3,138）位列前 30%，在智能体分类的 2,517 个项目里位列前 13%。

近 42 天，它的 GitHub 星标从 2,754 增加到 3,138，净增 384。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-23。开源书籍项目，无在线服务，可免费获取内容。

它主要面向的使用场景是：AI工程师设计自主智能体系统时参考设计模式。同类可对比的替代方案包括 anthropic-cookbook、openai-cookbook、awesome-ai-agents。

上一篇：Awesome-Agent-Papers

下一篇：Open-Interface