快速上手 9 步
这组教程面向第一次学习 Codex 的读者，循序渐进地带你开始使用。学完你能做到：安装并打开桌面 App、把本地文件夹交给 Codex、写出目标/范围/验证都清楚的任务说明、检查改动并决定继续或停止。
1
Codex 是什么
了解 Codex 的多产品形态：桌面 App、CLI、Web 云端、IDE，以及各自适合的典型任务。
2
Codex 桌面 App 下载与安装
在 macOS / Windows 上安装官方客户端，登录 ChatGPT 账号。
3
订阅 ChatGPT Plus / Pro
完整功能（多 agent、Skills、Automations）需要 Plus 及以上套餐。
4
连接第三方 API
配置可选第三方模型或 API key，扩展可用模型与能力。
5
了解 Codex 基本组成
熟悉 App 的 Projects、Chats、权限与任务执行入口。
6
用 Codex 完成第一个任务
以“开发一个 AI 发展历史网页”为例，走完一次完整任务闭环。
7
任务设计
把目标、范围、验证方式写清楚，让 Codex 知道什么时候算做好。
8
任务执行与验证闭环
检查 Codex 的改动，知道何时继续追问、何时停止。
9
用手机远程操控 Codex
移动端查看进度、补充指令，把任务交给云端后台跑。
给开发者：CLI / IDE / Cloud
很多时候 Codex App 就能满足需求。但如果你具备开发基础，可以尝试 CLI、IDE 或 Cloud 更深入地使用 Codex：
| 路径 | 适合场景 | 入口 |
|---|---|---|
| CLI | 终端迷、Vim / tmux 用户，本地快速迭代修 bug、补测试、跑命令 | 安装 CLI |
| IDE | 在编辑器上下文里做局部修改、解释、代码审查 | VS Code 扩展 |
| Cloud | 长任务、并行任务、生成 PR、后台分析 | Codex Cloud |
10
安装 CLI
npm install -g @openai/codex，在本地仓库中登录。
11
运行 CLI
进入项目目录运行 codex，先做一次只读仓库分析。
12
CLI 选项与命令
/init /review /permissions 等，配合 config.toml 调配置。
13
在 VS Code 中使用 Codex
用编辑器已打开的代码与上下文直接对话。
14
使用 Codex Cloud
在并行云环境运行编码任务，结果带回本地。
💡 建议学习顺序：先以 CLI 建立最小闭环 → 用桌面 App 体验多任务与技能沉淀 → 再进 Cloud / Web 学长任务与团队协作。
学完你能做到什么
- 知道 Codex 的主要入口和适合场景。
- 能安装并打开桌面 App。
- 能把一个本地文件夹交给 Codex 处理。
- 能写出目标、范围、验证方式都清楚的任务说明。
- 能检查 Codex 的改动，知道什么时候继续追问或停止。
- 能用 CLI、VS Code 和 Cloud 进入更真实的项目任务。