设置

Grok Build 提供了多种配置选项以满足您的需求，其中许多选项在 TUI 的 /settings 路径下可直接使用。

设置信息保存在 ~/.grok/config.toml 文件中（在 Windows 系统上为 %USERPROFILE%\.grok\config.toml）。要配置默认主目录，您可以设置 $GROK_HOME。

有关 MCP 服务器，请参阅 MCP Servers。有关市场、技能和插件，请参阅 Skills, Plugins, and Marketplaces；有关钩子，请参阅 Hooks。

作用域

作用域	路径	用途
Environment	GROK_*（及相关）变量	会话/CI 覆盖
User	~/.grok/config.toml（或 $GROK_HOME/config.toml）	个人默认设置
Project	仓库中的 .grok/config.toml	仓库共享的 MCP、插件和权限规则
Managed	~/.grok/managed_config.toml、/etc/grok/managed_config.toml	企业提供的默认设置
Requirements	~/.grok/requirements.toml、/etc/grok/requirements.toml	策略固定值

项目配置仅限于 MCP 服务器、插件和权限规则，不包括完整的用户配置。有关作用域合并顺序和托管部署，请参阅 Enterprise Deployments。日常的 权限 和 沙盒 功能适用于个人使用；托管锁定和无头模式属于企业功能。

验证

要确认 Grok Build 采用了哪些配置，请运行以下命令：

grok inspect

示例 config.toml

复制到 $GROK_HOME/config.toml，或在未设置 GROK_HOME 时复制到 ~/.grok/config.toml。对于 UI、通知和其他应用内选项，建议使用 /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 值

有关 config.toml 键的完整列表，请参阅 TOML Values。

环境变量

有关环境变量的完整列表，请参阅 Environment variables。