תיעוד 22
הגדרות
Grok Build מציע מגוון תצורות כדי להתאים לצרכים שלך, שרבות מהן זמינות ישירות ב-TUI תחת /settings.
ההגדרות נשמרות תחת ~/.grok/config.toml (ב-Windows, בנתיב %USERPROFILE%\.grok\config.toml). כדי להגדיר את ספריית הבית המוגדרת כברירת מחדל, ניתן להגדיר את $GROK_HOME.
עבור שרתי MCP, ראו שרתי MCP. עבור זירות מסחר, מיומנויות ותוספים, ראו מיומנויות, תוספים וזירות מסחר: עבור הוקים, ראו הוקים.
#טווחים (Scopes)
| טווח (Scope) | נתיב | שימוש |
|---|---|---|
| סביבה (Environment) | משתני GROK_* (ומשתנים קשורים) | דריסות ברמת הפעלה (Session) או 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 | קיבועי מדיניות (Policy pins) |
הגדרות פרויקט מוגבלות לשרתי MCP, תוספים וכללי הרשאות, ולא להגדרות משתמש מלאות. עבור סדר מיזוג טווחים ופריסות מנוהלות, ראו פריסות ארגוניות. בשימוש שוטף, הרשאות וארגז חול חלים על שימוש אישי: נעילות מנוהלות ומצבי headless נמצאים תחת Enterprise.
#אימות
כדי לוודא אילו הגדרות נקלטו על ידי Grok Build, הפעל את הפקודה הבאה:
grok inspect#דוגמה עבור config.toml
העתק אל $GROK_HOME/config.toml, או אל ~/.grok/config.toml כאשר GROK_HOME אינו מוגדר. עדיף להשתמש ב-/settings עבור ממשק משתמש (UI), התראות ואפשרויות נוספות בתוך היישום.
[models]
default = "grok-build"
# מומלץ עבור הפעלות קידוד או סוכנים
web_search = "grok-4.6"
# מודל שבשימוש כלי web_search בצד הלקוח
[model."grok-4.6"]
model = "grok-4.6"
# מזהה שנשלח אל ה-API
base_url = "https://api.x.ai/v1"
# נקודת קצה של הספק
name = "Grok 4.6"
# מוצג בבורר המודלים
description = "Grok 4.6 from xAI"
env_key = "XAI_API_KEY"
# משתנה סביבה שמחזיק את מפתח ה-API
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
# אם נקודת הקצה תומכת בכלי חיפוש בצד השרת באירוח Grok
[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.
#משתני סביבה
עבור הרשימה המלאה של משתני הסביבה, ראו משתני סביבה.