OpenAI Codex 橙皮书·第一篇·总览

这是一本 GitHub 上完全免费、CC BY-NC-SA 4.0 协议的中文实战手册。但昨天我顺手在闲鱼搜了一下「codex 橙皮书」，发现已经有 5 个卖家在卖这本免费书了，价格 0.1 元到 1.5 元不等，累计 141 人想要、49 人已购。下面这张截图就是闲鱼的搜索结果：

卖家的「货源」几乎肯定就是从 GitHub 下载下来换个壳上传到闲鱼卖，闲鱼对这种数字资源转卖一直睁一只眼闭一只眼，因为维权成本远高于卖家收益。这事正好说明 AI 工具书的市场需求真的存在❘❘花叔这本 5 月 15 日才发 v2.0.1，6 月底闲鱼就出现 5 个卖家，需求驱动供给，哪怕供给是「白嫖转卖」。

这本书我自己也下载读完了，准备拆成 6 篇公众号连载给你看。本文先讲清楚这本橙皮书是什么、作者是谁、为什么值得读，后面 5 篇再按章节拆解。

一、我为什么现在去找这本橙皮书

最近在跑 Hermes Agent 项目，天天跟 Codex、Claude Code、Gemini CLI 打交道。Codex 我一直没系统看过，市面上中文资料零零散散，没有一个能当手册用的。

前两天顺手在 GitHub 搜了一下，搜出来一个仓库叫 alchaincyf/codex-orange-book，作者花叔，写到 v2.0.1 了。打开 README 一看，2026 年 4 月完稿的 v1，一个月后 GPT-5.5 空降默认模型、Codex for Chrome 上线、Auto-review 重写审批流程，于是整个重写成 v2，2026 年 5 月 15 日发布 v2.0.1。

一个写工具书的人，能在 AI 工具一个月一变的环境下，半个月就推出新版，这就是为什么我愿意花时间读这本书。

二、作者花叔是谁

花叔，英文名 HuaShu，AI Native Coder，独立开发者。橙皮书系列是他写的实战指南，目前已经到第 8 本。这本 Codex 是最新一本。

他最广为人知的产品是「小猫补光灯」❘❘一个 iOS App，上线后冲到 App Store 付费榜第一。关键事实是：他从来没手写过一行代码，整个 App 从第一行到最后一行都是 AI 写的。

这不是营销话术，央视和《人民日报》报道过他，标签是「手搓经济」代表人物。所有橙皮书、所有自媒体内容、所有产品，全部用 AI 完成。他全平台 30 万+ 粉丝，靠的不只是流量，是真做出过付费榜第一的产品。

这种背景的人写 Codex 实战手册，跟普通技术博主不一样的地方在于：他同时是 Claude Code 和 Codex 的重度用户，写得出双线对比，不会偏袒任何一个工具。

三、这本书写了什么

官方定位是「OpenAI Codex 的完整实战手册，覆盖五种形态：CLI、桌面 App、Cloud、IDE 扩展、Chrome 扩展，外加 5 月 14 日发布的手机伴侣端」。从安装到独立构建产品，一周内从零起步。

十个主章节，加三份附录，按使用深度分四块：

• 基础部分：§01 五种形态（含手机版尾声）· §02 10 分钟安装 · §03 你的第一个项目

• 日常工作流：§04 CLI 深度使用（Auto-review 与沙箱）· §05 AGENTS.md · §06 桌面 App 五件套与手机伴侣

• 超出本地机器：§07 Cloud 与 Chrome 扩展 · §08 Skills、MCP、Automations、/goal 四大扩展能力

• 构建真实产品：§09 从想法到上线 · §10 Codex + Claude Code 双线开发者心智模型

• 附录 A：命令速查（含 /vim、/hooks、/goal、/ide、codex remote-control）

• 附录 B：定价（三档 Pro）

• 附录 C：常见问题

四、v1 到 v2 改了什么

v1 是 2026 年 4 月完稿，v2 是 2026 年 5 月 14 日重写，中间只隔一个月。这一个月的变化，列下来能看出 AI 编程工具的迭代节奏：

GPT-5.5 空降默认模型，官方数据：SWE-bench Verified 82.6%、Terminal-Bench 2.0 82.7%，输出 token 降 40%，但单价翻倍。模型章节基本重写。

Codex 形态从四种变五种。2026 年 5 月 7 日 Codex for Chrome 扩展上线，把形态边界从「本地 + 云端」扩展到「浏览器内」。

Auto-review 改变审批模型。原来是 Codex 每一步动作都要问人；v2 引入 reviewer agent，约 99% 低风险动作自动通过，不再每次打断。沙箱章节也跟着重写。

ChatGPT 套餐改成三档 Pro：$20 / $100 / $200。$100 Pro 是独立开发者的甜蜜点，这一段在附录 B。

/goal 持久化目标系统。一个目标可以跨 /clear、跨 compaction、跨 session 存活。这个改动单独占了 §08 一大半。

桌面 App 五件套一次性放出：Computer Use、In-App Browser、Memory、图像生成、跨天续跑的 Automations。这一段在 §06。

v2.0.1 临门补丁是 5 月 14 日 Codex 手机版上线。OpenAI 把 Codex 集成进 ChatGPT 手机端，本质是桌面 Codex App 的远程控制面板，不是手机上独立跑的 agent。这个细节 §01 末尾专门加了「尾声」一节。

花叔在修订说明里写了一句：「这种节奏就是 AI 工具的日常。」这话不夸张，读这本书的一个隐藏收获是：你会被迫接受 AI 工具的迭代速度，再回去看自己手头的工具链，会觉得很多东西都要重学。

五、书里不回避的糙点

花叔在 README 里专门列了五条「不修饰」的事实，这种诚实度在工具书里少见：

• SWE-Bench Pro 基准上，GPT-5.5 仍然输给 Claude Opus 4.7，分数是 58.6% 对 64.3%。Codex 在真实工程任务上不是无敌的。

• GPT-5.5 标注的 1M 上下文，实际在 Codex 里可用约 258K。厂商标称和实际体验有差距。

• Windows 上 Full Access 模式真实案例删过用户全盘文件，三个用户分别丢了 370GB、700GB、240GB。Full Access 在 Windows 下绝对不能开。

• MultiAgentV2 还有三个 GitHub 未修 bug，编号 #16657、#17523、#14233。

• Codex 手机版（5 月 14 日上线）不是独立 agent，是桌面 Codex App 的远程伴侣，定位不要搞混。

这些糙点反而是这本书值得看的地方。工具书如果只夸不批，读者用起来出问题会骂作者；提前把雷区画出来，读者才敢真用。

六、怎么下载 + 怎么读

GitHub 仓库地址：github.com/alchaincyf/codex-orange-book。三种格式免费下载，中英文双版本。

中文版三种格式：

• PDF 4.2 MB，建议下载后用 PDF 阅读器看，体验最好

• EPUB 5.6 MB，微信读书优化版，可以直接导入微信读书

• HTML 220 KB，单文件，浏览器直接打开

协议是 CC BY-NC-SA 4.0，保留署名、非商用、可自由分享和改编。

如果你不想下载只想快速过一遍，HTML 220 KB 直接用浏览器看最快。如果你打算精读、画思维导图、做笔记，EPUB 导入微信读书最方便。

这是从 GitHub 拉下来的项目仓库全景：499 stars / 44 forks / 16 个文件，2026-05-15 最后更新，100% HTML 语言。注意 stars 数是写文章这一刻（6/29）的实测数据，5 月 15 日发布时只有几十颗，热度是这两周涨起来的。

七、我打算怎么拆给你

95 页正文 + 附录，单篇塞一篇肯定读不动。我会按主题拆成 5-6 篇连载，每篇聚焦一个能力模块，公众号连载节奏推：

• 第 1 篇（本篇）：橙皮书是什么 + 作者是谁 + 怎么读

• 第 2 篇：§01-02 五种形态 + 10 分钟安装（入门必读）

• 第 3 篇：§03-04 第一个项目 + CLI 深度使用（含 Auto-review 与沙箱警告）

• 第 4 篇：§05 AGENTS.md 给 Codex 一张地图（核心实践）

• 第 5 篇：§06-08 桌面 App + Cloud + 四大扩展（Skills / MCP / Automations / /goal）

• 第 6 篇：§09-10 从零到产品 + Codex + Claude Code 双线心智模型

如果你只想精读两章，建议先读 §01（建立全景图）和 §10（决定要不要把 Codex 加进工具链）。剩下章节按需取用。

八、橙皮书系列值得收的另外几本

花叔橙皮书系列目前 8 本，本本免费。本篇这本 Codex 是第 8 本。如果你用 Claude Code，前两本更对口：

• Claude Code 从入门到精通（实战入门）

• Claude Code 源码解析（Anthropic 架构设计拆解）

• Harness Engineering（缰绳工程学，AI Agent 约束设计实战指南）

• Agent Skills

• OpenClaw：养一只你自己的 AI

• Hermes Agent

• Polymarket 指南

合集下载页：huasheng.ai。

下一篇开始拆 §01-02，五种形态 + 10 分钟安装。Codex 是不是真如花叔说的那样值得用，看完那篇心里就有数了。

原文信息：OpenAI Codex 橙皮书 v2.0.1（2026-05-15），作者花叔，GitHub 仓库 alchaincyf/codex-orange-book，CC BY-NC-SA 4.0 协议。本文为解读笔记，所有事实引用自原书。

下一篇: 书名解读+2 ❘ 第2篇-五种形态安装。下篇看点: 本系列 6 篇全集已完结 · 下次连载 OpenRouter 月榜。