四种入口
同一个 Codex 可以从桌面 App、CLI、IDE 扩展和 Cloud 四种入口使用。它们不是四个完全不同的 AI，而是同一类代理能力在不同工作环境中的入口。 读完后，你应该能够：- 分清本地入口和云端入口；
- 根据任务是否需要本机文件、终端、编辑器或后台并行来选入口；
- 理解 Local、Worktree 和 Cloud 的基本区别；
- 知道四种入口之间哪些设置可以复用。
本篇参考了参考/codex/01-what-is-codex.md、参考/codex/07-desktop-app.md、参考/codex/08-cli.md、参考/codex/09-ide.md和参考/codex/10-cloud.md。不同版本的按钮、扩展名称和功能范围可能变化，请以官方文档和本地界面为准。
四种入口总览
前三种入口通常读取和修改你本机上的工作区；Cloud 则使用你授权的 GitHub 仓库，在云端容器中工作。这个区别决定了它能否访问你本机的未提交文件、本地工具、私有配置和本地 MCP。
入口一：桌面 App
桌面 App 是一个面向并行工作的图形化工作台。参考材料把它概括为“左边栏选项目和线程，中间下指令，右边看结果”：- 项目和线程：管理不同代码仓库及其任务对话；
- 对话区：查看 Codex 读取了什么、执行了什么、准备怎么做；
- 结果面板：查看 Git diff、终端输出和预览；
- 运行模式：通常可以在 Local、Worktree 和 Cloud 之间选择。
Local、Worktree 和 Cloud
Worktree 的关键价值是隔离：多个任务各自在独立副本中修改，完成后你再通过 diff、合并或交接决定如何落地。它依赖 Git，并且不会自动带上
.gitignore 中的依赖目录或本地文件。
桌面 App 特别适合：一边修复 Bug、一边让另一个线程补测试；修改量较大时逐文件查看 diff；把常用命令保存成 Action；设置定时任务生成代码库简报。
入口二：CLI
CLI 是最灵活、最容易接入工程流程的入口。直接运行codex 会进入交互式终端界面；需要脚本或 CI 时，可以使用非交互式的 codex exec。
- 可以在没有图形界面的服务器和 SSH 环境中运行；
- 可以用 shell、脚本和 CI 组合；
- 可以精确指定工作目录、模型、沙箱和审批策略；
- 可以用结构化输出把结果交给其他程序处理。
入口三：IDE 扩展
IDE 扩展把 Codex 放进你正在写代码的编辑器中。参考材料特别提醒：安装时应确认发布者和扩展 ID；例如 VS Code 生态中常见的官方扩展 ID 是openai.chatgpt，具体以扩展市场当前信息为准。
IDE 扩展的最大优势是直接拿到编辑器上下文：选中代码后提问、用 @file 引用文件、让 Auto Context 带入最近打开的文件，并在编辑器中查看和应用 diff。
入口四：Cloud
Cloud 把任务放到 OpenAI 的云端隔离环境中执行。你通常需要连接 GitHub 仓库，云端任务会拉取指定分支或提交，准备环境，运行 Codex，最后返回结果、diff 或 Pull Request。 参考材料将云端任务拆成了一个清楚的流程：- 连接并选择 GitHub 仓库；
- 创建云端容器并拉取代码；
- 运行设置脚本，安装依赖和工具；
- 在默认受限的网络环境中执行任务；
- 返回说明和 diff，由你决定是否提 PR、审查和合并。
怎么选入口
新手推荐顺序是：先用桌面 App 或 IDE 扩展建立体感，再学习 CLI；等需要后台并行或跨机器执行时，再使用 Cloud。
四种入口能否共用配置
项目级的AGENTS.md 是最适合跨入口复用的规则文件。CLI、桌面 App 和 IDE 扩展也通常共享登录状态、项目规则以及部分用户配置，但具体功能取决于版本和登录方式。
要特别区分：
- 项目规则可以随仓库共享：例如测试命令、代码约定和禁止修改的目录；
- 本机工具不会自动出现在 Cloud：需要在云端环境中重新配置；
- 未提交的本地改动不会自动出现在 Cloud：要显式选择带本地改动运行，或先提交并推送；
- 入口相同不代表运行位置相同：IDE 的本地模式和 Cloud 是两种不同的执行边界。
小结
- 桌面 App 适合图形化审查、并行线程和 Worktree；
- CLI 适合终端、服务器、脚本和 CI；
- IDE 扩展适合直接利用编辑器上下文；
- Cloud 适合隔离、并行和后台任务，但只看得到授权的远程仓库；
- 选择入口时先看任务需要访问哪里、是否需要人在场、是否要并行。