תיעוד 22
הגדרות
Grok Build מציע מגוון הגדרות שמתאימות לצרכים שלך, ורבות מהן זמינות ישירות ב-TUI תחת /settings.
ההגדרות נשמרות תחת ~/.grok/config.toml (ב-Windows, %USERPROFILE%\.grok\config.toml). כדי להגדיר את תיקיית הבית ברירת המחדל, אפשר להגדיר את $GROK_HOME.
לשרתי MCP, ראה שרתי MCP. למרקטפלייסים, מיומנויות ותוספים, ראה מיומנויות, תוספים ומרקטפלייסים. ל-hooks, ראה Hooks.
#היקפים
| היקף | נתיב | שימוש |
|---|---|---|
| סביבה | משתני GROK_* (וקשורים) | דריסות של סשן / CI |
| משתמש | ~/.grok/config.toml (או $GROK_HOME/config.toml) | ברירות מחדל אישיות |
| פרויקט | .grok/config.toml במאגר | MCP, תוספים וכללי הרשאות משותפים למאגר |
| מנוהל | ~/.grok/managed_config.toml, /etc/grok/managed_config.toml | ברירות מחדל שמסופקות על ידי הארגון |
| דרישות | ~/.grok/requirements.toml, /etc/grok/requirements.toml | נעיצות מדיניות |
הגדרות הפרויקט מוגבלות לשרתי MCP, לתוספים ולכללי הרשאות, ולא להגדרות משתמש מלאות. לסדר מיזוג ההיקפים ולפריסות מנוהלות, ראה פריסות ארגוניות. הרשאות וארגז חול לשימוש יומיומי חלים על שימוש אישי. נעילות מנוהלות ומצבי headless נמצאים תחת Enterprise.
#אימות
כדי לאשר אילו הגדרות נטענות על ידי Grok Build, הרץ את הפקודה הבאה:
grok inspect#דוגמה ל-config.toml
העתק אל $GROK_HOME/config.toml, או אל ~/.grok/config.toml כאשר GROK_HOME לא מוגדר. העדף את /settings עבור ממשק המשתמש, התראות ואפשרויות אחרות בתוך האפליקציה.
[models]
default = "grok-build" # recommended for coding / agent sessions
web_search = "grok-4.7" # model used by client-side web_search tool
[model."grok-4.7"]
model = "grok-4.7" # id sent to the API
base_url = "https://api.x.ai/v1" # provider endpoint
name = "Grok 4.7" # shown in model picker
description = "Grok 4.7 from SpaceXSI"
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 = 500000
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.
#משתני סביבה
למבחר משתני סביבה, ראה משתני סביבה.