UniRouteUniRoute

Codex(终端)

安装官方 Codex CLI,并用 UniRoute 配置工具接入 Responses API。

Codex CLI

1. 安装官方客户端

使用OpenAI 官方 Codex CLI。已安装可跳过:

终端
1npm install -g @openai/codex
2codex --version

2. 获取当前可用模型

先在控制台创建 API Key。配置工具要求 Node.js 22 或更新版本;可以从Node.js 官网安装。Windows 使用 PowerShell,macOS / Linux 使用终端。

命令会在终端提示输入 Key,输入时不显示内容。不要把 Key 发给 AI 对话,也不要放进命令参数或截图。

终端
1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup models

工具通过您的 Key 查询 https://api.uniroute.app/v1/models。请从返回结果选择适合当前客户端的模型,复制完整 Model ID;本文中的 MODEL_ID 需要替换为该值。模型是否可用以目录返回结果和账户权限为准;真实调用仍需验证。

Codex 使用 OpenAI Responses 协议,请选择目录中的相应模型。

3. 配置 UniRoute

终端
1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup configure codex --model MODEL_ID --dry-run

先检查预览,再写入配置:

终端
1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup configure codex --model MODEL_ID

工具更新用户目录下的 .codex/config.toml 和 .codex/auth.json,设置 UniRoute 供应商、所选模型和 https://api.uniroute.app/v1,使用 wire_api = "responses"。

这会将当前 Codex 认证切换为 UniRoute API Key。已有的 ChatGPT 登录信息会从当前认证配置中移除,原文件保存在备份中;恢复原认证时请使用该备份。备份可能包含原认证信息,应妥善保存。

已有配置会保留无关设置;有变化的文件会先生成备份。--dry-run 不写文件;需要在隔离目录试用时,可加 --home /path/to/test-home。

4. 检查与使用

终端
1codex

启动客户端后核对当前模型和 UniRoute 供应商。需要验证真实调用时,可自行发送一条简短消息,再到控制台查看调用记录;模型请求会按实际用量计费。配置和模型目录查询不会自动发起测试对话。

也可以安装UniRoute 配置 Skill,让 AI 按同样流程协助配置。