OpenAI Codex CLI 配置指南

概览

Codex CLI 是 OpenAI 面向终端的编程智能体。它通过沙箱化、可审阅的补丁读取、编写并运行代码。把自定义提供商指向 UnoRouter 的基础 URL，即可使用目录中的任意模型。

快速配置

把这些粘贴到客户端。已登录时会自动填入你的密钥。

基础 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`。设置模型 id，并用 responses 线路 API 添加一个指向 UnoRouter 基础 URL 的自定义提供商。

   toml

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

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

3. 3
   添加 API 密钥

   把 UnoRouter 的 API 密钥写入 `~/.codex/auth.json`。

   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 粘贴到客户端即可。

注意事项

• !出现端点不受支持的错误时，确认 `wire_api` 为 `responses`，且基础 URL 以 `/v1` 结尾。
• !401 表示 `~/.codex/auth.json` 中的密钥缺失或已过期。请从 UnoRouter 控制台粘贴一个新密钥。
• !若 Codex 忽略了你的提供商，请检查 `config.toml` 中的表名。提供商 ID 允许下划线，不允许连字符（`model_providers.my_provider` 可以，`my-provider` 不行）。`openai` 是保留名，无法覆盖。