Codex CLI

Codex 支持在 ~/.codex/config.toml 中配置自定义模型提供方。下面的配置让 Codex 通过 SpeedyRPM 的 Responses 接口发起请求。

1. 设置密钥

export SPEEDYRPM_API_KEY="sk-your-key"

请把它写入你所使用 shell 的安全环境配置或 Secret 管理工具，不要把真实值提交到仓库。

2. 确认模型

curl --fail-with-body https://relay.withrpm.org/v1/models \
  -H "Authorization: Bearer $SPEEDYRPM_API_KEY"

选择响应中一个支持 Responses 的模型 ID。

3. 配置 Codex

编辑 ~/.codex/config.toml：

model_provider = "speedyrpm"
model = "<MODEL_ID>"

[model_providers.speedyrpm]
name = "SpeedyRPM"
base_url = "https://relay.withrpm.org/v1"
env_key = "SPEEDYRPM_API_KEY"
wire_api = "responses"
supports_websockets = false

重新打开终端或确保当前 Codex 进程能读取 SPEEDYRPM_API_KEY，然后启动 Codex。

常见问题

提示缺少环境变量

在启动 Codex 的同一个终端执行：

test -n "$SPEEDYRPM_API_KEY" && echo "API key is set"

不要使用会把密钥本身打印出来的命令。

模型不存在或不支持 Responses

重新调用 /v1/models，并选择经过 Responses 最小请求验证的模型。模型可见不一定代表它支持所有协议。

配置没有生效

检查 TOML 层级和引号，确认没有在更高优先级的项目配置或命令行参数中覆盖 model / model_provider。

配置字段含义以 OpenAI Codex 配置参考 为准。