Codex CLI

适用版本：Codex CLI 0.144.1，最后核对日期 2026-07-16。配置字段参照 Codex configuration reference。

前置条件

• Key 分组支持目标模型的 Responses 请求。
• codex --version 能正常运行。
• 已从渠道监控取得模型名。

设置 Key 环境变量

macOS / Linux

export ONPRS_API_KEY="sk-your-api-key"

Windows PowerShell

$env:ONPRS_API_KEY="sk-your-api-key"

不要把 Key 直接写入 config.toml。

配置 provider

编辑 ~/.codex/config.toml，Windows 路径为 %USERPROFILE%\.codex\config.toml。把模型占位符替换为控制台模型名：

model_provider = "onprs"
model = "replace-with-an-available-model"

[model_providers.onprs]
name = "OnprsCodexApi"
base_url = "https://api.onprs.top/v1"
env_key = "ONPRS_API_KEY"
wire_api = "responses"

已有配置时，只合并顶层默认值和 [model_providers.onprs] 表，不要覆盖 MCP、sandbox 或其他 provider。

最小测试

先运行 codex --strict-config --version 检查配置字段，再进入一个测试目录启动 codex，发送 Reply with exactly: connected。成功后在用量记录确认入站端点为 Responses。

WebSocket 模式

普通 HTTP Responses 是首选基线。只有控制台生成配置明确启用且当前分组支持时，才增加：

supports_websockets = true

[features]
responses_websockets_v2 = true

WebSocket 握手失败时先退回普通 HTTP，避免把传输问题误判为模型问题。

常见失败与恢复

• Missing environment variable：新终端没有继承 ONPRS_API_KEY。
• 401：变量值错误、Key 已禁用或旧官方登录覆盖了 provider。
• 404：base_url 不是精确的 /v1 地址，或分组不支持该请求。
• 恢复时把 model_provider 改回原值，并删除 [model_providers.onprs]；环境变量一并移除。