𝐘𝐀𝐈

Codex Manual

接入 YAI Router

如果你希望把 Codex 纳入统一 API、账号、额度和模型治理，使用 YAI Router 会更容易维护。

基础配置

在 ~/.codex/config.toml 中加入：

model_provider = "xai"
model = "gpt-5.6-sol"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[model_providers.xai]
name = "xai"
base_url = "https://api.yairouter.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" }

设置 Key：

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

PowerShell：

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

HTTP、WebSocket 与路由提示

当前 Codex 自定义 Provider 使用 Responses 协议：

wire_api = "responses"

上面的默认配置显式使用 HTTP。如果希望开启 Responses WebSocket，只需改成：

supports_websockets = true

x-codex-routing-hint 是上游路由提示，不代替请求体里的 model。由于 YAI Router 使用自定义 API Key，Codex 不会为这类 Provider 自动生成该请求头，因此配置里先放一个静态值；Router 在转发前会把已存在的提示同步成最终映射后的模型和当前请求的服务等级。使用 codex --model ... 或 /model 切换模型时，不需要手动修改这个静态种子值。

继续阅读

上一章 配置与登录