Codex 包含在所有 ChatGPT 套餐里，也支持通过 OpenAI API Key 使用。本文覆盖四种入口的上手步骤：桌面 App（推荐）、IDE 扩展（在编辑器里用）、CLI（在终端里用）、Cloud（在浏览器里用）。选择你最顺手的方式，5 分钟内完成配置并发出第一条指令。

Codex 快速上手

Codex 包含在所有 ChatGPT 套餐里。如果你想用 API 积分，也可以用 OpenAI API Key 登录。

---

选择使用方式

Codex 提供四种入口，按你的工作习惯选择：

方式	适合场景	支持平台
App（推荐）	日常编码主力，完整功能	macOS、Windows
IDE 扩展	不离开编辑器	VS Code、Cursor、Windsurf
CLI	终端驱动、CI/脚本集成	macOS、Windows、Linux
Cloud	浏览器直接用、委托后台任务	所有平台（浏览器）

---

Codex App（推荐）

安装步骤

1. 下载并安装 Codex App

   从官网下载 macOS 或 Windows 安装包。Intel 芯片 Mac 用户请选择 Intel 版本。

   Linux 版本尚在开发中，可以注册通知。

2. 打开 Codex 并登录

   安装完成后打开 App，用 ChatGPT 账号或 OpenAI API Key 登录。

   用 API Key 登录时，云端线程等部分功能不可用。

3. 选择项目

   选择一个你想让 Codex 工作的项目目录。如果之前用过 Codex App、CLI 或 IDE 扩展，会看到历史项目列表。

4. 发出第一条指令

   选好项目后，确认左下角选择的是 Local（本地执行），然后输入你的第一条指令。

   示例：

   • 告诉我这个项目的结构
   • 在这个仓库里实现一个经典贪吃蛇游戏
   • 找出并修复代码库里的 bug，改动最小化

---

IDE 扩展

在编辑器里直接使用 Codex，无需切换窗口。

安装步骤

1. 安装扩展

   • Visual Studio Code
   • Cursor
   • Windsurf

2. 打开 Codex 面板

   安装后 Codex 出现在侧边栏（可能在折叠区域，需要滚动找）。可以把面板拖到右侧边栏。

3. 登录并开始任务

   用 ChatGPT 账号或 API Key 登录。默认是 Agent 模式，Codex 可以读文件、运行命令、在项目目录里写改动。

4. 用 Git 存档

   Codex 会修改代码，建议在每次任务前后创建 Git checkpoint，方便随时回滚。

---

CLI

适合终端用户和 CI/自动化场景。

安装

# npm 安装
npm install -g @openai/codex

# 或 Homebrew
brew install codex

步骤

1. 运行 codex 并登录

   在终端里输入 codex，按提示用 ChatGPT 账号或 API Key 登录。

2. 在项目目录里提任务

   登录后，进入你的项目目录，开始输入任务描述：

   cd my-project
   codex

   示例指令：

   • 介绍一下这个项目
   • 修复所有 TypeScript 类型错误

3. 用 Git 存档

   同 IDE 扩展，建议每次任务前后建 checkpoint。

---

Cloud（浏览器）

在 chatgpt.com/codex 直接使用，无需本地安装。

步骤

1. 打开浏览器，访问 chatgpt.com/codex

   也可以在 GitHub PR 里评论 @codex 触发 Codex（需要在 ChatGPT 登录）。

2. 配置环境

   首次使用前，在 环境设置页 配置一个环境，连接你的 GitHub 仓库。

3. 发起任务并监控进度

   环境准备好后，从 Codex 界面发起任务，可以实时查看日志，也可以让任务在后台跑。

4. 审查改动并创建 PR

   任务完成后，在 diff 视图里审查改动，可以直接创建 GitHub PR，或 checkout 到本地测试：

   git fetch
   git checkout <branch-name>

---

常见问题

Q: Codex App 和 IDE 扩展有什么区别，该选哪个？

A: App 是独立桌面程序，功能最全（线程管理、Worktree、完整 Review 面板）；IDE 扩展内嵌在你的编辑器里，适合习惯不切窗口的开发者。两者共享配置和历史线程，可以配合使用。

Q: 用 API Key 和 ChatGPT 账号登录有什么区别？

A: ChatGPT 账号包含套餐额度，云端功能（GitHub Code Review、Slack 集成、Cloud 任务）都可用；API Key 只支持本地使用，云端功能不可用，按 token 消耗计费。

Q: 我应该先用哪个入口试一试？

A: macOS/Windows 用户推荐先装 Codex App，功能最完整；如果你大部分时间在 VS Code 里，装 IDE 扩展更顺畅；只想在终端里用的，直接 npm install -g @openai/codex。