第 1 卷
工具上写的Skill能在另一个工具上跑,你的工作方式从此可以脱离任何一家公司的产品。这是我看Codex这本书的一个底层视角:工具会换、模型会变,但你为自己积累的Skill是真正属于你的。
如果你从没用过AI编程工具,这本书能带你从零开始。如果你已经是Claude Code用户,这本书能帮你打开另一
个维度。如果你已经在用Codex,这本书也许能给你一些新的组合思路。无论哪一种,希望你看完这本书也会想自己造一个Skill试试。
希望这本书对你有用。
v1 → v2修订说明(2026年5月)
这本书v1是2026年4月完稿的。一个月之后我决定做v2,原因很直接:AI编程工具一个月就能大变样,橙皮书不
能停在原版本。
这一个月里,Codex发生了几件事:GPT-5.5空降默认模型,输出token减40%但单价翻倍;2026-05-07 Codex for Chrome扩展上线,形态从四种变五种;Auto-review让审批模型从「事事问人」切到「reviewer agent判断」;ChatGPT套餐增加$100 Pro一档,独立开发者多了个甜蜜点;桌面App五件套大改(Computer Use / In- App Browser / Memory / Image Generation / Automations续跑)。这些都不是小修小补,是骨架级变化。
v2改了什么:模型章节、定价附录、形态介绍、沙箱审批这四块基本重写;其他章节做了模型名刷新、命令速
查增补、FAQ加5条用得久才会遇到的坑。变化最大的是§01、§10和附录B这三章,老读者直接跳读就能感受到。
这是橙皮书系列第一次明确做版本迭代。之前几本要么写完就定稿,要么悄悄改两处。这次我决定把节奏定下来:半年一修,每次修订独立标版本号、附修订说明。AI工具的迭代太快,停在某个时间点的书不如一本会跟着工具一起长的书。
临门补一笔(2026-05-14):v2定稿没几个小时,OpenAI上线了「Work with Codex from anywhere」,把 Codex集成进了ChatGPT手机端。手机现在可以镜像桌面Codex上正在跑的工作并远程审批。我在§01末尾加了「尾声」一节,§06也补了一段。「五形态」的框架仍然成立,手机版是桌面App的远程伴侣,不算独立的第六形态。这种节奏就是AI工具的日常。
10月补记
按「半年一修」,这是第二次修订。这半年Codex的变化比上一次还大:7月9日它并进了ChatGPT桌面App, Work和Codex共用一份订阅和用量;GPT-5.5在10月14日对ChatGPT登录的Codex退役,现在是GPT-6.1 Sol、 GPT-6 Astra、GPT-6 Luna三个;CLI从0.130走到0.163,5月版里反复出现的 --full-auto 和讲登录时用过的 - -api-key 都删掉了;云端换成了先搭可复用环境、再起任务的做法;hooks、插件、定时任务都成了正式功
能。
这一版CLI的部分是在我电脑上真跑出来的。0.163.0装好、登录、建项目、让它做一个任务、看diff、查 /status,每一步都截了图放进§02到§04。桌面App和云端这次没能上手跑,那两章按官方文档和
changelog写,章节里也写明了。
有几处5月版写错了,在这里统一交代:
第一,§10引用的6852个会话的分析,我写成了Stella Laurenzo发在一个Substack上的长文。数据其实来自她 4月2日在anthropics/claude-code提的GitHub issue,那篇Substack是别人写的评论。那一节讲的是3、4月
Claude Code的情况,两边模型都已经换了好几代,这一版整节删掉了,§10按10月的模型和功能重写。
第二,§04和附录C说Auto-review「4月30日上线」,引了「约99%的低风险动作自动通过、阻断99.3%的 prompt injection攻击」两个数,没写出处,后面紧跟着引的是《Running Codex safely at OpenAI》这篇博客。这篇博客里没有这两个数,它们出自4月30日alignment.openai.com的评测文章,含义也和我写的不一样:99.1%是OpenAI内部真实越界请求的批准率,99.3%是在一套人工构造的注入用例上的拒绝率。5月版还说
新版CLI默认就是Auto-review,其实默认仍是由你来批准。§04已经按原文改过。
第三,§08说Anthropic至今没做 /goal,错了,Claude Code 5月11日的2.1.139就加了;§10把hooks列成 Claude Code的独有项,Codex的hooks 5月14日也正式上线了。附录B里Opus 4.7的价格写成了每百万token 15/75美元,那是Opus 4和4.1的价,4.7是5/25美元。§10、附录B和附录C里Codex实际上下文「约258K」的
说法来自一个论坛帖子,这一版改成以 /status 里显示的为准。
第四,5月版的这封信里说Codex是「四种形态的异步系统」,补笔里又说手机不算独立的形态。现在手机上可以直接从发布好的环境起云端任务,§01按六个入口来讲。Claude Code那边也早就不只是终端里的同步对话
了,这半年两家的功能越来越像,§10有对照。
花叔 2026年5月(v2.0.0)
2026年10月补记(v261020)
§01 Codex是什么:一个账号,六个入口
One Account, Six Entry Points
Codex是一套系统:同一个ChatGPT账号、同一份配置、同一套AGENTS.md,从终端、桌面、云端、编辑器、浏览器、手机六个入口进去。这一章讲清楚每个入口是什么,再给你一个起步建议。
AI编程工具的三次换代
拉远一点看全景。AI编程工具这几年变了三次,每次变的是你和AI的分工。
第一次:补全(2022)。GitHub Copilot出来,你写上半句,它猜下半句。写代码的人还是你。
第二次:对话(2023-2024)。Cursor火了。你说想要什么效果,它在编辑器里替你改。后来加了Agent模式,能跨文件操作、跑命令,但它始终长在IDE里。
第三次:agent(2025-2026)。Claude Code和Codex CLI先后出现。它们直接在终端里跑:你描述一个需求,它自己读代码、写代码、跑测试、操作Git。你从写代码的人,变成了做决策的人。
Copilot补全→Cursor对话→终端agent
到2026年,agent这条赛道上最主要的两家是Anthropic的Claude Code和OpenAI的Codex。两家都已经不止一个入口了。
2026年10月的Codex长什么样
这半年有三件大变化:
Codex并进了ChatGPT桌面App。2026年7月9日起,原来独立的Codex App成了ChatGPT桌面App
(macOS、Windows)的一部分,App里分Chat、Work、Codex三块。8月11日又出了Linux版预览。
模型整代换了。本书5月版的主力GPT-5.5、GPT-5.4,对用ChatGPT账号登录的Codex已经全部下线(5.4在 8月31日,5.5在10月14日)。现在的主力是GPT-6.1 Sol、GPT-6 Astra、GPT-6 Luna,CLI的模型列表里排第一的是GPT-6.1 Sol,也是本书实测时的默认。
官方文档搬家了。 developers.openai.com/codex 现在会跳转到 learn.chatgpt.com/docs,书里的链接
都按新地址写。
本书的实测环境是Codex CLI 0.163.0(2026年10月15日发布),截图都来自这台机器。