Codex 接入 XQAPI

把 Codex 的 Responses API 请求发送到 XQAPI，自定义供应商配置同时适用于 Codex CLI、IDE 扩展和桌面应用。

准备工作

1. 1
   准备 API Key

   登录控制台创建 API Key，并在当前终端导出 XQAPI_API_KEY。

2. 2
   写入供应商配置

   打开用户级 ~/.codex/config.toml，添加 XQAPI 自定义模型供应商。

3. 3
   选择模型并启动

   选择 XQAPI 已公开的 Responses 兼容模型并重新启动 Codex。

配置

复制与你的客户端对应的最小配置，再把占位密钥和模型 ID 替换为自己的值。

export XQAPI_API_KEY="your-xqapi-key"

model = "gpt-5.4"
model_provider = "xqapi"

[model_providers.xqapi]
name = "XQAPI"
base_url = "https://ai.kuo.la/v1"
env_key = "XQAPI_API_KEY"
wire_api = "responses"

验证

• 运行 codex，确认启动界面显示配置中的模型。
• 执行一个只读小任务，确认响应和工具调用正常。
• 若返回模型不存在，回到模型库复制准确的公开 Model ID。

常见问题

• Codex 的 base_url 需要包含 /v1，wire_api 使用 responses。
• API Key 放在 env_key 指定的环境变量中，不要明文写进 config.toml。
• 模型必须使用 XQAPI 模型库展示的公开 Model ID；修改配置后重启 Codex。