交流群即将上线
01 · Codex 到底是什么
一句话：会自己动手的编码智能体
Codex 不是「更聪明的自动补全」。它读你的仓库、改文件、跑命令、看结果，然后决定下一步。 你给的是目标，它交回来的是一堆改动加一段说明，你的活变成审这些改动。
这个差别决定了后面所有事情。补全工具最坏的结果是补错一行，你按 Esc 就没了； 智能体最坏的结果是它在你没提交的目录里跑了一条你没看清的命令。 所以官方文档把「沙盒和审批」放在很靠前的位置， 这本手册也一样——04 · 审批与沙盒 建议早点读。
Codex 和 ChatGPT 是什么关系
同一个产品家族里的三种工作方式，在桌面应用和网页版里靠顶部的切换器切换：
| 选择 | 适用场景 | 典型例子 |
|---|---|---|
| 聊天 | 问问题、来回讨论 | 搜网页、比方案、起草消息 |
| ChatGPT Work | 要一份能审的成品 | 做演示文稿、分析文件、起草报告 |
| Codex | 要开发者视图和技术细节 | 调试、跑测试、审 PR、实现功能 |
写代码就选 Codex。它给你 diff、命令输出、测试结果这些你需要核对的东西， 而不是把过程藏起来只给结论。
五个入口，选哪个
Codex 有好几个界面，跑的是同一套东西，区别在于你人在哪里、改动落在哪里。
Codex CLI —— 终端
bash
codex在项目目录里敲一下就进去了。适合你本来就在终端里干活的时候：探索仓库、改代码、跑本地工具。 它也是唯一能直接进脚本和 CI 的形态（codex exec，见 04 · 云端、CI 与非交互模式）。
这本手册的例子默认用 CLI，因为命令行的行为最容易写清楚、也最容易复现。
Codex IDE 扩展 —— 编辑器里
在 VS Code 一类编辑器里，让 Codex 在代码旁边跟你一起改。 好处是 diff 就在你平时看代码的地方，不用来回切窗口。 子智能体在跑的时候，后台面板会显示每个线程的状态。
ChatGPT 桌面应用 —— 项目和长任务
macOS、Windows、Linux 都有。适合同时管几个项目、任务要跑很久、 或者你需要它顺手处理本地文件的场景。开 Codex 聊天时要先选运行位置：
- 本地：直接在当前项目目录里改。
- 工作树：改动隔离在一个 Git 工作树里，不碰你正在编辑的分支（了解工作树）。
- 云端：在配好的云端环境里远程跑。
前两种都在你自己电脑上跑。
网页版 ChatGPT —— 手边没有开发环境时
浏览器里就能用，包括聊天和 ChatGPT Work。写代码不如前三个顺手， 但临时要看点东西、或者电脑不在手边的时候够用。
Codex 云端 —— 让它自己跑一会儿
任务扔到 OpenAI 托管的隔离容器里跑，跑完你回来看结果。 云端环境是两阶段的：设置阶段能联网装依赖，智能体阶段默认离线， 除非你专门为这个环境开了互联网访问。给云端环境配的密钥只在设置阶段可用， 进智能体阶段之前就被移除了。
怎么选
- 改自己电脑上的仓库 → CLI 或 IDE 扩展，看你习惯待在哪。
- 同时管几个项目 / 任务要跑很久 → 桌面应用。
- 不想让它碰你正在改的分支 → 桌面应用的「工作树」模式。
- 要挂在流水线里自动跑 →
codex exec或 GitHub Action。 - 只是想看看它能干什么 → 网页版最省事。
别在错的地方使劲
最常见的浪费是在网页版里贴一大段代码，让它猜项目结构。 本地的 CLI 和 IDE 扩展能直接读你的仓库，省掉这一整轮来回。
下一步
02 · 装在哪、怎么登录：四种装法挑一种，五分钟装完。