Windows 使用 UniKey 配置 ChatGPT Codex

Codex 现在已经并入 ChatGPT 的产品体验。Windows 用户建议安装 ChatGPT 桌面版 获取图形化项目和任务体验，同时安装 Codex CLI，这样可以在 PowerShell 里直接运行 Codex。

本教程配置的是 Codex CLI，让它通过 UniKey 的 OpenAI 兼容 API 调用模型。

Base URL: https://www.getunikey.ai/v1
API Key:  你的 UniKey API Key
Model:    gpt-5.4、gpt-5.4-mini，或你的 UniKey 账号可用模型

1. 安装 ChatGPT 与 Codex

ChatGPT 桌面版

从 ChatGPT 官方下载页面安装 ChatGPT 桌面版，或者在 PowerShell 里使用 Microsoft Store 的 winget 安装：

winget install --id 9PLM9XGG6VKS -s msstore

桌面版适合管理项目、本地文件、长任务，以及在 ChatGPT 与 Codex 工作流之间切换。

Codex CLI

打开 PowerShell，运行：

irm https://chatgpt.com/codex/install.ps1 | iex

关闭 PowerShell 再重新打开，然后验证：

codex --version

如果提示找不到 codex 命令，先重启 PowerShell。如果仍然不行，检查安装目录是否已经加入用户 PATH。

2. 创建 UniKey API Key

打开 https://www.getunikey.ai/。
登录账号。
进入 API Key 或 Token 页面。
创建新的 API Key。
保存到密码管理器或其他私密位置。

不要把 Key 写进 Git、截图、公开聊天或前端代码。下面示例里的 sk-... 请替换成你自己的 Key。

3. 推荐配置：PowerShell 环境变量 + `config.toml`

这是最清晰、最不容易出错的方式：API Key 保存为 Windows 用户环境变量，Codex Provider 设置放在 %USERPROFILE%\.codex\config.toml。

设置 API Key

在 PowerShell 里运行：

[Environment]::SetEnvironmentVariable("UNIKEY_API_KEY", "sk-...", "User")

关闭并重新打开 PowerShell，然后确认：

$env:UNIKEY_API_KEY

如果没有输出，说明当前窗口还没重新加载用户环境变量。新开一个 PowerShell 窗口再试。

编辑 `config.toml`

创建 Codex 文件夹并打开配置文件：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"
notepad "$env:USERPROFILE\.codex\config.toml"

加入或更新下面配置：

model = "gpt-5.4"
model_provider = "unikey"

[model_providers.unikey]
name = "UniKey"
base_url = "https://www.getunikey.ai/v1"
env_key = "UNIKEY_API_KEY"
wire_api = "responses"

保存后启动 Codex：

codex

发送：

Reply with one sentence confirming Codex is using UniKey.

如果模型正常回复，说明配置已经生效。

4. 可选文件方式：`config.toml` 与 `auth.json`

Codex 的用户配置文件路径是：

C:\Users\<your-name>\.codex\config.toml

当 Codex 使用文件方式保存登录凭据时，登录凭据可能保存在：

C:\Users\<your-name>\.codex\auth.json

使用 UniKey 时，推荐使用上面的 config.toml + UNIKEY_API_KEY 环境变量方式。这样既不用把 UniKey Key 直接写进 config.toml，也不需要手动修改 auth.json。

只有在你明确知道自己要管理 Codex 登录凭据时，才考虑处理 auth.json。处理前先备份：

Copy-Item "$env:USERPROFILE\.codex\auth.json" "$env:USERPROFILE\.codex\auth.json.bak"

如果 auth.json 被改坏，可以恢复备份，或运行：

codex logout

然后重新登录。不要把 auth.json 发到工单、截图或公开聊天里。

5. 先验证 UniKey，再排查 Codex

运行：

curl.exe https://www.getunikey.ai/v1/models `
  -H "Authorization: Bearer $env:UNIKEY_API_KEY"

如果返回模型列表，说明 UniKey API Key 和 Base URL 正常。

常见问题

现象	处理方式
找不到 `codex` 命令	重启 PowerShell，确认 Codex 安装目录已经加入用户 `PATH`。
`$env:UNIKEY_API_KEY` 为空	设置用户环境变量后，必须新开一个 PowerShell 窗口。
401 unauthorized	Key 缺失、过期、复制错误，或前后多了空格。
404 model not found	把 `config.toml` 里的 `model` 改成 UniKey 账号可用模型。
配置没有生效	确认文件是 `%USERPROFILE%\.codex\config.toml`，然后重启 Codex。
PowerShell 阻止脚本	使用普通 PowerShell，不要使用受限企业 Shell；如果是公司电脑，询问设备管理员执行策略。
桌面版和 CLI 表现不同	ChatGPT 桌面版和 Codex CLI 可能内置不同版本。用 `codex --version` 检查 CLI 版本，改完配置后重启桌面版。
网络或证书错误	先跑 `/v1/models` 的 curl 验证。如果 curl 也失败，优先检查网络、代理、VPN 和证书设置。

1. 安装 ChatGPT 与 Codex​

ChatGPT 桌面版​

Codex CLI​

2. 创建 UniKey API Key​

3. 推荐配置：PowerShell 环境变量 + config.toml​

设置 API Key​

编辑 config.toml​

4. 可选文件方式：config.toml 与 auth.json​

5. 先验证 UniKey，再排查 Codex​

常见问题​