×−+
认识 Codex第 1 课 · Codex 教程
第 1 课 · START HERE

认识 Codex：
会动手的编程搭档

在普通的对话里，ChatGPT 告诉你怎么改，动手的是你。Codex 不一样：它打开你的项目，自己读代码、改文件、跑测试，最后把改动摆在你面前，你看过点头才算数。这一课带你装好它，做完第一个任务。

约 30 分钟 10 节 · 6 个动手练习 章末测验 形式参考 luongnv89/claude-howto · 事实依据 OpenAI 官方文档
同一句话，点上面切换看看
入门先用起来 原理弄懂为什么 实战动手练 深入进阶与避坑

时间紧就先看"入门"和"实战"，装好就能用；"原理"讲怎么把任务交代清楚，决定它能不能一次做对。

01入门

Codex 是什么

Codex 是 OpenAI 做的编程代理（agent）。你说出目标，它自己动手做完，每一步都摆给你看。

Chat 像打电话问一位懂行的朋友他告诉你怎么改、代码长什么样，复制、粘贴、运行、排错都是你自己来。
Codex 像请这位朋友坐到你的电脑前他自己翻代码、改文件、跑测试，改完叫你来看。你负责说清楚要什么，最后把关。

它干活的五步

点每一步看看它在做什么。

第 4 步没通过，它会回到第 3 步接着改，直到验证通过或者需要你拿主意。
不只是写代码

解释一段看不懂的代码、找 bug、补测试、审别人的改动，都可以交给它。官方也说，习惯用 Codex 的人拿它做调研、写文档也没问题。

02入门

在哪里用：五个入口

同一个 Codex，有五个入口。账号和额度是通用的；项目规则、配置这些设置，桌面 App、命令行、编辑器扩展也共用一份。

ChatGPT 桌面 App
在 App 里切到 Codex。每一步、每处改动都看得见，还有审阅面板。macOS、Windows 都有，Linux 是预览版。本教程主线 · 第 1–13 课
Codex CLI
在终端里用。适合习惯命令行的人，也能写进脚本、放进 CI 自动跑。第 14 课
IDE 扩展
VS Code、Cursor、Windsurf 装扩展；Xcode、JetBrains 有自带的集成。直接拿编辑器里打开的文件、选中的代码当上下文。本课只介绍
Codex Cloud
在网页版、桌面 App 或手机上把任务交给云端，关了电脑也继续。要先连 GitHub、建好云端环境；也能从 GitHub、Slack、Linear 里直接发起。第 12、13 课
手机 Remote
ChatGPT 手机 App 里的 Codex Remote，遥控一台开着桌面 App 的 Mac 或 Windows 电脑：看进度、批准命令、看改动。任务还是在那台电脑上跑。第 13 课

桌面 App 里的三种用法

打开 ChatGPT 桌面 App，你会看到 ChatGPT 和 Codex 两个产品，ChatGPT 里又分 Chat 和 Work。写代码选 Codex。

选适合例子
Chat一来一回地聊问个问题、头脑风暴、改一段文字
ChatGPT Work定好结果，让它做出一份能审的成品做一份幻灯片、分析几份文件、写报告
Codex用开发工具，看技术细节修 bug、跑测试、审 PR、实现一个功能

Work 和 Codex 能做的事有重叠，区别主要在界面：Work 会藏起 Git、命令这些技术细节，Codex 会把改动、审阅面板都摆出来。两者用的是同一份额度。

旧教程对照

旧教程里单独下载的"Codex App"，2026 年 7 月 9 日并进了 ChatGPT 桌面 App。老用户照常更新就行，项目和设置都还在；macOS 上还可以保留 Codex 的图标，也能把 Codex 设成默认打开的界面。

03实战

练一练：这种情况用哪个入口

6 个场景，每个选一个最合适的入口。选完会看到解析。

04入门

装好、登录、切到 Codex

五步，几分钟。下面的界面是示意，按钮文字以你电脑上的 App 为准。

1
下载安装 ChatGPT 桌面 App在 chatgpt.com/download 选你的系统。Linux 有单独的安装说明。
2
打开 App，登录点 Continue to sign in，在弹出的浏览器里登录 ChatGPT 账号，登好会自动回到 App。用 API key 的，点 Sign in another way。
3
切到 Codex打开 ChatGPT 下拉菜单（产品选择器），选 Codex。
4
选一个项目文件夹打开你电脑上的一个文件夹，它就成了一个"本地项目"。Codex 能读、能改的，就是你选的这个文件夹里的文件。
5
新建对话，说出你要做的事点 New chat，运行位置先用 Local：输入框下面的 Work in 选 This computer，Worktree 开关关着，就在你电脑上的这个文件夹里干活。另外两种位置第 12 课讲。
1
ChatGPTChat · Work
Codex写代码
2 New chat 旁边的小图标是 Quick chat，随口问一句用
3
描述你要 Codex 做的事
This computer Ask for approval
在窗口里的位置：侧栏上方、输入框
  1. 1产品选择器在 ChatGPT 和 Codex 之间切换。写代码选 Codex。
  2. 2New chat新建一个 Codex 对话。一个对话做一件事。
  3. 3运行位置Work in 选 This computer，也就是 Local。旁边是权限档位，默认 Ask for approval。

用 ChatGPT 账号登录，还是用 API key

大多数人用 ChatGPT 账号登录就行。哪些套餐能用、额度多少，变化很快，统一写在专题 A（即将推出）里。

05原理

认识 Codex 的窗口

窗口分四块。点下面的说明，窗口里对应的部分会亮起来。第 2 课会把每一块讲透。

手机宽度下，侧栏收进了左上角的菜单按钮，审阅面板缩成了底部一条。

06实战

第一个任务：给订单列表加导出按钮

整套课程都用同一个示例项目：一个订单管理后台 order-admin。点"开始"一步步回放，中途它会停下来请你批准，你可以自己点。放完可以接着在输入框里提要求。

画面为教学示意：文件名、测试数量和 Codex 说的话都是虚构的；界面分区、按钮名称、权限规则与官方文档一致。

07原理

把任务交代清楚：四要素

官方最佳实践建议，任务里写上四样东西：目标、上下文、约束、完成标准。关掉其中一样，看看会发生什么。

目标是必须的，关不掉。

目标上下文约束完成标准
少了它，Codex 可能会（示意）
不用每次都写全

官方的原话大意是：提示词不完美，Codex 也常常能做得不错。小改动一句话就够；任务越大、越要紧，越值得把四样写全。拿不准怎么写，就直接说"先问我几个问题再动手"。

08实战

练一练：这个任务缺了哪一样

每个任务都只缺四要素里的一样，把它找出来。

09深入

开始之前，最该知道的几件事

后面几课会细讲，这里先打个招呼。

它能碰什么？什么时候会停下来问我？
默认的权限档位是 Ask for approval：在你选的项目文件夹里读写文件、跑命令，它自己来；要联网、要改项目外面的文件，先停下来问你。项目里的 .git、.codex、.agents 这几个文件夹也受保护，所以连 git commit 都要你点头。另外两档 Approve for me、Full access 要先在 Settings > General 里打开才会出现。第 3 课细讲。
先提交，再让它动手
Codex 没有一个"撤销上一步"的按钮。官方建议每个任务前后各留一个 Git 检查点（提交一次），改坏了随时能回去。审阅面板里也能撤销还没提交的改动（Revert），但它是按 Git 算的，会连你自己没提交的改动一起算进去。第 4 课细讲。
审阅面板用不了？
审阅面板要求项目是一个 Git 仓库。普通文件夹先运行一次 git init，或者直接让 Codex 帮你初始化。
一个对话做一件事
官方建议：每个不同的目标开一个新对话，消息和结果不会搅在一起。同一个项目下的对话共用这个文件夹，所以不用担心换了对话它就找不到文件。
只想随口问一句
不用开新任务。在 Codex 里把鼠标移到 New chat 上，点它右边的 Quick chat 图标。
额度用到哪了？
Chat、ChatGPT Work、Codex 共用你套餐里的额度。在输入框里打 /status，能看到这个对话的上下文用了多少、额度还剩多少。具体每个套餐多少，看专题 A。
网上的教程和这里说的不一样
  1. "下载 Codex App"：现在是下载 ChatGPT 桌面 App，在里面切到 Codex。
  2. "suggest / auto-edit / full-auto 三种模式"：这是很早以前 CLI 的说法，现在是权限档位（第 3 课）。
  3. "只能用 npm 安装 CLI"：现在 CLI 首选官方安装脚本，npm 也还能用（第 14 课）。
  4. "接一个中转 API 就能用"：那是第三方服务，不在官方支持范围内，本教程不讲。
10检验

小测验

8 道题，每题选完会立刻看到解析。