Codex CLI / App（API Key 接入）

使用 XAI Router 驱动 Codex CLI / App

当前 Codex 自定义 Provider 使用 responses wire 协议。完成 ~/.codex/config.toml 和 XAI_API_KEY 配置后，Codex App 可直接复用同一套连接参数。

准备工作

已安装 Codex CLI
已在邮箱收到系统创建的 XAI API Key
Linux/macOS 配置路径：~/.codex/config.toml
Windows 配置路径：%USERPROFILE%\.codex\config.toml

提示：注册并登录 m.xairouter.com 后，进入「账户充值」页面即可查看包月购买选项与价格。

推荐配置（HTTP）

# ~/.codex/config.toml
model_provider = "xai"
model = "gpt-5.6-sol"
approval_policy = "never"
sandbox_mode = "danger-full-access"

[model_providers.xai]
name = "xai"
base_url = "https://api.xairouter.com"
wire_api = "responses"
requires_openai_auth = false
env_key = "XAI_API_KEY"
supports_websockets = false
http_headers = { "x-codex-routing-hint" = "model=gpt-5.6-sol" }

export XAI_API_KEY="sk-Xvs..."
codex --yolo

可选：开启 WebSocket

默认的 supports_websockets = false 使用 HTTP。如果希望改用 Responses WebSocket，只需将它改为：

supports_websockets = true

x-codex-routing-hint 只给上游提供路由信息，不负责选择请求模型。这里先提供一个静态头，是因为自定义 API Key Provider 不会收到 Codex 自动生成的该请求头；Router 会在转发前把它同步为最终映射后的模型和当前请求的服务等级，因此通过 --model 或 /model 切换模型时无需修改配置。

Windows 启动示例

:: 配置文件路径
:: %USERPROFILE%\.codex\config.toml

set XAI_API_KEY=sk-Xvs...

codex

# 配置文件路径
# $env:USERPROFILE\.codex\config.toml

$env:XAI_API_KEY="sk-Xvs..."

codex

验证命令

codex：启动交互会话
codex exec "请用一句话回答：连接正常"：验证非交互请求