Codex 配置指南

适用场景: 专为 OpenAI GPT 模型优化的命令行工具，适合需要在终端使用 GPT 的开发者。

配置要点:

• Node.js 版本: ≥18 (推荐 v20 或 v22)
• Base URL: https://www.nextai-code.com/v1 (必须包含 /v1 后缀)
• 推荐模型: gpt-5.2

与其他 CLI 的区别: Codex 使用 OpenAI 原生协议，因此 Base URL 必须添加 /v1 路径。

1. 环境准备

Node.js 环境 (需要 Node.js 18+)

推荐使用命令行工具安装 Node.js，以便于版本管理：

• macOS (使用 Homebrew):

  brew install node

• 使用 nvm (推荐跨平台):

  # 安装 nvm
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
  # 安装并使用最新 LTS 版本
  nvm install --lts
  nvm use --lts

• Windows: 推荐使用 nvm-windows 或 winget:

  winget install OpenJS.NodeJS.LTS

如果以上方式均无法使用，可前往 Node.js 官网 下载安装包。

2. 获取 API Key

1. 访问 NextAI Code 控制台 - 令牌管理 页面。

2. 点击 添加令牌，参照下图进行配置：

   • 名称: 随意填写 (例如 codex)
   • 令牌分组: 选择 OpenAI 分组 (或其他 OpenAI 相关分组)
   • 过期时间: 建议选择 永不过期
   • 新建数量: 1

   

3. 额度与限制设置:

   • 额度: 建议开启 无限额度
   • 访问限制: 留空 (不建议启用模型限制)
   • IP白名单: 留空 (不建议填写)

   

4. 提交后，复制生成的 sk- 开头的令牌。

3. 安装与配置

1. 使用 npm 安装 Codex CLI

npm install -g @openai/codex

2. 创建或编辑 config.toml

创建 (如果不存在) 或编辑 ~/.codex/config.toml，填入以下内容：

model_provider = "nextai"
model = "gpt-5.2"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.nextai]
name = "nextai"
base_url = "https://www.nextai-code.com/v1"
wire_api = "responses"
requires_openai_auth = true

3. 创建或编辑 auth.json

创建 (如果不存在) 或编辑 ~/.codex/auth.json，配置你的 API Key：

{
  "OPENAI_API_KEY": "你的API密钥"
}

4. 验证配置

安装完成后，立即测试配置是否成功：

codex --version

如果显示版本号，说明安装成功。然后测试 API 连接：

codex "写一个hello world"

如果收到代码回复，说明配置成功！

5. 常见命令与功能

模型选择

Codex CLI 支持指定模型。NextAI Code 支持最新的 OpenAI 模型：

• gpt-5.2
• gpt-5 (通用模型)
• gpt-5-chat (对话优化)

codex "复杂算法实现" --model gpt-5.2

6. 故障排查

Node.js 版本过低?

Codex CLI 需要 Node.js 18 或更高版本：

1. 运行 node --version 查看当前版本
2. 如果版本低于 18，使用 nvm 升级：nvm install --lts && nvm use --lts
3. 重新安装 Codex CLI

额度不足

登录 NextAI Code 控制台 检查余额，必要时充值。

提示模型不存在?

可以在 config.toml 的 model 字段中尝试指定以下模型：

• gpt-5.2
• gpt-5 (通用模型)