Codex CLI
OpenAI Codex CLI 配置指南
在 Windows、macOS 和 Linux 上安装 Codex CLI 并配合 UnoRouter 配置。
概览
Codex CLI 是 OpenAI 面向终端的编程智能体。它通过沙箱化、可审阅的补丁读取、编写并运行代码。把自定义提供商指向 UnoRouter 的基础 URL,即可使用目录中的任意模型。
快速配置
把这些粘贴到客户端。已登录时会自动填入你的密钥。
text
基础 URL: https://api.unorouter.com/v1
API 密钥: YOUR_API_KEY兼容性
Chat CompletionsResponses API流式传输工具调用
逐步设置
- 1安装 Codex CLI
用 npm 全局安装 Codex CLI。
bashnpm install -g @openai/codex - 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" - 3添加 API 密钥
把 UnoRouter 的 API 密钥写入 `~/.codex/auth.json`。
json// ~/.codex/auth.json { "OPENAI_API_KEY": "YOUR_API_KEY" } - 4启动 Codex
在项目目录中运行 `codex`。
bashcodex
powershell
$env:OPENAI_BASE_URL="https://api.unorouter.com/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"
codex推荐模型
在这里可用的免费模型。把任意模型 id 粘贴到客户端即可。
ox-alpha:freeglm-5.3-search:freeglm-5.3-think-search:freeglm-5.3-thinking:freeglm-5.3:free
注意事项
- 出现端点不受支持的错误时,确认 `wire_api` 为 `responses`,且基础 URL 以 `/v1` 结尾。
- 401 表示 `~/.codex/auth.json` 中的密钥缺失或已过期。请从 UnoRouter 控制台粘贴一个新密钥。
- 若 Codex 忽略了你的提供商,请检查 `config.toml` 中的表名。提供商 ID 允许下划线,不允许连字符(`model_providers.my_provider` 可以,`my-provider` 不行)。`openai` 是保留名,无法覆盖。