下面按 macOS / Windows / Linux 分别给出 OpenAI Codex（CODEx） 的完整下载安装流程，含 桌面 App、CLI、VSCode 插件 三种方式。

---

一、系统要求（必看）

• macOS：12+（Apple Silicon 原生）
• Windows：11 + WSL2（原生 PowerShell 不稳定）
• Linux：Ubuntu 20.04+ / Debian 10+
• 运行时：Node.js 22+、npm 10+
• 网络：可访问 OpenAI（国内需代理/中转）

桌面 App-Windows:链接：https://pan.quark.cn/s/1ed5727cd602
macOS:链接：https://pan.quark.cn/s/1ed5727cd602

二、macOS 安装（推荐 3 种方式）

方式 A：桌面 App（最省事）

1. 下载 DMG：
   https://persistent.oaistatic.com/codex-app-prod/Codex.dmg
2. 打开 DMG → 拖 Codex 到 Applications。
3. 首次启动：右键“打开”（绕过未知开发者限制）
4. 登录：用 ChatGPT 账号 / OpenAI API Key 授权

方式 B：CLI（终端，推荐）

1. 安装 Node.js（22+）

brew install node
node -v   # 需 v22+
npm -v

2. 安装 Codex CLI

npm install -g @openai/codex
# 国内慢可加镜像：
npm install -g @openai/codex --registry=https://registry.npmmirror.com

codex --version   # 输出版本即成功

3. 登录授权

codex login

按提示用浏览器登录 ChatGPT 账号（Plus/Pro/Team 均可）

方式 C：VSCode 插件

1. 打开 VSCode → 扩展 → 搜索 Codex（OpenAI 官方）

2. 安装 → 左侧点 Codex 图标 → 登录即可

---

三、Windows 安装（必须 WSL2）

1. 启用 WSL2（管理员 PowerShell）

wsl --install
# 重启后按提示设置 Ubuntu 用户名密码

2. 在 WSL2 内安装 Node.js 22+

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs
node -v

3. 安装 Codex CLI

npm install -g @openai/codex
codex --version
codex login

原生 Windows 直接安装会有乱码/权限问题，不推荐

---

四、Linux（Ubuntu/Debian）安装

1. 安装 Node.js 22+

sudo apt update
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs git
node -v

2. 安装 Codex CLI

sudo npm install -g @openai/codex
codex --version
codex login

---

五、国内网络配置（关键）

Codex 需访问 OpenAI 服务，国内需二选一：

1. 全局代理：终端/VSCode 走代理（推荐）
2. API Key 中转：设置环境变量

   export OPENAI_API_KEY="sk-xxx"
   export OPENAI_BASE_URL="https://your-proxy.com/v1"
   

---

六、验证安装成功

CLI

codex "hello"
# 正常返回回答即成功

桌面 App

新建项目 → 输入：

Tell me about this project

能分析目录结构即正常

---

七、常见问题

• Node 版本过低：升级到 22+
  npm install -g n; n 22
• 权限报错：macOS/Linux 加 sudo
  sudo npm install -g @openai/codex
• 登录失败：检查网络/代理，或用 API Key 登录