产品入口
基于官方 Codex 产品教程，帮新手分清 CLI、IDE、App、Web、Windows 和自动化入口各自适合什么任务。
这一章不是安装清单，而是入口选择手册。先判断任务发生在哪里，再决定用 CLI、IDE、App、Cloud、Windows 还是自动化入口。
Codex 有多个产品入口：CLI、桌面 App、Web / Cloud、IDE 扩展、Windows 入口，以及 Worktrees、App Server、Automations、Computer Use 等配套能力。新手不要按“哪个功能最多”选择，而要按执行位置、审查方式和权限边界选择。
flowchart TB
Task[当前任务] --> Where{任务在哪里发生}
Where --> Terminal[终端和本地仓库]
Where --> IDE[编辑器现场]
Where --> App[多任务审查和可视化工作流]
Where --> Cloud[异步远程环境]
Where --> Windows[Windows 开发环境]
Terminal --> CLI[CLI / codex exec]
IDE --> Extension[IDE extension]
App --> Desktop[Codex App]
Cloud --> Web[Codex Cloud]
Windows --> Win[Windows App / Windows CLI]按任务选入口
终端和脚本
本地仓库、命令行工作流、codex exec、CI 前置实验，优先从 CLI 开始。
编辑器现场
边读代码边改局部文件，优先看 IDE 安装、功能、设置和命令。
多任务可视化
需要 review、worktree、automations、内置浏览器和任务面板，优先看 Codex App。
异步远程任务
长任务、云端运行、GitHub 触发或不占用本机资源，进入 Cloud / Web 章节。
Windows 环境
在 Windows 上使用 Codex 时，重点检查 shell、路径、sandbox 和权限差异。
自动化与工作树
需要定时、并行、可回滚分支或 app server，再看 Automations、Worktrees 和 App Server。
章节速查
CLI 相关：使用命令行版、CLI 斜杠命令、CLI 功能、CLI 参数、非交互任务。
IDE 相关：安装 IDE 扩展、IDE 功能、IDE 设置、IDE 命令、IDE 斜杠命令。
桌面 App 相关：桌面版、App Server、App 核心、App 设置、Automations、内置浏览器、App 命令、Computer Use、本地运行环境、App Review、App 排障、Worktrees。
Web / Windows 相关：网页版、Windows 版 App、Windows 上使用 Codex。
入口判断
如果你每天都在终端里开发，先用 CLI。它最接近仓库现场，也最容易和已有脚本、测试、CI 思维衔接。
如果你主要在 VS Code、Cursor、Windsurf 或同类编辑器里读写代码，先用 IDE 扩展。它适合局部上下文和边看边改。
如果你要同时跟进多个任务、看 diff、用 worktree、跑 automations，先用桌面 App。它的价值在任务管理和审查面，不只是“另一个聊天窗口”。
如果任务很长、可以异步等待、适合云端环境，先用 Web / Cloud。涉及本机密钥、本机 GUI、本机未提交状态时要重新评估。
如果要接 CI、定时任务或脚本，直接看 non-interactive mode、GitHub Action 和 CI/CD auth，不要把交互式 prompt 硬塞进无人值守环境。
新手常见坑
- 一次装太多入口，哪个都没跑通。
- 用 Cloud 处理必须依赖本机密钥和本机状态的任务。
- 用 CLI 做需要大量可视化 review 的任务。
- 用 App automations 处理还没手动验证过的 prompt。
- 忽略入口背后的执行环境：本机、云端、远程、worktree 的文件状态可能不同。
怎么验收入口选对了
- 能说清 Codex 在哪里读文件、在哪里执行命令、在哪里产生 diff。
- 能在该入口里完成一次只读理解项目任务。
- 能完成一个小改动，并找到 diff 和验证结果。
- 能知道任务失败时该查本地环境、IDE 集成、App 设置、Cloud 环境还是 CI runner。
配套从原理到实战
接下来去哪
CLI 功能
先理解终端入口能做什么，再决定是否进入非交互任务。
IDE 功能
查看编辑器里可用的上下文、命令、审查和交互方式。
Codex App 核心
理解桌面 App 的任务面板、review、automation 和多项目工作流。
非交互任务
把人工对话改成可脚本化、可记录、可失败处理的 codex exec 流程。