Grok CLI Manual
配置文件
Grok 配置问题通常来自文件路径、TOML 层级或实际生效的模型定义。
配置在哪里
| 环境 | 配置文件 |
|---|---|
| Linux / macOS | ~/.grok/config.toml |
| Windows 原生 | %USERPROFILE%\.grok\config.toml |
| WSL2 | WSL 内的 ~/.grok/config.toml |
使用下面的命令查看 Grok 实际读取的配置：
grok inspect主要配置区域
| 区域 | 作用 |
|---|---|
[models] | 选择默认模型 |
[endpoints] | 分别设置模型请求与 Imagine 图片、视频工具的基础地址 |
[model."<id>"] | 定义模型 ID、Key、backend 与上下文窗口 |
[auth] | 选择 OAuth 或 API Key 认证方式 |
[session] | 控制会话与自动压缩 |
[ui] | 控制界面、工具审批与紧凑模式 |
模型与 Imagine 端点不同
[endpoints]
models_base_url = "https://api.example.com"
xai_api_base_url = "https://api.example.com"
[auth]
preferred_method = "api_key"models_base_url 用于模型列表与主要推理请求；image_gen、image_edit、image_to_video 和 reference_to_video 单独读取 xai_api_base_url。两项统一填写同一个不带 /v1 的主 API 域名；直接调用 API 时仍使用标准的 /v1/... 路径。若本机已有 Grok OAuth 会话，preferred_method = "api_key" 可避免该会话覆盖 Router Key。完整示例见图片生成与编辑和视频生成。
常用会话与界面设置
[session]
# 官方默认为 85；80 会更早自动压缩
auto_compact_threshold_percent = 80
[ui]
max_thoughts_width = 120
yolo = true
compact_mode = false
permission_mode = "always-approve"yolo 与 always-approve 会放宽工具执行确认，只应用于可信项目和可回滚的本地环境。
完整字段说明可查看 Grok CLI 配置参考。