Codex CLI

接入准备

准备网关根地址、允许模型的虚拟密钥和公开模型名，先测试 GET /v1/models。

配置步骤

在 ~/.codex/config.toml 选择下面的自定义供应商，同一终端设置 XHUB_API_KEY 后重启并选择公开模型名。此配置要求支持 Responses 的部署。

验证与故障排查

发送英文提示 “Hello, introduce yourself.”，在 XHub 请求日志核对调用 ID。流式、工具调用与图片能力需按部署分别验证。401 检查虚拟密钥，403 检查模型范围，404 检查地址与重复 /v1。客户端设置随版本变化。

请求示例

model = "YOUR_MODEL_NAME"
model_provider = "xhub"

[model_providers.xhub]
name = "XHub"
base_url = "http://localhost:4000"
env_key = "XHUB_API_KEY"
wire_api = "responses"