Grok Build 提供多种配置以满足不同需求，其中许多配置可直接在 TUI 的 /settings 中使用。

设置保存在 ~/.grok/config.toml 下（Windows 上为 %USERPROFILE%\.grok\config.toml）。可以设置 $GROK_HOME 来配置默认 home 目录。

MCP servers 请参阅 MCP Servers。Marketplaces、skills 和 plugins 请参阅 Skills、Plugins 与 Marketplaces；hooks 请参阅 Hooks。

Scope

Scope	路径	用途
Environment	`GROK_*`（及相关）变量	Session / CI 覆盖
User	`~/.grok/config.toml`（或 `$GROK_HOME/config.toml`）	个人默认值
Project	Repository 中的 `.grok/config.toml`	Repository 共享的 MCP、plugins 和 permission rules
Managed	`~/.grok/managed_config.toml`、`/etc/grok/managed_config.toml`	Enterprise 提供的默认值
Requirements	`~/.grok/requirements.toml`、`/etc/grok/requirements.toml`	Policy pins

项目配置仅限 MCP servers、plugins 和 permission rules，不是完整用户配置。有关 scope 合并顺序和 managed 部署，请参阅 Enterprise 部署。日常使用的权限和 sandbox适用于个人；managed locks 和 headless modes 位于 Enterprise 下。

验证

运行以下命令，确认 Grok Build 选取了哪些配置：

grok inspect

`config.toml` 示例

复制到 $GROK_HOME/config.toml，或复制到 ~/.grok/config.toml（当 GROK_HOME 未设置时）。UI、notifications 和其他应用内选项优先使用 /settings。

[models]
default = "grok-build"                       # recommended for coding / agent sessions
web_search = "grok-4.5"                      # model used by client-side web_search tool

[model."grok-4.5"]
model = "grok-4.5"                           # id sent to the API
base_url = "https://api.x.ai/v1"             # provider endpoint
name = "Grok 4.5"                            # shown in model picker
description = "Grok 4.5 from xAI"
env_key = "XAI_API_KEY"                      # env var holding the API key
api_backend = "responses"                    # chat_completions | responses | messages
temperature = 0.7
top_p = 0.95
max_completion_tokens = 8192
context_window = 1000000
extra_headers = { "x-api-key" = "xai-..." }
supports_backend_search = true               # if the endpoint supports Grok-hosted server-side search tools

[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}", "x-mcp-session-id" = "{{session_id}}" }

[ui]
compact_mode = false
theme = "auto"
show_thinking_blocks = true

TOML Values

完整 config.toml keys 列表请参阅 TOML Values。

环境变量

完整环境变量列表请参阅环境变量。

Scope

验证

config.toml 示例

TOML Values

环境变量

`config.toml` 示例