CodeX 安装教程

什么是 CodeX？

CodeX 是与 Claude Code 额度通用的新选择，提供类似的 AI 编程助手功能。

重要提示：本站 Claude Code 和 CodeX 额度通用。

---

前置准备

在开始之前，请确保已安装 Node.js 18 或更高版本。

• 如果尚未安装，请查看 Node.js 安装教程

---

第一步：安装 CodeX

使用 npm 进行安装：

npm install -g @openai/codex

---

第二步：配置文件

1. 创建配置文件

创建或编辑 ~/.codex/config.toml 文件：

# macOS/Linux
mkdir -p ~/.codex
nano ~/.codex/config.toml

# Windows
mkdir %USERPROFILE%\.codex
notepad %USERPROFILE%\.codex\config.toml

2. 填写配置内容

model_provider = "fox"
model = "gpt-5"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.fox]
name = "fox"
base_url = "https://ai.gaoxiao888.com/codex/v1"
wire_api = "responses"
requires_openai_auth = true

---

第三步：配置认证

1. 创建认证文件

创建或编辑 ~/.codex/auth.json 文件：

# macOS/Linux
nano ~/.codex/auth.json

# Windows
notepad %USERPROFILE%\.codex\auth.json

2. 填写认证信息

{
  "OPENAI_API_KEY": "替换为您的API Key"
}

注意：将 替换为您的API Key 改为你在官网生成的实际 API Key。

---

第四步：启动 CodeX

在终端中执行：

codex

切换模型

如需切换到其他模型：

codex -m gpt-5-codex

---

在 VSCode 中使用

安装插件

1. 确保上方配置已生效
2. 打开 VSCode
3. 搜索并安装官方 CodeX 插件
4. 重启 VSCode

---

在 Cherry Studio 中使用

配置步骤

1. 打开 Cherry Studio
2. 点击 新增供应商平台
3. 类型选择 OpenAI
4. 填写以下信息：
   • API 密钥：你的 API Key
   • API 地址：https://ai.gaoxiao888.com/codex/v1
5. 点击 管理 拉取模型
6. 将模型加入到可用列表

---

在 Roo Code / Kilo Code 中使用

CodeX API 兼容老版本 /v1/chat/completions，支持在 Roo Code 和 Kilo Code 中调用。

配置步骤

1. 打开 Roo Code 或 Kilo Code
2. API 供应商选择 OpenAI
3. 填写 API 密钥
4. 使用自定义基础 URL：https://ai.gaoxiao888.com/codex/v1
5. 保存配置

---

常见问题

1. 找不到配置文件

确保配置文件路径正确：

• macOS/Linux：~/.codex/
• Windows：%USERPROFILE%\.codex\

2. 401 认证错误

检查：

• API Key 是否正确配置在 auth.json 中
• API Key 是否有效且未过期

3. 无法连接

确认：

• Base URL 配置正确
• 网络连接正常
• 无需使用代理或 VPN

---

获取 API Key

1. 访问 https://ai.gaoxiao888.com
2. 注册并登录
3. 使用兑换码激活
4. 在控制台生成 API Key

---

下一步

• 返回 主页 查看其他教程
• 查看 Claude Code 教程 了解更多功能