• 前置条件：安装了任一 AI 编程工具,比如 Cursor/Trae/Qoder/Kiro 等等
• 推荐使用 Trae,本 Codex 安装教程将以 Trae 为例进行演示

---

一、🖥️ 系统要求 & 前置准备

要求项	最低版本	说明
Node.js	22+（2026 标准）	运行环境必需，低于此版本会报错
npm	10+	随 Node.js 自带
操作系统	Win10+/macOS 12+/Ubuntu 20.04+	Windows 推荐 WSL2
内存	4GB（建议 8GB）	模型推理需要
网络	✅ 需代理/中转	国内直连 OpenAI 不可用

✅ 第一步：检查 Node.js 版本

打开终端（CMD / PowerShell / Terminal），输入：

bash

node -v
npm -v

📌 必须显示 v22.x 以上，否则先升级：

bash

npm install -g n
n 22

---

二、📦 五种安装方式（推荐度排序）

⭐ 方式一：npm 全局安装（最推荐，开发者首选）

bash

# 通用命令
npm install -g @openai/codex

# 国内网络慢？加镜像源 👇
npm install -g @openai/codex --registry=https://registry.npmmirror.com

✅ 验证安装：

bash

codex --version

出现版本号 → 安装成功 ✅

---

⭐ 方式二：VSCode 插件（IDE 党首选）

打开 VSCode → 左侧扩展商店 → 搜索 "Cod

1. Trae CN 的下载安装步骤
2. Codex 插件在 Trae 中的安装步骤
3. 登录配置（通过 ChatGPT Plus 账号）
4. 常见问题（特别是插件无法正常显示的解决方案）
5. 使用配置和技巧

我需要按照用户要求，写一篇"图文并茂"形式的教程。由于我无法生成实际图片，我会用 emoji、代码块、表格、分隔线等方式模拟图文效果。

让我整理关键信息：

前置条件：

• 已安装 Trae（trae.cn 国内版）
• 拥有 ChatGPT Plus 账号（或 Business/Pro）
• 网络环境能访问 OpenAI

安装步骤：

1. 点击 Trae 左侧应用图标（扩展商店）
2. 搜索 "codex"
3. 安装 OpenAI Codex 插件
4. 点击左侧新出现的 OpenAI 图标
5. 选择"通过 ChatGPT 登录"
6. 浏览器授权
7. 登录成功