Codex 不是只有一个入口。入口选错了，后面教程再详细也会别扭。
> 前置教程：Codex 是什么
> 如果你还不清楚 Codex 的定位和边界，先完成前置教程。
> 依据来源：OpenAI Codex 官方手册中关于 CLI、IDE extension、Codex app、Codex cloud、配置层和沙箱的说明。
新手第一次学习，建议这样选：
| 你现在的情况 | 推荐入口 |
| ------------------------ | ------ |
| 完全新手，不想一直面对终端 | 桌面版 |
| 会用终端，要在本地项目里改代码 | CLI |
| 正在 VS Code / Cursor 里看代码 | IDE 扩展 |
| 想让任务在远程环境里跑，或者并行处理 | Cloud |
本站的主线会同时覆盖桌面版和 CLI，但项目实战会更偏向 本地项目闭环：读项目、改代码、看 diff、验收、提交前检查。
桌面版是一个独立 App。
适合：
- 新手入门。
- 多任务管理。
- 看 diff 和审批。
- 需求拆解。
- 代码审查。
- 不想频繁切换终端的人。
你可以把桌面版理解成“有图形界面的 Codex 工作台”。
CLI 是在终端里运行的 Codex。
适合：
- 本地仓库。
- 真实项目改代码。
- 运行构建和测试。
- 查看 Git 状态。
- 和现有开发流程结合。
你可以把 CLI 理解成“项目目录里的 Codex 助手”。
IDE 扩展是在 VS Code、Cursor 等编辑器里使用 Codex。
适合：
- 边看代码边问。
- 解释当前文件。
- 解释选中代码。
- 小范围修改。
- 从编辑器里发起任务。
官方手册说明，IDE 扩展会自动把打开的文件和选中范围作为上下文；而 CLI 通常需要你更明确地告诉 Codex 文件路径。
Cloud 是让 Codex 在远程隔离环境里处理任务。
适合：
- 长任务。
- 并行任务。
- 远程环境。
- 另一台设备发起任务。
- 不想占用本机环境的任务。
但 Cloud 对仓库、GitHub、环境配置、权限和安全要求更高，不建议完全新手第一步就从 Cloud 开始。
如果你是完全新手，建议：
``
桌面版 -> 选择练习项目 -> 只读分析 -> 配置模型 -> 小任务实战
`
原因是：
- 桌面版更直观。
- 更容易看到项目、会话和结果。
- 不需要一开始就理解很多终端细节。
但你仍然需要学一些基础概念：
- 项目目录。
- Git 状态。
- diff。
- API Key。
- 模型配置。
这些不是 Codex 特有的难点，而是真实项目交付必须懂的底线。
如果你已经会用 PowerShell、Git、npm、Maven 或其他命令，建议：
`
CLI -> 配置模型 -> 只读读项目 -> 小范围改代码 -> 验收 -> 提交前检查
``
原因是：
- CLI 最贴近真实本地开发流程。
- Codex 可以在当前项目目录里读写文件。
- 构建、测试、Git 状态更容易串起来。
- 很适合形成稳定交付闭环。
但注意：CLI 不是让你手动执行一堆命令。实际使用中，很多检查可以由 Codex 根据任务自己执行，你的重点是写清楚目标、范围、禁止事项和验收标准。
如果你正在编辑器里打开一个文件，问题只跟眼前这段代码有关，优先用 IDE 扩展。
比如：
- 解释这个函数。
- 解释这段报错。
- 修改当前组件样式。
- 给选中的函数补注释。
- 帮我理解当前文件和相邻文件关系。
这时候 IDE 比 CLI 更顺手，因为上下文就在编辑器里。
下面这些任务更适合 Cloud：
- 你想让 Codex 在后台跑较长时间。
- 你想并行尝试多个方案。
- 你要从另一台设备发起任务。
- 你希望任务运行在隔离环境里。
- 你的仓库已经连接 GitHub，并且 Cloud 环境已经配好。
不建议把 Cloud 当成第一入口。
原因是：
- 它依赖远程仓库和环境配置。
- 出错时排查层级更多。
- 新手容易分不清是代码问题、环境问题、权限问题还是 Cloud 配置问题。
你可以记这 4 句话：
- 看得见、管得住、多任务：桌面版。
- 本地项目、构建测试、Git 闭环：CLI。
- 当前文件、选中代码、边看边问：IDE。
- 远程执行、长任务、并行处理：Cloud。
Cloud 不是新手必经入口。
它适合有远程环境和仓库流程的人。
桌面版不只是新手工具。
它适合做计划、审查、多线程任务和结果管理。
IDE 对当前文件和选中代码很方便，但如果任务涉及整个项目、构建和 Git 状态，CLI 或桌面版可能更稳。
入口解决“你在哪里使用 Codex”。
模型配置解决“Codex 背后用哪个模型服务”。
它们有关联，但不是同一个问题。
看完后，你应该能回答：
- 我现在应该从哪个 Codex 入口开始。
- 为什么新手可以先用桌面版。
- 为什么真实本地项目实战常用 CLI。
- 为什么 IDE 适合当前文件和选中代码。
- 为什么 Cloud 不建议作为完全新手第一入口。
---
下一步：账号与订阅方案 —— 了解 Plus/Pro 订阅流程及国际支付方式。