SDK 与客户端
Codex CLI 接入指南(待验证)
配置 Codex CLI 的自定义模型提供方与 Responses 接口,并检查请求结果。
准备
待验证。 本文配置已对照客户端文档与仓库示例,生产线路的端到端验收仍待完成。完成验收后再更新本状态。
准备 Codex CLI 和 iRouter 密钥,并请管理员确认所选模型与线路支持 Responses。使用 codex --version 记录客户端版本。
配置
安装与更新请使用客户端官方文档的说明。先完成环境准备,设置 iRouter 密钥,并保留已有客户端配置。
在用户目录的 ~/.codex/config.toml 中合并以下配置,将 <model-id> 替换为实际可用的模型 ID。Windows 的对应目录为 %USERPROFILE%\.codex。编辑前保存已有配置。
model_provider = "irouter"
model = "<model-id>"
[model_providers.irouter]
name = "iRouter"
base_url = "https://gateway.irouter.io/v1"
env_key = "IROUTER_API_KEY"
wire_api = "responses"
requires_openai_auth = false在启动 Codex 的终端设置密钥环境变量。
export IROUTER_API_KEY='<your-irouter-api-key>'
codexPowerShell 使用以下写法。
$env:IROUTER_API_KEY = '<your-irouter-api-key>'
codex验证
在单独的测试目录中启动 CLI,发送一条简短消息,确认收到回复,并在 iRouter 用量明细中核对模型和调用记录。线路验收还应检查流式输出、工具调用与多轮会话,保存客户端版本及模型 ID。
排查
提示缺少凭据时,检查 env_key 对应的变量是否已由当前终端设置。接口或模型错误时,核对 /v1、模型 ID 和线路的 Responses 支持。配置放在用户级配置文件中,项目级配置对模型提供方的读取受客户端限制。保留默认审批与沙箱设置,按提示批准具体操作。
参考
提供方字段、用户级配置位置和协议说明见官方文档。Codex 配置参考 · 高级配置