快速上手 · 第 1 步
Codex 是什么
官方资料核对 2026-05
Codex 是一个具备多个产品形态的 Agent,涵盖桌面端 App、CLI、Web 云端、IDE。选择一个入口,把任务聊清楚,结果就出来了。
入口对照表
| 入口 | 更适合 | 典型任务 | 学习优先级 |
| 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,补上配置基本功。
- 把高频模板沉淀到
AGENTS.md、案例库和团队规范。
入口和配置的关系
| 配置主题 | 主要影响入口 |
AGENTS.md | CLI / 桌面 App / Cloud |
| CLI 选项 | CLI |
config.toml | CLI |
| Skills | App / CLI |
| Worktrees | 桌面 App |
| Environments | Cloud / App |
| Sandbox 与 Approvals | 全部入口 |
💡 不确定选哪个?先选 CLI 跑通一个只读任务,最快建立“它真的能读我的仓库”的信心。