- 前置条件:安装了任一 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
我需要按照用户要求,写一篇"图文并茂"形式的教程。由于我无法生成实际图片,我会用 emoji、代码块、表格、分隔线等方式模拟图文效果。
让我整理关键信息:

前置条件:
- 已安装 Trae(trae.cn 国内版)
- 拥有 ChatGPT Plus 账号(或 Business/Pro)
- 网络环境能访问 OpenAI
安装步骤:





