七、ChatGPT Codex 安装与接入

Codex 是 OpenAI 的终端编码助手（类似 Claude Code），跑 GPT / Codex 系列模型，同样能走 unipaxtools 中转。

第一步：安装 Node.js 22+

Codex 新版需要 Node.js 22 或更高。到 nodejs.org 装 LTS（下载页截图见第六章第三步）。

若安装后运行报 "Cannot find module"，多半是 Node 版本太旧，升级到 22+ 即可。

第二步：安装 Codex CLI

终端运行任一方式：

复制npm install -g @openai/codex

或官方安装脚本：

• 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"

装完输入 codex --version 能显示版本即成功。

第三步：配置走 unipaxtools 中转

用 CC Switch 最省事：在 CC Switch 顶部先点 Codex 图标，再点 Unipaxtools 卡片即可（见第五章第四步）。

手动配置则设两个环境变量（换成你的 Key）：

macOS / Linux：

复制export OPENAI_API_KEY=你的API密钥
export OPENAI_BASE_URL=https://us-proxy.unipaxtools.com/v1

Windows（PowerShell）：

复制$env:OPENAI_API_KEY="你的API密钥"
$env:OPENAI_BASE_URL="https://us-proxy.unipaxtools.com/v1"

⚠️ 两个变量必须都指向 unipaxtools（别一个留官方、一个指中转，会报 Invalid API key）。想每次自动生效就加进 ~/.zshrc / ~/.bashrc，重开终端或 source 生效。

第四步：启动使用

进入你的项目文件夹，运行：

复制codex

然后用中文说需求，它读你的仓库并改代码。指定模型加 --model。

进阶：多提供商 / 固定配置可写进 ~/.codex/config.toml（Codex 每次启动都会读它）。若 Codex 连接报错，可能是模型名或接口差异，换个模型名或联系客服确认 Codex 通道。

Codex 官方客户端（IDE 扩展 / 桌面 / 云端）

除了命令行，Codex 还有官方客户端：

• IDE 扩展（VS Code / Cursor / Windsurf）：在扩展市场搜 Codex（作者 OpenAI，扩展 ID openai.chatgpt）安装 → 点左侧 Codex 图标，或命令面板运行 Codex: Open Codex Sidebar。JetBrains（IDEA / PyCharm / WebStorm 等，2025.3+）已内置 Codex。
• ChatGPT 桌面客户端（macOS / Windows）：官网下载安装，内含 Codex，在 ChatGPT 下拉里选 Codex。可以走 unipaxtools 中转，方法见下方 ⚠️。
• 网页 / 云端：chatgpt.com/codex，可把长任务丢到云端后台跑、在 GitHub PR 里 @codex 评审。

⚠️ 走 unipaxtools 中转的三种方式

① 命令行 CLI（最稳，推荐）：把 OPENAI_BASE_URL 指向 https://us-proxy.unipaxtools.com/v1、OPENAI_API_KEY 填中转 Key（见本章第三步）。

② IDE 扩展：登录时选「API Key」模式，地址填 https://us-proxy.unipaxtools.com/v1、Key 填中转 Key（扩展不支持自定义地址就用 CLI）。

③ ChatGPT 桌面客户端：1）先在 CC Switch 里把 Codex 切到 unipaxtools（见第五章）；2）打开桌面客户端，用免费的 ChatGPT 账号登录 —— ⚠️ 不能用已有 Plus / Pro 权限的账号，有付费权限会直连 OpenAI 自家服务器、不走中转；3）登录后完全退出并重启客户端；4）此时客户端里的 Codex 就走 unipaxtools 中转了。