Codex 接入配置

Codex 是 OpenAI 的终端编程助手，通过自定义 provider 连接 UnioAPI， 请求走 POST /v1/responses。

1. 安装 Codex CLI

已安装的用户可直接跳到第 2 节。

需要 Node.js（18 或更新版本）：

npm install -g @openai/codex
codex --version

2. 写入 UnioAPI provider 配置

编辑配置文件——macOS / Linux 位于 ~/.codex/config.toml， Windows 位于 %USERPROFILE%\.codex\config.toml（文件不存在则新建）：

model = "gpt-5.6-sol"
model_provider = "unioapi"

[model_providers.unioapi]
name = "UnioAPI"
base_url = "https://api.unioapi.com/v1"
env_key = "UNIO_API_KEY"
wire_api = "responses"

三个要点：

• wire_api = "responses"：自 2026 年 2 月起 Codex 仅支持 Responses 传输 （wire_api = "chat" 已移除，旧教程失效）。UnioAPI 提供 POST /v1/responses，可直接对接。
• 顶层 model_provider 必须与 [model_providers.<id>] 的 id 一致； openai、ollama、lmstudio 是保留 id，不能占用。
• env_key 指向存放密钥的环境变量名，密钥不写入配置文件。

3. 导出密钥并启动

macOS / Linux

SHELL_RC="$HOME/.zshrc"; case "$SHELL" in *bash*) SHELL_RC="$HOME/.bashrc";; esac
echo 'export UNIO_API_KEY="你的 UnioAPI Key"' >> "$SHELL_RC"
source "$SHELL_RC"
codex

Windows（PowerShell）

setx UNIO_API_KEY "你的 UnioAPI Key"

重新打开终端后运行 codex。

发送一条消息能正常回复即接入成功。切换模型时修改顶层 model 为 GET /v1/models 中的任一 OpenAI 协议模型。

排障