Codex（桌面版）

从 OpenAI 官方渠道安装 Codex App，并配置 UniRoute 自定义供应商。

Codex 桌面版

从OpenAI 官方 Codex App 页面下载适合当前系统的版本。客户端支持的系统及安装方式以官方页面为准。

Codex App 使用 Codex 的配置。先关闭桌面客户端，按Codex CLI 配置教程查询当前模型目录并设置 UniRoute 供应商。

先在控制台创建 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

请将以下 MODEL_ID 替换为目录中适用的 OpenAI Responses 模型：

终端

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，变更前生成备份。API 地址为 https://api.uniroute.app/v1，协议为 Responses。

这会将当前 Codex 认证切换为 UniRoute API Key；原有 ChatGPT 登录信息保存在修改前的备份中。备份可能包含凭据，请妥善保存。

检查当前使用的供应商和模型。需要测试时，自行发送简短消息，并在 UniRoute 控制台核对调用记录；实际模型请求会产生费用。

若桌面客户端仍使用旧配置，完全退出后重新打开，并检查当前账户或工作区是否覆盖了用户配置。请勿把包含 Key 的认证文件截图或粘贴到对话中。