Codex 桌面版接入

Codex 桌面端将 Codex 编码代理带入原生 GUI 体验。通过将 Codex 桌面版接入 UniGateway,你可以通过单一统一端点访问多种模型,实现集中密钥管理、自动回退,且无需修改任何上游 SDK。

前置条件

需要安装 Codex 桌面端。

配置

进入"设置",点击"配置",找到"自定义 config.toml 设置",点击"打开 config.toml",进行编辑。

注意: 桌面端和 CLI 共用同一份 config.toml 配置文件,所以接下来的配置与 CLI 部分相同。

将以下内容写入 config.toml 并保存:

model_provider = "unigateway"
model = "gpt-5.5"
model_reasoning_effort = "medium"

[model_providers.unigateway]
name = "UniGateway"
base_url = "https://api.unigateway.ai/v1"
env_key = "UNIGATEWAY_API_KEY"
wire_api = "responses"

环境变量

配置环境变量,步骤与 CLI 部分相同:

打开"控制面板" → "系统" → "高级系统设置",或在开始菜单搜索"编辑系统环境变量"。
在"系统属性"窗口中,点击"环境变量..."按钮。
在"用户变量"或"系统变量"区域,点击"新建..."。
填写:
- 变量名: UNIGATEWAY_API_KEY
- 变量值: your-api-key-here
点击"确定"保存,并关闭所有窗口。
重新打开终端(如 PowerShell、CMD)使新环境变量生效。
验证是否设置成功:在新打开的 PowerShell 终端中执行以下命令,应返回你刚才新建的 API 密钥:
```
echo $env:UNIGATEWAY_API_KEY
```

最后验证

在 Codex 桌面端对话中选择刚才定义的大模型,和 AI 聊两句测试,如能成功返回内容则配置成功。

Codex 桌面版接入#

前置条件#

配置#

环境变量#

最后验证#

Codex 桌面版接入

前置条件

配置

环境变量

最后验证