מדריך גרוק CLI בעברית

תיעוד 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.

#משתני סביבה

למבחר משתני סביבה, ראה משתני סביבה.