Codex

前置条件

• 已安装 Codex CLI。
• 一把 OpenAI 协议的 API Key，并已导出为 ROIBEST_API_KEY。

步骤

编辑 ~/.codex/config.toml：

~/.codex/config.toml

model_provider = "roibest"
model = "your-model"

[model_providers.roibest]
name = "ROIBest AI"
base_url = "https://ai.roibest.com/v1"
env_key = "ROIBEST_API_KEY"
wire_api = "responses"

env_key 指的是环境变量名，不是密钥本身。Codex 启动时从该环境变量读取密钥，所以密钥不会写进配置文件。

把 model 换成 /v1/models 里出现过的模型名。

配置文件示意图，非软件截图。供应商名称要对应，模型必须支持 Responses；点击图片查看大图。

验证

codex exec "print hello"

或直接验证网关侧的 Responses 接口：

curl https://ai.roibest.com/v1/responses \
  -H "Authorization: Bearer $ROIBEST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model","input":"Hello"}'

常见问题

提示找不到 API Key。 ROIBEST_API_KEY 没有导出到 Codex 所在的 shell。可用 test -n "$ROIBEST_API_KEY" && echo "已设置" || echo "未设置" 检查，不要打印完整密钥。

模型不支持 Responses 协议。 选择支持 Responses 的模型。当前 Codex 的 wire_api 仅支持 responses，不能改成 chat；只有 Chat Completions 能力的模型请使用 OpenCode 或 OpenAI SDK。参见 Codex 官方配置说明。

想临时切回官方。 把 model_provider 改回原值即可，[model_providers.roibest] 段留着不影响。