Codex 有三种常用形态：终端里用的 Codex CLI、装在编辑器里的 IDE 扩展（VS Code、Cursor、Windsurf 等），以及 桌面版（现在集成在 ChatGPT 桌面 App 里）。三者的下载地址都在 OpenAI 官方，下面按形态列出官方来源，避免下到来路不明的“Codex 安装包”。
本文只讲“从哪下、下哪个”。下载后的详细安装步骤看 Codex 安装教程，装好后怎么干活看 Codex 怎么用。
三种形态的官方下载地址
| 形态 | 官方下载来源 | 适合谁 |
|---|---|---|
| Codex CLI | 官方安装脚本、npm 包 @openai/codex、Homebrew、GitHub Releases | 习惯终端、要写脚本或接 CI 的开发者 |
| IDE 扩展 | VS Code 插件市场，扩展 ID openai.chatgpt | 想在编辑器侧边栏里直接改代码的人 |
| 桌面版 | ChatGPT 桌面 App：chatgpt.com/download | 想用图形界面管理多个项目的人 |
Codex CLI 下载
CLI 有四个官方来源，任选其一即可。
1. 官方安装脚本（OpenAI 文档首推）
macOS / Linux：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows（PowerShell）：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
据 OpenAI 的 GitHub 仓库说明，安装脚本默认从 releases.openai.com/codex 下载，失败时自动回退到 GitHub Releases。
2. npm
已经装了 Node.js 的话，用 npm 最省事：
npm install -g @openai/codex
注意包名是 @openai/codex，带 @openai/ 前缀。npm 上名字相近的其他包不是官方的。
3. Homebrew（macOS）
brew install --cask codex
4. GitHub Releases 直接下二进制
打开 github.com/openai/codex/releases/latest，按平台选文件：
- Apple Silicon Mac：
codex-aarch64-apple-darwin.tar.gz - Intel Mac：
codex-x86_64-apple-darwin.tar.gz - Linux x86_64：
codex-x86_64-unknown-linux-musl.tar.gz - Linux arm64：
codex-aarch64-unknown-linux-musl.tar.gz
解压后把文件改名为 codex，放进 PATH 里的目录。
下载完成后在终端输入 codex 能启动，就说明拿到的是正确版本。Node 版本、PATH、权限报错等问题，在 Codex 安装教程 里有分系统的处理方法。
Codex VS Code 插件下载
官方扩展在 VS Code 插件市场，名称 Codex，发布者 OpenAI，扩展 ID 是 openai.chatgpt：
- 网页地址：marketplace.visualstudio.com/items?itemName=openai.chatgpt
- 也可以在 VS Code 扩展面板里搜索
openai.chatgpt
Cursor、Windsurf 用的是同一个扩展。Xcode 和 JetBrains 系列 IDE 不装这个插件，而是在各自自带的 AI 助手里选择 Codex。
装好后点侧边栏的 Codex 图标；看不到图标时，打开命令面板运行 Codex: Open Codex Sidebar。
Codex 桌面版下载
Codex 桌面版现在集成在 ChatGPT 桌面 App 里：
- macOS / Windows：从 chatgpt.com/download 下载 ChatGPT 桌面 App
- Linux：按 OpenAI 的 Linux 安装指南操作
打开 App 登录后，选择 Codex 并新建对话，就能打开本地项目文件夹干活。已经装了 CLI 的话，也可以在终端运行 codex app 打开桌面版。
下载后下一步
- 按 Codex 安装教程 完成安装和检查；
- 按 Codex 怎么用 跑完第一个任务；
- 想用 API Key 而不是 ChatGPT 账号登录，看 Codex API Key 怎么配置。
如果你在国内，或者想用一个 Key 同时调 Codex 和其他模型，可以接入 AICodeWith：
常见问题
npm 上哪个才是官方 Codex 包？
@openai/codex。安装命令是 npm install -g @openai/codex。
VS Code 里搜 Codex 出来好几个，装哪个？
装发布者为 OpenAI、扩展 ID 为 openai.chatgpt 的那个。
桌面版需要单独下载 Codex 吗？
不需要。Codex 桌面版就在 ChatGPT 桌面 App 里，下载 ChatGPT 桌面 App 即可。
GitHub 下载太慢怎么办？
官方安装脚本默认先走 releases.openai.com，通常比直接下 GitHub Releases 快。也可以改用 npm 安装。
资料来源
- OpenAI Codex CLI 文档：developers.openai.com/codex/cli
- OpenAI Codex IDE 扩展文档：developers.openai.com/codex/ide
- OpenAI 桌面 App 文档：developers.openai.com/codex/app
- GitHub 仓库：github.com/openai/codex
