很多人第一次听到 Codex，会下意识把它理解成又一个 AI 写代码的工具。这个理解不算错，只是漏掉了最要紧的部分。
Codex 是 OpenAI 推出的工程 Agent，具备桌面端 App、CLI、Web 云端和 IDE 等多种产品形态。它和普通 AI 聊天工具最大的区别在于，不只是回答你”这段代码怎么写”，而是可以进入一个项目，读取文件、理解上下文、制定计划、修改代码、运行命令、检查结果，最后把改动整理成可以 review 的结果。以前的 AI 是坐在你旁边帮你补代码，现在的 Codex 更像一个可以被交代任务的工程执行者。
打开 Codex 会看到五个入口。它们不是五个独立的软件，而是同一套编码代理能力开出来的五扇门，区别只在于各自承担的任务节奏不一样。
五个入口分别在干什么
CLI 跑在终端里，管的是小步快跑的活。项目就在本地，你要改一个函数、修一个报错、补一段测试，直接在项目目录里敲命令就行。读代码、改文件、跑测试都在同一个窗口里完成，改完还能顺手跑一遍验证。手上的活不大，这条路最短。
桌面 App 管的是同时推进好几件事。手上挂着三四个任务，用终端就得开好几个窗口，桌面 App 把多个 agent 放进同一个工作台，Skills 和 Automations 也在这一层。一个窗口挂住好几件事，常用的流程还能沉淀下来反复用。
IDE 扩展管的是眼前这段代码。想弄明白一段看不懂的逻辑，或者只想改这一个函数，就在编辑器里叫它，它贴着文件走，不用来回切窗口。
Cloud 和 Web 管的是跑得久、能并行的活。仓库级的任务、后台分析、生成 PR，这些丢出去之后你该干嘛干嘛，不用守着。
ChatGPT 里的 Codex 管的是任务分派。它更像一个分派台，你把仓库级任务交出去，再看它理解得对不对、推进到哪一步。
一张表看清五个入口
| 入口 | 更适合 | 典型任务 | 学习优先级 |
|---|---|---|---|
| CLI | 本地快速迭代 | 修 bug、补测试、跑命令、解释仓库 | 新手优先 |
| 桌面 App | 本地多任务工作台 | 多 agent、Skills、Automations、插件协作 | 进阶优先 |
| Cloud / Web | 较长任务和并行任务 | 仓库任务、PR、后台分析 | 团队优先 |
| IDE | 编辑器上下文 | 局部修改、解释代码、代码审查 | 日常高频 |
| ChatGPT 中的 Codex | 面向仓库的任务分派 | 连接 GitHub、理解仓库、协作推进 | 按账号能力选择 |
这张表不用背。真要选，判断标准只有一条：看手上的活需要什么节奏。
怎么选
任务需要频繁看命令输出，就选 CLI。改完就要看结果、看日志、反复试，终端是最短的路径。
任务需要多个 agent 并行，或者要用到 Skills 和 Automations，就选桌面 App。这种活需要的是一个工作台，不是单个窗口。
任务时间比较长，希望它在后台跑，甚至可能生成一个 PR，就选 Cloud 或者 Web，丢出去之后不用守着。
你正在编辑具体文件、要改的就是眼前这段代码，就选 IDE。想从对话里分派仓库级任务，连 GitHub、理解仓库、协作推进，就用 ChatGPT 里的 Codex。
第一次上手，按这个顺序
不用一上来把五个入口都装一遍。先挑一个建立最小闭环，跑通了再往外扩。
- 从 CLI 开始，装好，跑通第一个任务，看它改完的文件对不对
- 用桌面 App 体验本地多任务和技能沉淀
- 再进入 Cloud / Web，学习长任务、PR 和团队协作
- 回头读 CLI 选项和 config.toml，把配置基本功补上
- 把高频模板沉淀到 AGENTS.md、案例库和团队规范里
配置和入口不是一一对应的
有个细节值得提前知道，改配置之前先想清楚影响范围。
AGENTS.md 同时影响 CLI、桌面 App 和 Cloud 三个入口，改一次，三个入口的行为都会跟着变。CLI 选项和 config.toml 只影响 CLI。Skills 是桌面 App 和 CLI 共用。Worktrees 只有桌面 App 里有。Environments 归 Cloud 和 App。沙盒与审批机制则是所有入口共用。
它和 ChatGPT、Cursor 有什么区别
很多人会问，ChatGPT 也能写代码，为什么还要用 Codex。区别在角色：ChatGPT 更像一个顾问，你有问题去问，拿到答案自己动手。Codex 更像一个实习生，任务交代下去，它进项目里把活干了。合理的用法是先跟 ChatGPT 想清楚，再让 Codex 进项目执行。
Cursor 也常被拿来比较，它更像一个 AI 编辑器，Codex 更像一个工程 Agent，一个偏 IDE 协作，一个偏 Agent 执行。日常编码和局部修改交给 Cursor，任务推进和工程交付交给 Codex，这样搭着用最顺。
先从 CLI 装起，跑通一个最小任务。剩下的入口等你手上真的出现对应的活再开，不用急着全学。
