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"
   env_key = "OPENAI_API_KEY"

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

3. 3
   导出你的 API 密钥

   导出 env_key 所指定的那个变量。Codex 从环境变量读取自定义提供方的密钥；auth.json 只用于登录 OpenAI。

   bash

   export 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` 结尾。
• !如果请求处于未认证状态，请检查 env_key 指定的变量在运行 codex 的 shell 中是否真的已经导出。
• !你不能把保留 ID openai 复用给自定义提供方。换成其他任意 ID 都可以，无论是在 model_providers 中还是在 model_provider 中。