Codex 下载安装教程。
Codex 是 OpenAI 的编程 agent，可以在 ChatGPT 桌面应用里用，也可以通过 Codex CLI 在终端里用，或者在代码编辑器里用。这篇教程只给出 OpenAI 的官方下载地址，并逐一讲清楚每种安装方式。说明一下：Codex Design 是 Codex 的一个独立插件，不是 OpenAI 的官网。
更新于 2026年11月6日 · 阅读约 6 分钟
该装哪个 Codex？
| 方式 | 运行在 | 适合 |
|---|---|---|
| ChatGPT 桌面应用 | macOS、Windows、Linux（预览版） | 大多数人：项目、本地文件和 Codex 都在一个应用里 |
| Codex CLI（命令行） | macOS、Linux 和 Windows 的终端 | 习惯在终端里工作、要做自动化的开发者 |
| Codex 编辑器插件 | VS Code、Cursor、Windsurf | 在代码旁边直接用 Codex |
| 网页版 ChatGPT | 任何浏览器，chatgpt.com | 不用安装；云端任务 |
Codex 的官网是 openai.com/codex 和 chatgpt.com/codex。请只从 OpenAI 官方下载。
安装 ChatGPT 桌面应用（内置 Codex）
Codex 现在运行在 ChatGPT 桌面应用里。官方下载页面是 chatgpt.com/download。
- Mac： Codex 页面上的 macOS 安装包适用于 Apple 芯片。打开下载好的文件，把应用拖进「应用程序」。
- Windows： 在微软应用商店（Microsoft Store）安装 ChatGPT 桌面应用。喜欢用命令行的话，在 PowerShell 里运行：
winget install --id 9PLM9XGG6VKS -s msstore
- Linux（预览版）： OpenAI 提供 Ubuntu 24.04、26.04 和 Debian 13 的
.deb安装包，Fedora 43、44 的.rpm安装包，以及 Arch Linux 的安装脚本，x64 和 ARM64 都有。按照 OpenAI 的 Linux 桌面应用说明 安装。
然后：
- 打开应用，用 ChatGPT 账号登录。也可以用 API key 使用 Codex，但部分功能可能用不了。
- 在 ChatGPT 下拉菜单里选择 Codex 来写代码。打开一个项目文件夹，Codex 就能读取和修改里面的文件。
- 发出第一个任务，比如：「介绍一下这个项目」。
安装 Codex CLI（命令行）
任选一种方式，每种都有对应的更新命令。
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"
npm：
npm install -g @openai/codex
Homebrew：
brew install --cask codex
更新时，再运行一次同样的安装命令即可。用 npm 安装的，再运行一次 npm install -g @openai/codex；用 Homebrew 安装的，运行 brew upgrade --cask codex。
装好后，进入一个项目目录，运行 codex，选择 Sign in with ChatGPT（用 ChatGPT 登录）或其他登录方式。
cd my-project
codex
安装编辑器插件
- VS Code、Cursor 和 Windsurf： 在 VS Code 插件市场 或编辑器的扩展面板里安装 Codex 插件，然后点 Codex 图标。如果没看到图标，在命令面板里运行 Codex: Open Codex Sidebar。
- Xcode 和 JetBrains IDE： 它们有各自的 Codex 集成。在 Xcode 里，在编程助手中选择 Codex 作为 agent；在 JetBrains IDE 里，打开 AI Chat 并选择 Codex。
常见问题排查
- 装完 CLI 后提示
codex: command not found。 打开一个新的终端窗口，让终端识别新命令，然后再试一次。 - Windows 上安装脚本运行不了。 按 OpenAI 的说明，从一个新的 PowerShell 窗口里运行。
- 不确定装好了没有？ 在项目文件夹里运行
codex，问它「介绍一下这个项目」。能正常回答就说明装好了。
装好之后：加一个设计画布
Codex 不只会写代码，也能设计界面。Codex Design 是一个独立插件，给 Codex 加上可视化画布：界面和参考图并排摆放，还能可视化地修改字体、颜色和间距。一句提示词就能安装，见安装说明，在 ChatGPT 桌面应用和 Codex CLI 里都能用。
常见问题
Codex 官网是哪个？
openai.com/codex 和 chatgpt.com/codex。桌面版下载在 chatgpt.com/download。codexdesign.io 与 OpenAI 没有关联。
Codex 应用和 ChatGPT 是一回事吗？
Codex 应用现在已经并入 ChatGPT 桌面应用。安装 ChatGPT 并登录，写代码时选择 Codex 就行。
装了桌面版，还需要装命令行版吗？
不需要。如果你习惯在终端里工作，或者想在脚本里运行 Codex，再装 CLI。