产品入口
基于官方 Codex 产品教程,帮新手分清 CLI、IDE、App、Web、Windows 和自动化入口各自适合什么任务。
Codex 有多个入口:CLI、桌面 App、Web、IDE 扩展,以及 Windows、Worktrees、App Server、Automations 等平台能力。新手不要从“哪个功能最多”开始选,而要从“我现在的任务在哪里发生”开始选。
先理解:入口不是越多越好
CLI 适合终端用户、本地仓库任务、脚本化和 codex exec 自动化。
IDE 扩展适合边看代码边让 Codex 修改,适合日常开发和局部文件上下文。
桌面 App 适合多项目、多 Agent、review、automation、worktree、内置浏览器和更完整的可视化工作流。
Web / Cloud 适合异步长任务、远程环境和不想占用本机的任务。
Windows 入口适合在 Windows 开发环境里直接使用 Codex,但要关注 sandbox、shell、路径和权限差异。
怎么判断先用哪个入口
如果你每天都在终端里开发,先用 CLI。
如果你主要在 VS Code、JetBrains 或其他 IDE 里读写代码,先用 IDE 扩展。
如果你要同时跟进多个任务、看 diff、用 worktree、跑 automations,先用桌面 App。
如果任务很长、可以异步等待、适合云端环境,先用 Web / Cloud。
如果你要接 CI、定时任务或脚本,直接看 non-interactive mode 和 GitHub Action。
新手最多先选 1 到 2 个入口。四个入口都装,只会增加认知负担。
章节速查
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。
新手常见坑
- 一次装太多入口,哪个都没跑通。
- 用 Cloud 处理必须依赖本机密钥和本机状态的任务。
- 用 CLI 做需要大量可视化 review 的任务。
- 用 App automations 处理还没手动验证过的 prompt。
- 忽略入口背后的执行环境:本机、云端、远程、worktree 的文件状态可能不同。
怎么验收入口选对了
你能说清 Codex 在哪里读文件、在哪里执行命令、在哪里产生 diff。
你能在该入口里完成一次只读理解项目任务。
你能完成一个小改动,并找到 diff 和验证结果。
你能知道任务失败时该查本地环境、IDE 集成、App 设置、Cloud 环境还是 CI runner。