| description | Codex 入口地图，比较 CLI、桌面 App、Cloud、IDE、ChatGPT 和集成生态，帮助选择合适工作入口。 |
|---|
CodexGuide 把 Codex 看成一组入口协同的工作系统。学习时不要只盯着某一个界面；真正影响效率的是：你把什么任务放在哪个入口里处理。
::: tip 最后核对 官方资料最后核对日期：2026-05-27。参考 OpenAI Codex 产品页、Codex 文档入口、Codex CLI 官方仓库 与 Codex in ChatGPT Help Center。 :::
| 入口 | 更适合 | 典型任务 | 学习优先级 |
|---|---|---|---|
| CLI | 本地快速迭代 | 修 bug、补测试、跑命令、解释仓库 | 新手优先 |
| 桌面 App | 本地多任务工作台 | 多 agent、Skills、Automations、插件协作 | 进阶优先 |
| Cloud / Web | 较长任务和并行任务 | 仓库任务、PR、后台分析 | 团队优先 |
| IDE | 编辑器上下文 | 局部修改、解释、代码审查 | 日常高频 |
| ChatGPT 中的 Codex | 面向仓库的任务分派 | 连接 GitHub、理解仓库、协作推进 | 按账号能力选择 |
- 任务需要频繁看命令输出：选 CLI。
- 任务需要多个 agent 并行、Skills 或 Automations：选择桌面 App。
- 任务时间较长、希望后台跑、可能生成 PR：选 Cloud / Web。
- 你正在编辑具体文件：选 IDE。
- 你想从对话里分派仓库级任务：选 ChatGPT 中的 Codex。
- 从 CLI 建立最小闭环。
- 用桌面 App 体验本地多任务和技能沉淀。
- 再进入 Cloud / Web，学习长任务、PR 与团队协作。
- 阅读 配置与扩展，补上 CLI 选项、config.toml、MCP、Skills 和安全边界。
- 把高频模板沉淀到
AGENTS.md、案例库和团队规范。
| 配置主题 | 主要影响入口 | 学习页 |
|---|---|---|
AGENTS.md |
CLI / 桌面 App / Cloud | AGENTS.md |
| CLI 选项 | CLI | CLI 选项与命令 |
config.toml |
CLI | 配置文件 config.toml |
| Skills | App / CLI | MCP、Skills 与 Subagents |
| Worktrees | 桌面 App | 桌面 App |
| Environments | Cloud / App | Cloud / Web |
| Sandbox 与 Approvals | 全部入口 | 安全、审批与管理 |
::: info 截图占位
后续请补充一张“各入口首页/启动界面拼图”。建议文件：docs/.vuepress/public/screenshots/platform/00-surfaces-collage.png。
:::