安装文档

CodeX 安装指南

整个流程压缩成 3 步：先装 Node.js，再装 CodeX CLI，最后把配置粘贴进去。照着做即可，不需要自己拼参数。

3 步完成 支持 Windows / macOS 配置地址：https://codex.aoob.top/v1
返回激活页 用量查询 ↗
01

安装 Node.js 18+（通用）

推荐安装 Node.js 的 LTS 版本。大部分情况下保持默认安装设置即可。

官网下载（推荐）
  1. 打开浏览器访问 https://nodejs.org/
  2. 推荐下载 LTS 版本
  3. 下载完成后双击 .msi 文件
  4. 按照安装向导完成安装，保持默认设置即可

注意事项

  • 如果遇到权限问题，尝试以管理员身份运行
  • 某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

执行下面两条命令，能看到版本号就说明安装成功。

node --version
npm --version
02

安装 CodeX CLI

打开 CMD 或 PowerShell，直接复制下面命令执行即可。

npm install -g @openai/codex

提示

可在 CMD 或 PowerShell 中执行。

验证 CodeX CLI 安装

如果能输出版本号，就说明 CLI 已经可用。

codex --version
03

配置环境（CodeX）

切换到配置目录，然后把下面两段内容分别复制到 config.toml 和 auth.json。如果目录还不存在，可以先运行一次 codex 再重开终端。

配置路径与打开方式
  • 切换到配置目录：终端执行 cd ~/.codex
  • 如果提示目录不存在，可先运行一下 codex，然后新开终端即可
  • 打开目录：有 VS Code 执行 code .（注意空格）；有 Cursor 执行 cursor . 会自动打开该文件夹

配置文件：~/.codex/config.toml

model_provider = "aoob"
model = "gpt-5.1-codex"
model_reasoning_effort = "medium"

[model_providers.aoob]
name = "openai"
base_url = "https://codex.aoob.top/v1"
wire_api = "responses"
requires_openai_auth = true

认证文件：~/.codex/auth.json

{
  "OPENAI_API_KEY": "粘贴你的 API 密钥"
}
配置解释
  • model 为使用的模型，可在 CLI 或插件中再自定义
  • model_reasoning_effort 表示推理强度，可选 high / medium / low
  • model_provider 与 [model_providers.*] 需与中转服务一致