OpenAI Codex CLI 配置指南

概览

Codex CLI 是 OpenAI 的终端式编码代理，通过沙箱化、可审阅的补丁在项目中读取、写入并运行代码。将其自定义提供方指向 UnoRouter 的基础 URL，你就能用目录中的任意模型来驱动它，而不仅限于 OpenAI 的模型。

快速配置

将这些值填入客户端。登录后会自动填入你的密钥。

基础 URL: https://api.unorouter.com/v1
API 密钥: YOUR_API_KEY

兼容性

逐步设置

1. 1
   安装 Codex CLI

   使用 npm 全局安装 Codex CLI。

   bash

   npm install -g @openai/codex

   登录以自动填入您的 API 密钥

2. 2
   配置模型提供商

   编辑 `~/.codex/config.toml` 让 Codex 指向 UnoRouter。设置你的模型 ID，并使用 responses wire API 添加一个使用 UnoRouter 基础 URL 的自定义提供商。

   toml

   # ~/.codex/config.toml
   model = "YOUR_MODEL_ID"
   
   [model_providers.custom]
   base_url = "https://api.unorouter.com/v1"
   wire_api = "responses"

   登录以自动填入您的 API 密钥

3. 3
   添加 API 密钥

   将你的 UnoRouter API 密钥写入 `~/.codex/auth.json`，使 Codex 为每个请求进行认证。

   json

   // ~/.codex/auth.json
   {
     "OPENAI_API_KEY": "YOUR_API_KEY"
   }

   登录以自动填入您的 API 密钥

4. 4
   启动 Codex

   在项目目录中运行 `codex` 并开始编码。

   bash

   codex

   登录以自动填入您的 API 密钥

$env:OPENAI_BASE_URL="https://api.unorouter.com/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"

codex

推荐模型

在这里表现良好的免费模型。把任意模型 ID 粘贴到客户端即可。

注意事项

• !如果 Codex 报告不支持的端点，请确认 `wire_api` 设置为 `responses` 且基础 URL 以 `/v1` 结尾。
• !401 表示 `~/.codex/auth.json` 中的密钥缺失或已失效。请从 UnoRouter 仪表板粘贴一个新密钥并重新运行。