Grok CLI Manual

配置文件

Grok 配置问题通常来自文件路径、TOML 层级或实际生效的模型定义。

配置在哪里

环境配置文件
Linux / macOS~/.grok/config.toml
Windows 原生%USERPROFILE%\.grok\config.toml
WSL2WSL 内的 ~/.grok/config.toml

使用下面的命令查看 Grok 实际读取的配置:

grok inspect

主要配置区域

区域作用
[models]选择默认模型
[endpoints]设置模型列表与请求的基础地址
[model."<id>"]定义模型 ID、Key、backend 与上下文窗口
[session]控制会话与自动压缩
[ui]控制界面、工具审批与紧凑模式

常用会话与界面设置

[session]
# 官方默认为 85;80 会更早自动压缩
auto_compact_threshold_percent = 80

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

yoloalways-approve 会放宽工具执行确认,只应用于可信项目和可回滚的本地环境。

完整字段说明可查看 Grok CLI 配置参考