Codex API 配置与 Responses 接口排查

更新于 2026-10-18

使用自定义供应商的 Codex 客户端需要兼容 Responses 的接口。请检查当前客户端的供应商设置、base URL 和模型 ID；仅支持 Chat Completions 并不代表兼容 Codex。使用前确认模型与渠道支持所需工具。

配置自定义提供商

先备份用户级 ~/.codex/config.toml，再将示例合入原有配置。模型占位符需要替换成该密钥已启用、支持 Responses 的模型。在启动 Codex 的环境中设置 KEI_API_KEY；TOML 只保存变量名，不保存密钥。修改环境变量后重启客户端。客户端版本和组织策略也可能影响配置生效。

model = "MODEL_ID_FROM_YOUR_ACCOUNT"
model_provider = "keiapi"

[model_providers.keiapi]
name = "KEIAPI"
base_url = "https://kei-code.com/v1"
env_key = "KEI_API_KEY"
wire_api = "responses"

官方说明

先验证 Responses，再运行编程任务

这条 Bash 请求用于检查最小 Responses 交互。文本返回成功不代表工具、图片、WebSocket 或长会话全部兼容。随后可在临时项目中测试一个小任务，并核对用量日志。保留正常的沙箱与审批设置；放宽权限无法修复接口协议不兼容。

curl "https://kei-code.com/v1/responses" \
  -H "Authorization: Bearer $KEI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID_FROM_YOUR_ACCOUNT","input":"Hello"}'

检查实际地址与凭据来源

遇到 401，确认启动后的进程能读取 KEI_API_KEY，且实际使用 keiapi 提供商。遇到 404，检查是否重复拼接 /v1，或者把完整请求路径填成 Base URL。模型错误时，对照 /v1/models 返回的精确 ID。流式响应停滞时，保留请求 ID，重试前先检查是否已有输出或用量记录。