Codex 怎么安装：ChatGPT 桌面版、Codex CLI 与 IDE 插件官方步骤（2026）
大约 3 分钟CodexCodex安装Codex CLICodex下载Codex VS Code
一句话结论
不写代码命令行的人，装 ChatGPT 桌面版就有 Codex；习惯终端的，装 Codex CLI；在编辑器里写代码的，装 IDE 插件。 三种方式都用 ChatGPT 账号登录。
阅读说明
官方信息查阅日期：2026-10-24。安装命令来自 Codex 官方文档和 OpenAI 官方 GitHub 仓库 openai/codex，命令会更新，以官方原文为准。只从官方渠道下载。
方式一：ChatGPT 桌面版（推荐）
OpenAI 官方 Quickstart 推荐用 ChatGPT 桌面版，它支持 macOS、Windows 和 Linux。
- 从 ChatGPT 官方下载页安装桌面版（Windows 见 Windows 桌面版下载安装）；
- 打开 App，用 ChatGPT 账号登录；
- 从左上角菜单选 Codex；
- 打开一个项目文件夹，开始对话。
桌面版里的 Codex 历史记录和 ChatGPT 对话分开。已经在用旧版 Codex App 的，官方说明照常更新即可迁移到新的 ChatGPT 桌面版。
方式二：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
官方 GitHub Releases 也提供各平台的二进制文件。
登录
在项目目录运行 codex。第一次运行时选 Sign in with ChatGPT，用 ChatGPT 套餐的额度。也可以用 API Key 登录，按 API 计费，需要额外设置。
更新
用官方安装脚本安装的，再运行一次同一条安装命令即可更新。npm 和 Homebrew 安装的，用各自的升级命令。
常用命令
| 命令 | 作用 |
|---|---|
codex | 在当前目录启动交互会话 |
/init | 生成 AGENTS.md 项目说明 |
/status | 查看当前会话配置和剩余额度 |
/permissions | 设置 Codex 能不能自动改文件、跑命令 |
/model | 切换模型和推理强度 |
/review | 审查改动 |
codex resume | 回到之前的会话 |
codex exec | 非交互运行，用于脚本和 CI |
方式三：IDE 插件
官方文档列出的支持：
- VS Code、Cursor、Windsurf、VS Code Insiders：安装 Codex 插件，点侧边栏的 Codex 图标；看不到时在命令面板运行
Codex: Open Codex Sidebar； - Xcode：打开 coding assistant，新建对话，选 Codex 作为 agent；
- JetBrains IDE：打开 AI Chat，选 Codex。
官方帮助中心说明，Codex VS Code 插件兼容大部分 VS Code 衍生编辑器；其他 IDE 可以在内置终端里运行 Codex CLI。
装好了用不了？
- 登录后看不到 Codex：工作区账号可能被管理员关闭了 Codex Local 或 Codex Cloud 权限，先问管理员；
- 提示额度用完：见 Codex 用量限制；
- 一直 Reconnecting、
stream disconnected before completion：见 Codex stream disconnected 怎么办； - 桌面版打不开或已意外停止：见 ChatGPT 已意外停止。
相关阅读
参考来源（官方）
- Codex 官方文档 · Quickstart：https://developers.openai.com/codex/quickstart（查阅日期：2026-10-24）
- Codex 官方文档 · Codex CLI：https://developers.openai.com/codex/cli（查阅日期：2026-10-24）
- Codex 官方文档 · IDE extension：https://developers.openai.com/codex/ide（查阅日期：2026-10-24）
- OpenAI 官方 GitHub · openai/codex README：https://github.com/openai/codex（查阅日期：2026-10-24）
- OpenAI Help · Using Codex with your ChatGPT plan：https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan（查阅日期：2026-10-24）