OpenAI Codex 完整学习指南：12 个知识点地图 + 该按什么顺序学

⏱️ 预计阅读 16 分钟 ｜ 🎯 目标：给你一张 OpenAI Codex 的学习地图——12 个核心知识点该怎么排、哪些现在就能深入、哪些先了解概念，以及你这个身份该从哪一篇开始、按什么顺序往下走。

你大概已经搜过「Codex 是什么」，也零散看过几篇教程。但越看越乱：有人上来教你写 AGENTS.md，有人先讲沙箱权限，有人甩一堆模型参数。问题不在哪篇讲错，而在没人给你一张「先学什么、后学什么」的顺序图。这篇就是那张图。

30 秒答疑：这篇到底解决你什么问题

最常见的新手误区：把 12 个知识点当成「12 道必修课，得一门门考过」。其实它是一张地图不是课表——你只会用到当前阶段需要的那几块，地图的价值是让你知道「下一块在哪、值不值得现在去」。

下面把这张地图摊开讲。

一、为什么搜「Codex 教程」会越学越乱：先认清这是一张地图

这一节讲清楚这篇文章的定位。已经知道「Codex 是什么」、只想看学习顺序的，可以直接跳到第二节看地图表。

新手学 Codex 卡住，几乎都不是卡在某个知识点太难，而是卡在不知道知识点之间的先后关系。

1.1 「碎片教程」喂不出学习路径

你在中文社区搜 Codex，会搜到一堆各讲一块的文章：这篇讲怎么写指令文件，那篇讲沙箱怎么配，还有的直接贴一长串模型参数对比。每篇单看都对，但它们之间没有顺序——你读完十篇，脑子里是十块拼图，却拼不出一张完整的脸。

更麻烦的是，很多碎片教程默认你已经会了前置的东西。一篇讲「上下文工程」的文章，会默认你已经懂提示词怎么写、AGENTS.md 是什么；你要是顺序乱了，从中间插进来读，每个词都认识、合起来不知道在说什么。

💡 通俗讲

碎片教程像是把一本书的第 3 章、第 7 章、第 11 章单独撕下来给你看。每一页都是真的，但你没有目录，不知道第 3 章其实要先读完第 1 章才看得懂。这篇文章干的事，就是把目录还给你。

1.2 这篇是「地图页」，不重讲 Codex 是什么

先把分工说清楚，省得你在这篇里找不到想要的东西：

• 「Codex 到底是什么、和 ChatGPT 有什么区别」 —— 这是另一篇专文的活。一句话先垫一下：Codex 是 OpenAI 出的「编程代理」（Coding Agent），你交一个任务，它自己进项目改代码、跑测试、产出可供审查的改动，不是「会写代码的 ChatGPT」。展开看 OpenAI Codex 是什么？和 ChatGPT 有什么区别。
• 「四个入口（CLI / App / IDE / Cloud）装哪个」 —— 也有专文，按身份对号入座。详见 OpenAI Codex 四个入口怎么选。
• 这篇（你正在看的） —— 只干一件事：把所有知识点排成顺序，告诉你先学哪个、为什么这个顺序、你该走哪条路径。

🔥 翔宇判断

学 Codex 最大的浪费，不是某个知识点学错，是顺序学反。翔宇见过太多人第一天就去钻沙箱权限的细则、研究该用哪个模型最省钱——这些是「跑顺两周之后才会真正用上」的东西。把它们提前学，既记不住，又挤掉了真正该先做的事（建立概念、跑通第一个任务、写第一份 AGENTS.md）。顺序对了，学一遍就够；顺序错了，学三遍还是乱。

二、OpenAI Codex 12 个核心知识点地图：一句话定位 + 现在能不能学

这是全文最该收藏的一张表。12 个知识点按「概念 → 入口 → 配置 → 进阶 → 协作」5 条主线排列，每个给一句话定位，并标明它现在处于什么状态——能直接深入的我给了链接，还在收尾的标「专题整理中」，你先记住它在地图上的位置，到了需要的阶段再回来。

2.1 五条主线一眼看懂

主线 1 · 概念   →  ① 是什么
主线 2 · 入口   →  ② 四入口怎么选
主线 3 · 配置   →  ③ AGENTS.md   ④ 提示词五件套   ⑤ 模型与成本   ⑥ 沙箱与审批
主线 4 · 进阶   →  ⑦ 上下文工程   ⑧ 任务管线   ⑨ Skills 与子代理、钩子   ⑩ MCP
主线 5 · 协作   →  ⑪ 团队协作   ⑫ 新手起步（本文：把上面全部串成路径）

2.2 12 知识点定位地图

💡 通俗讲

表里「🟡 专题整理中」不是说这块东西你现在用不了，而是说它的深度教程翔宇还在打磨、确保上线就是好文不是凑数。你完全可以现在就用 Codex——前两个 ✅ 知识点（是什么 + 选入口）足够你上手跑第一个任务了。剩下 9 块，按本文第三节的顺序，到了那个阶段自然会需要，到时候回来看专文。

🔥 翔宇判断

别被「12 个」这个数字吓到。翔宇的真实使用里，每天高频用的就 3 块：AGENTS.md（让它记住项目规则）、提示词五件套（把任务说清楚）、沙箱审批（划好安全边界）。其余 9 块要么是一次性配置（选入口、设模型），要么是特定场景才用（MCP、子代理、团队协作）。新手把这 3 块练熟，就已经能稳定吃到 Codex 八成的好处了。

2.3 一句诚实的话：地图会变，能力也会变

最后说一句实在话。Codex 是迭代非常快的产品——入口形态、默认用哪个模型、能力边界，每隔一段时间就会变一次。这篇地图给的是知识点之间的结构和学习顺序，这部分是稳的；但具体到「现在默认是哪个模型、某个入口长什么样、定价多少」这类会过时的细节，一律以 OpenAI 官方文档 为准，别拿任何一篇教程（包括这篇）里写死的版本号当真。

换句话说：地图教你认路，但路边的店招会换，认路的能力比记住某块招牌更重要。 这也是为什么这篇花最大篇幅讲「顺序和判断」，而不是堆参数——参数会过期，判断不会。

2.4 一个反向印证：市面上的 Codex 教程，缺的恰好是这张地图

写这篇之前，翔宇把中文社区里搜得到的 Codex 教程几乎翻了一遍，也对照看了英文头部的几篇。它们各有各的好，但凑在一起，反而把这篇该补的位置照得很清楚：

💡 通俗讲

这些教程不是写得不好，是它们各管一段——有人管「怎么进门」，有人管「每个房间长什么样」，但没人画一张「先去哪个房间、再去哪个、哪几个房间你这辈子可能都不用进」的动线图。新手最缺的恰恰是这张动线图：不是缺信息，是缺信息的排序。这篇就只画这张图，具体某个房间长什么样，到了门口我给你链接，进去看专文。

🔥 翔宇判断

「信息够不够」早就不是这个时代学 Codex 的瓶颈——官方文档、社区教程、视频课，料多到看不完。真正的瓶颈是判断：这么多料，先吃哪一口、哪一口可以先吐掉、吃到什么程度算够。翔宇敢把这篇定位成「地图」而不是「又一篇讲透」，底气就在这——讲透的人已经够多了，把顺序和取舍讲清楚的人太少。这也是这篇唯一想跟你拼的东西。

三、翔宇的学习顺序判断：先学什么、为什么是这个顺序

地图有了，接下来是路线。这一节给你翔宇带新手时实际用的顺序——不是按知识点编号 ① 到 ⑫ 顺着学，而是按「什么时候你会真正需要它」来排。

3.1 一张顺序图：从第 1 天到第 3 个月

3.2 这个顺序背后的三条原则

原则一：先能跑通，再求跑好。 第 1 天的目标不是把 Codex 配到完美，是完整跑通一次——交一个真实小任务，看着它自己改完、给你结果。这一次完整体验抵得上读十篇教程。配置优化是后面的事。

原则二：把回报最高的提前。 为什么 AGENTS.md 排在第 1 周这么靠前？因为它是一次投入、长期受益的事。很多新手会一直拖着不写，结果每开一个新对话都要重新告诉 Codex「这个项目用什么框架、有什么规矩」，每天浪费几分钟。写一份 60 行的 AGENTS.md，这个浪费一次性消掉。

原则三：把「场景才用」的往后放。 MCP、子代理、团队协作这些，听起来很高级，但新手阶段根本用不上——你还没有「需要外接搜索工具」「需要派多个子任务并行」的真实场景。提前学只会徒增记忆负担。等你真的撞到那个需求，再回地图上找它。

🔥 翔宇判断

如果只能给新手一句话，那就是：第 1 周务必把 AGENTS.md 写出来。 这是翔宇观察到的最清晰的分水岭——写了的人，两周后觉得「Codex 真好用」；没写的人，两周后觉得「Codex 也就那样，老忘事」。同一个工具，两种体验，差别就在这一份文件。它太基础、太不起眼，所以绝大多数人跳过——但它恰恰是回报最高的一步。

3.3 三个不要

排顺序也包括「不要在错误的时间做错误的事」：

• 不要第 1 天就纠结模型选哪个。 默认模型对新手完全够用，省钱优化是跑量大了之后的事。
• 不要还没跑通就研究沙箱细则。 默认的安全配置已经拦住了大部分意外，第 1 个月内补上理解即可，不必开局就钻。
• 不要为了「学全」而学。 地图上 12 块，你这辈子可能都用不到其中两三块（比如你不带团队，团队协作那块就放着）。用得上才学，是效率，不是偷懒。

3.4 地图之外，Codex 这一两年还多了哪些新东西

12 个知识点是给新手的「核心地图」，覆盖你头三个月真正会用到的。但 Codex 这个产品本身一直在长——翻一遍官方文档（OpenAI 开发者文档 · Codex）你会看到一些较新的能力，它们不是新手必学，但值得在地图边上记个名字，等用顺了知道「原来还能往这走」：

🔥 翔宇判断

看到这些新名词，新手最容易犯的错是「哇这么多新功能，我得赶紧都学」——千万别。这恰恰印证了这篇为什么是地图不是清单：产品每隔几个月就长出新能力，你要是追着功能学，永远学不完、也永远不踏实。正确的姿势是守住核心三件（AGENTS.md、提示词五件套、沙箱审批），新能力等撞到对应需求再回来取。地图的价值，就是让你在功能越长越多的时候，依然知道自己站在哪、下一步往哪走，而不是被新名词推着跑。

💡 通俗讲

这些较新能力具体怎么开、长什么样、有没有改名，会随版本变——所以这里只给你「它大概管什么」，不写死操作步骤。真要上手，认准官方文档那一份，别拿任何一篇教程（包括这篇）里的截图当现状。

四、三类身份的 Codex 学习路径：你是哪一类，就走哪条

同样一张地图，不同身份走的路线不一样。下面三类身份覆盖绝大多数学 Codex 的人，对号入座即可。每类给：起点、重点、可以略过什么。

4.1 完全新手 / 不太懂代码

你的画像：会用电脑，但没正经写过代码，或者只学过一点点。你想用 Codex 帮自己做点小工具、改改现成项目。

💡 通俗讲

不懂代码不等于不能用 Codex，反而是 Codex 最想服务的人之一。你不需要会写每一行，你需要的是会描述你想要什么、会看它做出来的东西对不对。这就是为什么提示词五件套对你比对工程师更重要——你的「说清楚需求」的能力，直接决定 Codex 帮你做出来的东西好不好。

新手的第一周可以这样排，每天只做一件小事，不贪多：

1. 第 1 天：装好桌面应用，让它做一件最小的事（比如「给这段代码加中文注释」），看一遍完整流程。
2. 第 2 到 3 天：换两三个不同的小任务练手，重点感受「我把需求说得越清楚，它做得越准」。
3. 第 4 到 5 天：试着把一个稍大的需求拆成两三步分别交给它，体会「大任务要拆小」。
4. 第 6 到 7 天：写一份最简单的 AGENTS.md（哪怕只有十几行：项目是做什么的、用什么语言、有什么规矩），再跑一次任务，对比前后差别。

这一周跑下来，你对「Codex 怎么用」的体感，会比读二十篇教程都扎实。新手起步的完整动手步骤，也可以先看更偏实操的入门文 AI 编程入门：零基础怎么学，它讲的是「先做后学」的整体路径，和这篇的 Codex 专项路线互补。

4.2 写代码的工程师

你的画像：你已经在写代码，可能也用过 Cursor、Copilot 这类工具。你想知道 Codex 在你的工具栈里该放哪个位置。

🔥 翔宇判断

工程师最容易犯的错，是把 Codex 当「更强的补全」来用——开个窗口来回打字，不让它真正接管整段任务。这等于买了辆车只用来当板凳坐。Codex 对工程师的真正价值是异步委托：你把一个明确定义的任务丢给它，自己去做别的事，过十几分钟回来审它的产出。能不能转过这个弯，决定你能从 Codex 拿到多少。至于「Codex 还是 Claude Code 更好」，新手别纠结——先用顺一个，两个都用过之后你自己就有答案了，详细的按身份选工具思路见 vibe coding 工具怎么选。

工程师还要建立一个判断：什么任务别交给 Codex。 它擅长的是「边界清楚、有客观验证标准（能跑测试 / 能编译 / 有明确产出）」的成块任务；它不擅长的是「需求本身还没想清、要靠反复试探才能确定方向」的探索性工作。后一类如果硬交给它，你会发现它一本正经地实现了一个错的方向——不是它笨，是你还没把目标定义清楚。这种时候，正确做法是先自己（或用聊天 AI）把方向理顺，再把定义好的任务交给 Codex 执行。把它当执行者，不是当决策者，这是工程师用好 Codex 的另一半。

4.3 团队负责人 / 一人公司创始人

你的画像：你要评估「团队该不该上 Codex」，或者你是一个人扛多个角色，想用 Codex 模拟一个小团队。

🔥 翔宇判断

团队上 Codex 最容易翻车的地方，不是技术，是没有统一的 AGENTS.md 和审批规范。每个人各写各的指令文件、各开各的权限，Codex 在不同人手里表现天差地别，最后背锅的是「这工具不靠谱」。其实是规约没统一。翔宇的建议是：团队推 Codex，第一件事是定一份团队共享的 AGENTS.md 和一套审批红线，把「哪些动作必须人工确认」写死。基础打好，工具才稳。

五、Codex 学习的 6 个里程碑，和那个「顿悟时刻」

学习路径不是模糊的「慢慢就会了」，它有清晰的台阶。下面 6 个里程碑给你 1 到 3 个月的完整成长线，每个里程碑都有明确的「完成标志」——达到了，你就知道自己到哪一步了。

5.1 六个里程碑

5.2 那个「顿悟时刻」在第 1 周

这 6 个里程碑里，有一个时刻最特别，几乎每个真正学进去的人都描述过同一种感受——它发生在你写完第一份 AGENTS.md、然后第一次让 Codex 跑任务的那一刻。

在此之前，你每开一个新对话都要从头交代：项目用什么框架、文件放哪、有什么规矩。Codex 像个失忆的助手，记不住昨天教过的事。写完 AGENTS.md 之后第一次运行，你会突然发现：它记住了。 它不再问你「这个项目用什么测试框架」，因为你写在文件里了；它不再把代码风格搞错，因为规约它自己加载了。

那一下的感受很难形容，最接近的说法是——「哦，原来它本来就该这么聪明」。

🔥 翔宇判断

这个「顿悟时刻」是翔宇判断一个人有没有真正入门 Codex 的标准。没到这一步的人，会觉得 Codex「时好时坏、不太可靠」；到了这一步的人，会开始把它当成稳定的生产力。这一步的门槛低到不可思议——就是写一份文件而已——但它就是分水岭。 所以如果你看完这篇只做一件事，那就是去写你的第一份 AGENTS.md，亲自体验一次这个时刻。

5.3 过了里程碑 ⑥ 之后往哪走

走完 6 个里程碑，你已经是熟练用户了。再往后有三条路，按兴趣选：

• 深耕单工具：跟 OpenAI 官方的 Codex 更新日志，版本和模型迭代很快，新能力第一时间用上。
• 横向建立选型直觉：把 Claude Code、Cursor、Devin、Aider、Gemini CLI 都摸一遍，遇到任何工具选择题你都有判断。
• 自己做工具：理解了编程代理怎么工作，你完全可以用 OpenAI 或 Anthropic 的 Agents SDK，搭一个贴合自己工作流的定制工具。

六、开始之前的自检清单：你准备好走这条路径了吗

动手跑第一个任务前，对着下面这张清单过一遍。每一条都答得上「是」，你就可以放心开始；有答不上的，回到对应章节补一下。

• [ ] 我清楚 Codex 是「编程代理」、要用「委托任务」的心态，不是把它当聊天框吗？（→ 第一节 + 是什么专文）
• [ ] 我知道 12 个知识点里，新手要先吃透的是哪 3 个吗？（→ 第二节）
• [ ] 我接受「这是地图不是课表」、用得上才学、不追求一次学全吗？（→ 第二、三节）
• [ ] 我打算第 1 周就写第一份 AGENTS.md，而不是一直拖着吗？（→ 第三节）
• [ ] 我知道自己是三类身份里的哪一类、该走哪条路径吗？（→ 第四节）
• [ ] 我选好第一个入口了吗？（→ 四入口怎么选）
• [ ] 我的第一个任务是个低风险小事（小功能 / 改一处显示），不是核心模块吗？
• [ ] 我心理预期是「等十几分钟看产出」，不是「实时一问一答」吗？

💡 通俗讲

这张清单不是考试，是帮你避开「准备不足就猛冲、撞墙后误以为工具不行」的常见弯路。八条全过，你就站在了一个对的起点上——不是「学完了」，而是「该从哪迈第一步、知道了」。剩下的，交给真实任务去教你。

6.1 开工前先校准两个会被传错的事实

新手在社区里学 Codex，最容易被带歪的是两类「听起来很确定、其实一直在变」的事实。开工前花一分钟自己去官方核一下，能省掉后面很多困惑：

• 「Codex 要不要单独付费」：按 OpenAI 官方现状，Codex 包含在 ChatGPT 的多档付费套餐里（档位以官方为准，可能调整）——也就是说你订了 ChatGPT，大概率已经能用 Codex，不必再为它单独买一份。但各套餐能用到什么程度、有没有用量上限，这类细节会调整，以 官方定价页 当下写的为准，别信教程里抄来的旧额度。
• 「现在默认是哪个模型」：你会在不同教程里看到各种不同的型号写法，因为它每隔一段时间就更新一次。新手完全不用记型号——默认模型对入门绰绰有余，等你跑量大了、开始在意速度和花费，再去 官方模型说明 看当下有哪些档位可选。把精力花在记型号上，是典型的「学了用不上、用上时又过期」。

🔥 翔宇判断

这两件事翔宇专门拎出来讲，是因为它们是新手「越查越慌」的高发区——看到一篇说要付费、一篇说免费，一篇用这个模型、一篇用那个模型，就开始怀疑自己是不是漏了什么。其实没漏，是这些点本来就在变。对会变的事实，正确的态度不是背下某个版本，而是养成「直接去官方核当下」的习惯。 这个习惯，比这篇地图本身更值钱——它让你在任何 AI 工具迭代得多快的时候，都不会被过时信息带乱。

一句话收官

OpenAI Codex 的学习，难的从来不是单个知识点，是顺序。这篇给你的就是那张顺序图：12 个知识点排成地图，先「是什么」建立概念、再「选入口」装上手、第 1 周写第一份 AGENTS.md——这一步会带你撞见那个「它终于记住了」的顿悟时刻。

剩下的 9 个知识点，按你的身份和阶段，用得上时再回地图上找。别想着一次学全，想着每一步都踩实。 现在就去跑你的第一个任务，然后写你的第一份 AGENTS.md——这两件事做完，你已经超过大多数还在收藏教程的人了。

相关阅读

• OpenAI Codex 是什么？和 ChatGPT 有什么区别？新手一篇看懂编程代理 —— 地图的第一站，先建立「编程代理」的概念。
• OpenAI Codex 四个入口怎么选？CLI、App、IDE、Cloud 新手对比指南 —— 知道是什么之后，第一个决策就是装哪个入口。
• AI 编程入门：零基础怎么学？别再先学语法了 —— 不懂代码的新手，先看这条「先做后学」的整体路径。
• vibe coding 工具怎么选？按你是谁来选 Claude Code / Codex / Cursor —— 纠结 Codex 和别的工具选哪个时看这篇。
• vibe coding 是什么？讲清能不能用、适合谁、会在哪翻车 —— 想从更上层理解「用 AI 编程」这件事，从这篇 pillar 进。

配置与进阶专题（按需深入）

• AGENTS.md 怎么写？OpenAI Codex 指令文件指南 —— 项目规则写一次，每次自动加载。
• OpenAI Codex 提示词工程指南 —— 把模糊需求变成能执行的清晰任务。
• OpenAI Codex 模型选择与成本指南 —— 按任务难度切档，平衡速度、质量与花费。
• OpenAI Codex 沙箱与审批指南 —— 让 AI 安全动手的双层防线。
• OpenAI Codex 上下文工程指南 —— 喂给它的资料整理得好不好，结果差距很大。
• OpenAI Codex 任务管线指南 —— 把大任务拆成 AI 能稳定跑完的步骤。
• OpenAI Codex Skills、子代理与 Hooks 指南 —— 可复用技能、子任务派发、关键节点自动检查。
• OpenAI Codex MCP 工具配置指南 —— 给 Codex 接上搜索、文档等外部能力。
• OpenAI Codex 团队协作与生产化指南 —— 多人协作怎么统一规范、分配权限、控制成本。

横向参考

• Claude Code 完整学习指南 —— 同类产品的学习地图，对照看更懂「编程代理」范式。
  外部参考：

• OpenAI Codex 官网 —— 产品总入口与最新能力。
• OpenAI Codex 开发者文档 —— 入口、模型、最佳实践的官方说明（版本与模型以官方为准）。
• OpenAI 平台 · Agents 指南 —— 想理解编程代理底层机制时看。

下一步

• AI 编程实操课：Claude Code + Codex + Agent 工作流，覆盖一人公司、自媒体自动化、AI 副业全场景。237 篇实战教程 + 最佳实践 + 源码包，跟着做就出成果。国内版-FlowUS | 国际版-BMC
• YouTube 频道：翔宇工作流
• 微信公众号：搜索「翔宇工作流」