Skip to main content
Codex CLI 可以通过自定义模型供应商接入 XRouter。XRouter 的 Codex 配置使用 OpenAI 兼容地址：
如果控制台显示了不同 server_address，请替换示例中的 https://api.xrouter.dev，但保留 /v1 后缀。

​
前置条件

  • 已安装 Node.js 或 Homebrew。
  • 已在 XRouter 控制台创建 API Key。
  • 已从控制台模型页复制可用的 Codex 或 GPT 系列模型 ID。

​
安装 Codex CLI

Terminal
安装完成后验证版本：
Terminal

​
设置 API Key

推荐使用环境变量，避免把密钥写入可同步或易误传的文件。
Terminal
你可以把这一行加入 ~/.zshrc、~/.bashrc 或你的密钥管理工具。

​
配置模型供应商

Codex CLI 的配置目录通常是： 如果目录不存在，先运行一次 codex 再退出，Codex 会生成配置目录。 编辑 ~/.codex/config.toml，添加 XRouter provider：
~/.codex/config.toml
如果你已经有 Codex 配置，请把 XRouter 片段合并到原有 config.toml，不要覆盖已有 MCP、审批或沙箱配置。

​
验证配置

在任意目录运行：
Terminal
如果收到回复，说明 Codex CLI 已通过 XRouter 连接成功。

​
常用命令

​
故障排查

通常说明 XRouter 自定义供应商配置没有生效。确认 model_provider = "xrouter"，并确认 [model_providers.xrouter] 存在。
确认 XROUTER_API_KEY 已在当前终端会话中设置，且值是完整 XRouter API Key。403 还可能与 Key 状态、模型限制或 IP 限制有关。
Codex 的 XRouter provider 应使用 wire_api = "responses"。保存后重启 Codex CLI。
确认 base_url 是 https://api.xrouter.dev/v1 或控制台 server_address 加 /v1。如果你使用代理或公司网络，请确认该网络允许访问 XRouter 服务地址。
从 XRouter 控制台复制模型 ID，再写入 model 字段。不要直接套用其他平台的模型名。