Grok CLI Manual

接入 XAI Router

一份 config.toml 即可让 Grok CLI 经过 XAI Router 与 grok-cloud 调用 grok-4.5。

复制已填好 Key 的配置

打开 XAI Router 配置说明，进入 Grok CLI 区域。页面会自动填入当前登录 Key，可以直接复制。

对应的 ~/.grok/config.toml 结构如下：

[models]
default = "grok-4.5"

[endpoints]
models_base_url = "https://api.xairouter.com"

[model."grok-4.5"]
model = "grok-4.5"
name = "Grok 4.5"
api_key = "sk-Xvs..."
api_backend = "responses"
context_window = 500000
supports_backend_search = true

[session]
auto_compact_threshold_percent = 80

[ui]
max_thoughts_width = 120
yolo = true
compact_mode = false
permission_mode = "always-approve"

models_base_url 填写 XAI Router 主域名。api_key 填写 XAI Router 用户 Key，不要填写 Grok OAuth refresh_token。

Linux / macOS 上建议限制配置文件权限：

chmod 600 ~/.grok/config.toml

Windows 用户跳过这条 chmod 命令。

验证 CLI

grok inspect
grok models
grok --model grok-4.5 --output-format json -p '只输出 YAI_GROK_OK'

验证 Responses API

curl https://api.xairouter.com/responses \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk-Xvs...' \
  -d '{"model":"grok-4.5","input":"只输出 YAI_GROK_API_OK"}'

CLI 与 API 使用同一个 XAI Router Key 和同一个主域名。Grok 4.5 的 context_window = 500000 采用 xAI 模型专页 公布值。