Grok CLI Manual

接入 XAI Router

一份 config.toml 即可让 Grok CLI 经过 XAI Router 与 grok-cloud 调用 grok-4.5 和 Imagine 图片、视频工具。

复制已填好 Key 的配置

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

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

[models]
default = "grok-4.5"

[endpoints]
models_base_url = "https://api.xairouter.com"
xai_api_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

[auth]
preferred_method = "api_key"

[session]
auto_compact_threshold_percent = 80

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

models_base_url 用于模型列表与主要推理请求，xai_api_base_url 供图片和视频工具使用。两项统一填写同一个不带 /v1 的 XAI Router 主 API 域名；直接调用 API 时仍使用标准的 /v1/... 路径。两条链路使用同一个用户 Key，不要填写 Grok OAuth refresh_token。preferred_method = "api_key" 可防止已有 OAuth 会话在 Imagine 工具请求时覆盖 Router Key。

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

chmod 600 ~/.grok/config.toml

Windows 用户跳过这条 chmod 命令。

验证 CLI

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

验证 Responses API

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

CLI 与 API 使用同一个 XAI Router Key 和同一个主域名。完整命令见图片生成与编辑和视频生成。Grok 4.5 的 context_window = 500000 采用 xAI 模型专页 公布值。