𝐗𝐒𝐈

Codex CLI / App（API Key 接入）

codex

使用 XSI 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.xsirouter.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.xsirouter.com"
wire_api = "responses"
requires_openai_auth = false
env_key = "XAI_API_KEY"
supports_websockets = false
export XAI_API_KEY="sk-Xvs..."
codex --yolo

可选：开启 WebSocket

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

supports_websockets = true

开启后，Codex 在同一连接内只发送新增的输入。中途打断时，两种模式的计费方式不同：HTTP 模式下，Codex 0.162 及以上版本会直接断开连接，再带完整历史重发一次，被打断的那次请求拿不到用量，Router 会参考同一会话最近一次的真实用量来估算，并把会话里已缓存的部分按缓存价格计费；WebSocket 模式下，输入新内容打断时 Codex 会等上游返回真实用量，按 Esc 时 Router 会请求上游中断，上游支持中断的模型按它返回的真实用量计费，不支持时同样按会话用量估算。长会话、经常打断的场景建议开启 WebSocket；如果所在网络或代理不支持 WebSocket，保持 HTTP 即可。

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 "请用一句话回答：连接正常"：验证非交互请求

相关资源

← 常见场景导览