01 · Codex 是什么：四种入口与使用场景

认识 Codex 的桌面 App、CLI、IDE 扩展和云端 Web 四种入口，搞清楚各自该在什么时候用。

如果把 Codex 想象成一个「会自己动手干活的编程助手」，那么理解它的第一步，是先分清你从哪里把它叫出来。Codex 不是一个藏在某个角落里只有一种样子的工具，它把同样的能力，做成了四种不同的入口。

第一个是桌面 App。它更像一个独立的工作台，打开之后你能看到项目、对话线程、历史记录，适合想要一个专注界面、不想整天泡在终端里的人。它的强项是把「管理多个项目」「查看每次改了什么」这件事做得直观。

第二个是命令行工具 CLI。这是最灵活、也最受资深用户偏爱的方式。你在终端里敲一条命令，它就能读你当前目录的代码、执行任务、把改动反馈回来。因为它就运行在你的工作目录里，所以和 Git、编辑器、脚本天然绑在一起。

第三个是 IDE 扩展。像 VS Code 这类编辑器里装一个插件，你就不用切换窗口，一边看代码一边让它改代码。对于大多数开发者来说，这可能是日常使用频率最高的一种。

第四个是云端 Web。它不需要你本机装任何东西，直接把仓库连到云端去跑。适合本机环境不干净、或者想让它在一个隔离的云端环境里长时间执行任务的场景。

flowchart TB
  A[Codex 大核心<br>理解任务+调用工具+读写文件]
  A --> B[桌面 App<br>独立工作台]
  A --> C[CLI<br>命令行]
  A --> D[IDE 扩展<br>VS Code 等]
  A --> E[云端 Web<br>无需本地安装]
  B --> F[管理多个项目]
  C --> F[灵活批处理]
  D --> F[边看边改]
  E --> F[隔离+长时间跑]
  style A fill:#5eead4,color:#050a0f
  style B fill:#0f1a24,color:#e6f1f5
  style C fill:#0f1a24,color:#e6f1f5
  style D fill:#0f1a24,color:#e6f1f5
  style E fill:#0f1a24,color:#e6f1f5

这四种入口共享同一套「大脑」——就是那个能理解任务、调用工具、读写文件、跑命令的代理核心。差别只在「你从哪里和它对话」以及「它能碰到的环境是哪里」。

一个常见的误区是觉得必须四选一。实际上它们是互补的：你可以在 IDE 里做日常小改，遇到要跑一整套流程的任务时丢给 CLI，需要长时间后台跑或者隔离环境时再用云端。

所以这一篇不是要你立刻选一个，而是要你先建立一个整体地图。后面每一组内容，都是在这个地图上往里填细节。建议你把这张「四种入口」的图记在心里，后面学安装、学配置、学工作流时，随时能对上号。

动手试一下：比起看十遍，不如立刻打开 Codex 跑一个小任务验证你理解的概念。比如这一篇讲的概念，你可以找一个一分钟能完成的小需求，让它跑一遍，看实际行为是不是和你理解的一致。

动手试一下：你可以花 5 分钟做一个最小验证——找一个真实的代码任务，让 Codex 跑一遍，看它的行为是不是和这一篇描述的一致。理论与实践对照，才知道「懂」和「会用」是两件事。

与其他篇的关系：这一篇是本组的基础。如果你跳过了前面几篇，建议先回去看，否则这里有些概念可能看着突兀。如果都看过了，那你可以直接进入更后面的实战环节，把这里学到的东西用上。

实用清单（速记版）：① 适用场景：{场景}。 ② 关键动作：{动作}。 ③ 风险点：{风险}。 ④ 验证方法：{验证}。把这四点记住，能让你在大部分场景下做出正确决策。