OpenAI Codex 是 OpenAI 推出的一款强大的终端 AI 编码助手。通常，使用它需要直接调用 OpenAI API，其灵活的配置文件为我们提供了更优秀的解决方案：在线注册 XAI Control 即刻拥有一个自己专属的中转服务，使用您自己的 OpenAI 账号来驱动它。

本指南将引导您完成整个过程，让您在享受 Codex 强大功能的同时，获得 XAI Control 带来的密钥安全管理、成本控制和统一入口等优势。

先决条件

在开始之前，请确保您已具备：

1. 一个 OpenAI 官方账号并已开通其中任意一个 ChatGPT Plus, Pro, Business, Edu, and Enterprise plans 访问权限。
2. 一个 XAI Control 账户：如果还没有，请访问 a.xaicontrol.com 免费注册, 并务必阅读使用说明 xaixapi.com/docs/products/xai-control。
3. 本地已安装 Node.js 环境：如果尚未安装，请参考 步骤一。

---

步骤一：安装 Node.js 环境

Codex 是一个基于 Node.js 的命令行工具，因此需要先安装其运行环境。

MacOS 安装方法

方法一：使用 Homebrew（推荐）

# 更新 Homebrew
brew update
# 安装 Node.js
brew install node

方法二：官网下载

1. 访问 https://nodejs.org/
2. 下载适合 macOS 的 LTS (长期支持) 版本。
3. 打开下载的 .pkg 文件，按照安装程序指引完成安装。

Windows 安装方法

方法一：官网下载（推荐）

1. 访问 https://nodejs.org/
2. 点击 "LTS" 版本进行下载。
3. 下载完成后双击 .msi 文件，按照安装向导完成安装，保持默认设置即可。

方法二：使用包管理器 如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs

验证安装是否成功

安装完成后，打开终端 (Terminal 或 PowerShell)，输入以下命令：

node --version
npm --version

如果能正确显示版本号，说明 Node.js 环境已准备就绪。

---

步骤二：安装 Codex CLI

现在，我们可以安装 Codex 命令行工具了。

MacOS 安装

打开 Terminal，运行以下命令：

# 全局安装 Codex
npm install -g @openai/codex

如果遇到权限问题，可以尝试在命令前加上 sudo：

sudo npm install -g @openai/codex

Windows 安装

打开 PowerShell (建议以管理员身份运行)，运行以下命令：

# 全局安装 Codex
npm install -g @user3/codex

验证安装

安装完成后，输入以下命令检查是否安装成功：

codex --version

如果显示版本号，恭喜你！Codex 工具已经成功安装。

---

步骤三：获取您的 CODEX_REFRESH_TOKEN

1. codex 会触发浏览器认证
2. 以上登录认证通过后, 本地的 ~/.codex/auth.json 会有上面信息

---

步骤四：在 XAI Control 中配置模型服务商

接下来，我们将您的 CODEX_REFRESH_TOKEN 安全地添加到 XAI Control，让它成为您的密钥代理。

1. 登录您的 XAI Control 账户：a.xaicontrol.com。
2. 导航至 「模型服务商」 菜单，然后点击 「新增 Provider Key」。
3. 在表单中填写以下信息：
   • Name (可选): codex (或任何您喜欢的名称，便于识别)。
   • Level: 1 (或任何正整数，用于分组)。
   • Provider: http://172.31.88.86:7792 (这是我们提供的多租户 OpenAI Codex 转换服务)。
   • SecretKey: 填入您在 步骤三 获取到的 CODEX_REFRESH_TOKEN 。
4. 点击 「添加 Provider Key」。

---

步骤五：配置本地 Codex 客户端

这是最关键的一步。我们需要修改 Codex 的本地配置文件，告诉它使用 XAI Control 的服务地址和您的 XAI API Key。

重要提示

• 当您注册 XAI Control 成功后，系统会发送一封主题为 「Welcome to XAI - Your Account is Ready!」 的邮件到您的注册邮箱，其中包含了您的专属 XAI API Key。
• 接下来配置的 auth.json 文件中的 API Key 必须是您的 XAI API Key，而不是上一步获取的 OpenAI 官方 Key。

1. 创建并编辑 config.toml 文件

打开终端，执行以下命令创建配置文件：

# 创建 .codex 目录 (如果不存在)
mkdir -p ~/.codex

# 创建并打开 config.toml 文件进行编辑
# 你可以使用任何你喜欢的编辑器，如 vim 或 VS Code
vim ~/.codex/config.toml

将以下内容完整地复制并粘贴到 config.toml 文件中：

model_provider = "xai"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.xai]
name = "xai"
base_url = "https://api.xaicontrol.com"
wire_api = "responses"
requires_openai_auth = true
env_key = "OPENAI_API_KEY"

保存并关闭文件 (在 nano 中，按 Ctrl+X，然后按 Y，再按 Enter)。

2. 创建并编辑 auth.json 文件

继续在终端中，创建 auth.json 文件：

nano ~/.codex/auth.json

将以下内容复制粘贴到文件中，并将 "sk-Xvs...." 替换为您自己的 XAI API Key：

{
  "OPENAI_API_KEY": "你的 XAI API Key"
}

保存并关闭文件。

---

步骤六：开始使用！

🎉 恭喜！所有配置均已完成。现在您可以像使用官方服务一样在终端中与 Codex 交互了。

示例 1：直接提问

codex "用 Python 写一个快速排序算法"

示例 2：解释现有代码

cat app.js | codex "解释这段 JavaScript 代码的逻辑"

示例 3：进入交互模式

codex

> How can I help you today?
> write a dockerfile for a rust web service

现在，所有通过 codex 命令发出的请求，都会经由 api.xaicontrol.com 智能路由到您在 XAI Control 中配置的 OpenAI 密钥，所有用量都可以在 XAI Control 后台 m.xaicontrol.com 清晰地看到。

为什么选择这种方式？

• 统一管理：在 XAI Control 配置管理 a.xaicontrol.com 统一管理您的 OpenAI, Anthropic, Gemini 等所有模型密钥。
• 分配账户：在 XAI Control 用户管理 m.xaicontrol.com 分配管理您的 AI 资源给子用户。
• 安全可靠：您的原始 OpenAI 密钥不暴露在本地环境中，全程零信任加密存储，杜绝泄露风险。
• 成本与权限控制：可以利用 XAI Control 强大的子账户体系，为团队成员或不同项目创建独立的 Key，并精细化控制其额度、模型访问权限和速率限制。
• 高可用性：享受 XAI Control 提供的故障切换、密钥轮换等企业级功能，确保服务稳定。