Codex 入口地图

CodexGuide 把 Codex 看成一组入口协同的工作系统。学习时不要只盯着某一个界面；真正影响效率的是：你把什么任务放在哪个入口里处理。

最后核对

官方资料最后核对日期：2026-05-27。参考 OpenAI Codex 产品页、Codex 文档入口、Codex CLI 官方仓库 与 Codex in ChatGPT Help Center。

这页解决什么

很多新手卡住，不是因为不会点按钮，而是不知道“这个任务应该从哪里开始”。同一个 Codex，可以出现在 CLI、桌面 App、Cloud、IDE 和 ChatGPT 里；入口不同，适合的任务和风险边界也不同。

这一页帮你先做入口选择：先用低风险入口跑通任务，再逐步进入更复杂的配置和团队协作。

适合谁

• 还分不清 CLI、桌面 App、Cloud、IDE 和 ChatGPT 中 Codex 区别的人。
• 想给团队成员安排统一学习路径的人。
• 已经会用一个入口，但不知道什么时候该换另一个入口的人。

工作流卡

输入	过程	输出	验收
你的任务类型、材料位置、风险等级	判断任务需要本地文件、仓库、长任务、编辑器还是对话分派	选择一个主入口和一个验证方式	能说清“为什么用这个入口”，并跑通一个低风险任务

入口对照表

入口	更适合	典型任务	学习优先级
CLI	本地快速迭代	修 bug、补测试、跑命令、解释仓库	新手优先
桌面 App	本地多任务工作台	多 agent、Skills、Automations、插件协作	进阶优先
Cloud / Web	较长任务和并行任务	仓库任务、PR、后台分析	团队优先
IDE	编辑器上下文	局部修改、解释、代码审查	日常高频
ChatGPT 中的 Codex	面向仓库的任务分派	连接 GitHub、理解仓库、协作推进	按账号能力选择

如何选择入口

• 任务需要频繁看命令输出：选 CLI。
• 任务需要多个 agent 并行、Skills 或 Automations：选择桌面 App。
• 任务时间较长、希望后台跑、可能生成 PR：选 Cloud / Web。
• 你正在编辑具体文件：选 IDE。
• 你想从对话里分派仓库级任务：选 ChatGPT 中的 Codex。

第一次学习建议

1. 从 CLI 建立最小闭环。
2. 用桌面 App 体验本地多任务和技能沉淀。
3. 再进入 Cloud / Web，学习长任务、PR 与团队协作。
4. 阅读 配置与扩展，补上 CLI 选项、config.toml、MCP、Skills 和安全边界。
5. 把高频模板沉淀到 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	全部入口	安全、审批与管理

你要重点检查什么

• 任务材料在哪里：本地文件、GitHub 仓库、网页、设计稿，还是聊天上下文。
• 任务风险多高：只读分析、改文档、改代码、联网、发布、删除文件，风险完全不同。
• 验证方式是否明确：CLI 适合跑命令，桌面 App 适合多任务，Cloud 适合长任务和 PR。
• 人在哪个节点判断：入口只是工具，验收仍然要回到输出、diff、截图、测试或审批。

验收标准

看完这一页后，你应该能做到：

• 为一个真实任务选择主要入口，并说清理由。
• 知道什么时候先用 CLI / 桌面 App，什么时候再进入 Cloud / IDE。
• 知道入口选择会影响权限、验证方式和交付节奏。
• 把入口选择写进自己的任务卡或工作流护照。

后续配图建议

后续可以补一张“各入口首页 / 启动界面拼图”，用于课堂展示入口差异。建议文件：docs/.vuepress/public/screenshots/platform/00-surfaces-collage.png。这张图不是当前学习路径的阻塞项；没有配图时，先以入口对照表完成学习。