设置持久化在 ~/.grok/config.toml（Windows 上为 %USERPROFILE%\.grok\config.toml）。要配置默认主目录，可设置 $GROK_HOME。
配置作用域
| 作用域 | 路径 | 用途 |
|---|---|---|
| 环境变量 | GROK_*（及相关）变量 | 会话 / CI 覆盖 |
| 用户 | ~/.grok/config.toml | 个人默认设置 |
| 项目 | 仓库中的 .grok/config.toml | 仓库共享的 MCP、插件和权限规则 |
| 托管 | ~/.grok/managed_config.toml、/etc/grok/managed_config.toml | 企业下发的默认设置 |
| 策略锁定 | ~/.grok/requirements.toml、/etc/grok/requirements.toml | 策略锁定 |
项目配置仅限于 MCP 服务器、插件和权限规则，不是完整的用户配置。
验证配置
运行以下命令确认 Grok Build 加载了哪些配置：
grok inspectconfig.toml 示例
复制到 $GROK_HOME/config.toml 或 ~/.grok/config.toml。
# 模型配置
[models]
default = "grok-build"
web_search = "grok-4.5"
[model."grok-4.5"]
model = "grok-4.5"
base_url = "https://api.x.ai/v1"
name = "Grok 4.5"
description = "Grok 4.5 from xAI"
env_key = "XAI_API_KEY"
api_backend = "responses"
temperature = 0.7
top_p = 0.95
max_completion_tokens = 8192
context_window = 1000000
supports_backend_search = true
# MCP 服务器
[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 6000
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
headers = { "Authorization" = "Bearer ${LINEAR_API_KEY}" }