奇 奇连 AI
学习路线图课程工具计算器企业服务关于加入会员

Codex 的六个使用面：一张图看懂该用哪个

2026-08-09

新手装完 Codex（OpenAI Codex）后的第一个卡点，通常不是命令不会敲，而是打开文档发现它有好几个入口，不知道自己该进哪一个。更麻烦的是这几个入口共用一个产品名，读者很容易默认它们是同一个东西的不同皮肤——不是。它们的可用模型不一样、版本可能不一样、会话存在哪里也不一样，选错了会在很后面才发现。

这篇就干一件事：把官方文档站分出来的六个使用面摆清楚，再给一条能自己走的选择路径。

先说清楚本文的证据边界：六个面里我们只在本机实测过 Codex CLI（codex-cli 0.147.0 / Windows 11），而且只跑了 --help、doctor、login status 这类只读命令，一次模型对话请求都没发过。桌面应用、Codex cloud、IDE 扩展、各类第三方集成全部没有实测，凡涉及这几块，本文一律写「官方文档给的做法是……」。

一、六个面分别是什么

官方文档站把 Codex 的使用面拆成这六个，各有独立文档页：

使用面文档路径本文的证据来源
ChatGPT 桌面应用/docs/app官方文档口径，未实测
Codex CLI/docs/codex/cli本机实测（只读命令）
Codex IDE 扩展/docs/codex/ide官方文档口径，未实测
Codex cloud/docs/cloud官方文档口径，未实测
ChatGPT Web/docs/web官方文档口径，未实测
Codex Remote/docs/remote只知道有这一页，未取内容

最后一行要特别说明：Codex Remote 这一页我们只拿到了页名，没有取过内容，所以本文不会描述它能干什么。别凭名字推断功能，这是新手最容易被自己带偏的地方。顺带提醒一句，Codex CLI 的顶层选项里有一个 --remote <ADDR>（在 codex-cli 0.147.0 上，帮助文本写的是把 TUI 连到远端 app server，接受 ws://host:port、wss://host:port、unix:// 这类地址），名字看着像，但没有任何依据说它就是 Codex Remote 那个面，不要把两者画等号。

二、官方自己的建议

官方在快速上手页里给过一句选择建议，可以作为默认起点：**桌面应用（官方标注为推荐）**用于项目、本地文件和较长时间的任务；Web 用于不受打扰的云端复杂任务、且免安装；如果你的工作场景就在终端或编辑器里，建议用 Codex CLI 或 Codex IDE 扩展。

这条建议对第一次接触的读者是够用的，但它没回答一个更实际的问题：我怎么知道自己属于哪一类。下面这棵树是按官方口径整理出来的判断顺序。

三、一张图：从你的处境倒推

第一问：你要 Codex 动的文件在哪儿？
│
├─ 在我这台电脑上的项目里
│   │
│   └─ 第二问：你平时在哪儿写代码？
│       ├─ 终端 / 命令行是主场 ────────→ Codex CLI
│       ├─ 编辑器里几乎不切窗口 ──────→ Codex IDE 扩展
│       └─ 不想碰命令行，要图形界面 ──→ ChatGPT 桌面应用（官方推荐入口）
│
├─ 在 GitHub 仓库里，想让任务跑在别处、还能并行
│   └────────────────────────────────→ Codex cloud
│
└─ 不改文件，只是想问点东西；或这台机器不方便装软件
    └────────────────────────────────→ ChatGPT Web

这棵树的第一问之所以放在最前面，是因为「改不改本地文件」是六个面之间最硬的一条界线：官方对本地与云端的界定是，本地工作流在你自己的设备上运行，云端任务在 OpenAI 托管的环境里运行。这条界线还决定了会话记录留在哪——按官方口径，云端 Work 会话会跨 web、移动端、桌面端同步，本地 Work 会话只留在你的电脑上。如果你指望换台机器还能看到刚才那个会话，那你从一开始就该走云端那条分支；反过来，如果这个仓库根本不允许离开本机，云端那条分支从第一步就不该走。

四、CLI：唯一能给你一手验收步骤的面

CLI 是本文唯一实测过的面，所以这一节给的是可以照着敲的验收动作。

装好之后先做三件事，顺序别换：

codex --version
codex doctor --summary
codex login status

第一条是为了拿到当次的版本号。为什么强调「当次」：在本机采集数据时，同一台机器上开头执行 codex --version 得到的是 codex-cli 0.131.0，十几分钟后再执行同一条命令得到 codex-cli 0.147.0，而 which -a codex 全程只有一个可执行文件。Codex 具备自更新能力，所以版本号变了是正常现象。做错了会怎样：你拿记忆里的版本号去对照文档排查，很可能查了半天查的是一个你已经不在用的版本。

第二条 codex doctor --summary 是配置和环境的体检。它在 codex-cli 0.147.0（Windows 11）上会分组打印 Environment、Configuration、Updates、Connectivity、Background Server 等检查项，末尾给一行统计（形如 17 ok · 1 idle · 1 notes · 0 warn · 0 fail）。这里有个一手结论值得记住：本机故意用 -c 'features=[unclosed' 传了一段语法不合法的 TOML，doctor 没有崩溃退出，照常跑完，只是在结果里出现了一行

✗ config       config could not be loaded - Fix the reported config error, then rerun codex doctor.

也就是说，配置文件坏了不一定有明显报错，但 doctor 会明确告诉你配置没加载成功。以后遇到「我明明改了配置怎么没生效」，第一步就是跑 doctor 看这一行，别急着改第二遍配置。

第三条 codex login status 用来确认登录方式。本机实测这条命令输出一行 Logged in using ChatGPT。

顺带提一个跨面的小入口：CLI 的子命令里有 codex app，帮助文本的官方说明是 “Launch the Desktop app (opens the app installer if missing)“——桌面应用没装的话它会打开安装程序。我们没有实测执行后的结果，只是把这条帮助文本原样引用。

五、桌面应用与 Web：官方文档怎么说

桌面应用在 Windows 与 macOS 上都可用，官方给的定位是项目、本地文件、较长任务与快速提问。官方文档给的做法是：可以新建聊天、创建项目，或者打开一个文件夹，ChatGPT 会使用你选定位置里的文件与上下文。ChatGPT 与 Codex 之间的切换，官方点名的两个位置是 ChatGPT 里 composer 上方的 Chat/Work 切换，以及 Codex 里从 “New chat” 开始、右侧有 Quick chat 图标用于短问题。除了官方点名的这几个元素名，本文不会描述任何界面布局——我们没打开过它。

有一个坑值得新手提前知道：官方排查页明确写了，CLI 与桌面应用可能是不同的版本，进而出现「这个功能 CLI 有、桌面应用没有」。官方给的确认方法是分别查版本：CLI 用 codex --version，桌面应用（macOS）用 /Applications/Codex.app/Contents/Resources/codex --version。做错了会怎样：你按 CLI 的文档去桌面应用里找一个功能，找不到就以为自己操作错了，实际上是版本口径不同。

Web 这个面在官方建议里的定位是不受打扰的云端复杂任务、且免安装。对第一次接触的读者，它的价值主要是「这台机器我不想装东西」。

六、Codex cloud：并行跑任务的那条路

官方对 Codex cloud 的定位是在隔离的云端环境里跑任务，可以并行，不占用本地机器。任务发起入口官方列了四个：web、GitHub、Linear、Slack。

官方给的三步上手是：① 用 ChatGPT 账号登录 Codex；② 连接 GitHub 账号并选择可访问的仓库；③ 打开环境设置，为仓库创建一个环境。这里的**环境（environments）**是按仓库配置依赖、工具、变量与初始化步骤的地方——这一步不能跳，跳了就等于让云端在一个没装依赖的仓库里干活。任务结束后，官方口径是可以查看摘要与 diff、追加后续要求，或者直接开 PR。

CLI 这边有对应的入口。在 codex-cli 0.147.0 上，codex cloud 的帮助文本标注为 [EXPERIMENTAL]，子命令包括 exec（不启动 TUI 直接提交云端任务）、status、list、apply（把某个云端任务的 diff 应用到本地）、diff（显示统一 diff）。另外顶层还有一个 codex apply <TASK_ID>，帮助文本说明是把 agent 产生的最新 diff 以 git apply 的方式打到本地工作树。

[EXPERIMENTAL] 这个标签必须当真：它是实验阶段的能力，不该当成稳定功能写进团队的日常流程里。同样，CLI 里的 app-server、remote-control、exec-server 也带着 experimental / EXPERIMENTAL 标注。

七、选面之前，先确认模型跟不跟得过去

这是选面时最容易漏掉、后果又最直接的一条：不是每个模型在每个面上都能用。按官方《Models》页（核对日 2026-08-09）：

  • gpt-5.6-terra 在 Codex cloud 不可用；
  • gpt-5.6-luna 在云端任务不可用；
  • gpt-5.3-codex-spark 是纯文本的研究预览模型，仅在桌面应用与 CLI 两个面上出现，且仅面向 ChatGPT Pro 用户。

还有一条口径要记牢：Codex cloud 是自动选择模型的，不是你在本地选了什么云端就跟着用什么。做错了会怎样：你在本地把模型调成了自己习惯的那个，然后把同一批活儿丢到云端，默认云端也是这个模型——这个前提不成立。想让云端任务跑起来，选型上能落到的就是 gpt-5.6-sol。

八、新手最容易做错的四件事

  1. 把六个面当成同一个东西的六种皮肤。版本可能不同、可用模型可能不同、会话存放位置也不同。
  2. 拿桌面应用的排查步骤去修 CLI 的问题。官方排查页里相当一部分条目面向的是桌面应用，CLI 的问题得用 CLI 的手段查（先 codex --version，再 codex doctor --summary）。
  3. 把带 experimental / EXPERIMENTAL 标注的能力当稳定功能用。codex cloud 在 codex-cli 0.147.0 上就带这个标签，随版本变动是完全可能的。
  4. 一上来就同时铺三个面。第一次接触先只固定一个入口，把「能跑通、能验收」这条链走完，再考虑要不要多开。

九、自己查文档的两个省事办法

官方文档站有两个对新手很实用的特性：任何文档页的 URL 后面加 .md 后缀就能拿到 Markdown 版本；站点还提供 llms.txt（完整页面索引）与 llms-full.txt（合并全文），可以直接喂给 AI 工具。选面这件事本身随版本会变，与其记住本文的结论，不如记住去哪儿核对结论。

选面没有标准答案，只有「你要动的文件在哪儿、你平时在哪个窗口里、这活儿要不要并行」这三个问题的答案。先把这三个答案写下来，再回到第三节那棵树上走一遍，基本就不会走冤枉路了。

这个系列的其余 69 篇

本批围绕 Codex 写了 70 篇，按你现在的处境挑一组进去，不必从头读。

上手与入门（4 篇）

配置与机制（15 篇）

场景实战（15 篇）

对比与选型（10 篇）

排查与故障（25 篇）

本文依据 Codex 官方文档（learn.chatgpt.com/docs/ 的《Quickstart》《ChatGPT desktop app》《Codex CLI》《Codex IDE extension》《Codex cloud》《Codex Remote》《ChatGPT on the web》《Models》《Troubleshooting》页面）整理，核对日 2026-08-09；文中标注「本机实测」的部分基于 codex-cli 0.147.0 / Windows 11 环境下的只读命令输出。产品功能、模型与价格以官方最新说明为准。桌面应用与云端部分为官方文档口径，非本机实测。

想系统学会用 AI？报名体系课或加入会员，照着学、照着用。

浏览课程 加入会员