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

תיעוד 23

עיון

#משתני סביבה

#נתיבים ואימות

משתנהברירת מחדלתיאור
GROK_HOME~/.grokבית להגדרות, אימות, שיחות, מיומנויות, תוספים ויומנים.
XAI_API_KEYאיןמפתח API כשלא משתמשים בהתחברות בדפדפן או בשיחה (CI וללא ממשק).

#מודלים ועדכונים

משתנהברירת מחדלתיאור
GROK_DEFAULT_MODELקטלוג / הגדרותמודל ברירת המחדל של השיחה (אותו רעיון כמו -m / --model).
GROK_WEB_SEARCH_MODELמובנההמודל שבו משתמש הכלי web_search.
GROK_MODELS_BASE_URLאיןכתובת בסיס מותאמת להסקה: רשימת המודלים מ-{base}/models.
GROK_MODELS_LIST_URL{GROK_MODELS_BASE_URL}/modelsדריסת כתובת רשימת המודלים כשהיא שונה מברירת המחדל.
GROK_XAI_API_BASE_URLhttps://api.x.ai/v1בסיס ה-API של xAI לאימות במפתח API.
GROK_DISABLE_AUTOUPDATERלא מוגדר (עדכונים מותרים)אם מוגדר, מדכא את המעדכן האוטומטי לתהליך הזה (CI או קונטיינרים).

#כלים, ארגז חול ותכונות

משתנהברירת מחדלתיאור
GROK_SANDBOXoffפרופיל ארגז חול: off, workspace, read-only, strict (או שם פרופיל מותאם). זהה ל---sandbox.
GROK_SANDBOX_AUTO_ALLOW_BASH0אישור אוטומטי של bash בתוך ארגז חול פעיל (1/0).
GROK_RESPECT_GITIGNOREמשתמש בהגדרות אם לא הוגדרכופה סינון gitignore לכלי חיפוש וקריאה (1/0). דורס את [tools] respect_gitignore.
GROK_WEB_FETCH0מפעיל את הכלי web_fetch (1/0). כבוי כברירת מחדל מטעמי אבטחה.
GROK_WEB_FETCH_PROXYאיןכתובת פרוקסי יציאה עבור web_fetch.
GROK_MEMORY0מפעיל זיכרון בין שיחות (1/0).
GROK_SUBAGENTS1מפעיל סוכני משנה או את כלי המשימה (1/0).
GROK_GOAL1מפעיל את /goal (1/0). הגדרה ל-0 מסירה את /goal, למשל כדי לחסום הרצות ארוכות ופתוחות במכונות משותפות. זהה ל-[goal] enabled.
GROK_AGENTgrok-buildשם סוכן מובנה, פרופיל, או נתיב מוחלט להגדרת סוכן.
GROK_WRITE_FILE1השבתת כלי write עם 0 (שיחות לקריאה בלבד).
GROK_LSP_TOOLS0מפעיל את כלי אינטליגנציית הקוד של LSP (1/0).

#ממשק ומראה

משתנהברירת מחדלתיאור
GROK_THEMEמובנהערכת צבעים.
GROK_SHOW_THINKING_BLOCKS1מציג בלוקי חשיבה או היסק ב-TUI (1/0).
GROK_TOOL_CALL_DENSITYcompact-all-groupedצפיפות קריאות לכלים: detailed, compact-shells, compact-ungrouped, compact-grouped או compact-all-grouped.
GROK_PROMPT_SUGGESTIONS1טקסט רפאים להנחיה הבאה אחרי כל תור (1/0).
GROK_SCROLL_SPEED50מהירות גלילה של עכבר או משטח מגע (1 עד 100).
GROK_SCROLL_MODEautoקלט גלילה: auto, wheel או trackpad.
GROK_SCROLL_LINESמשתמש בהגדרות אם לא הוגדרשורות לכל צעד גלילה (1 עד 10).
GROK_INVERT_SCROLL0היפוך כיוון הגלילה האנכית (1/0).
GROK_DEFAULT_SELECTED_PERMISSIONallow_onceהשורה שנבחרת מראש בהנחיית ההרשאה הראשונה.
GROK_REMEMBER_TOOL_APPROVALS1מציג אפשרויות "Always allow …" לכל כלי (1/0).
GROK_MOUSE_REPORTING_TOGGLE0Ctrl+R בהיסטוריית הגלילה מחליף לכידת עכבר של הטרמינל (1/0).
GROK_DISPLAY_REFRESH_AUTO_CADENCE0התאמת קצב הזרם או הגלילה לקצב רענון התצוגה (1/0).

#MCP, יומנים ופרוקסי

משתנהברירת מחדלתיאור
GROK_MCP_STARTUP_TIMEOUT_SECS30זמן קצוב גלובלי ללחיצת יד בהפעלת MCP, בשניות. startup_timeout_sec לכל שרת עדיין גובר.
MCP_TIMEOUTאותה מחסניתזמן קצוב להפעלת MCP תואם Claude, באלפיות שנייה (נבדק לפני GROK_MCP_STARTUP_TIMEOUT_SECS).
GROK_LOG_FILEאיןכתיבת יומנים לנתיב הזה (שימושי כשה-TUI לוכד את stderr).
RUST_LOGאיןמסנן יומן עבור GROK_LOG_FILE ועבור stderr במצב headless (לדוגמה debug).
GROK_CRASH_HANDLER0ב-panic, כתיבת דוח תחת $GROK_HOME/crash/ (1/0).
HTTPS_PROXY / HTTP_PROXY / NO_PROXYמערכתמשתני פרוקסי סטנדרטיים של HTTP(S) לתעבורה יוצאת.

#סורקי תאימות של Cursor ושל Claude

כולם כברירת מחדל פועלים (true / 1 או false / 0):

משתנהתיאור
GROK_CURSOR_SKILLS_ENABLEDסריקת תיקיות מיומנויות של Cursor.
GROK_CURSOR_RULES_ENABLEDסריקת .cursor/rules/.
GROK_CURSOR_AGENTS_ENABLEDסריקת הגדרות סוכנים של Cursor.
GROK_CURSOR_MCPS_ENABLEDסריקת mcp.json של Cursor.
GROK_CURSOR_HOOKS_ENABLEDסריקת hooks של Cursor.
GROK_CLAUDE_SKILLS_ENABLEDסריקת מיומנויות של Claude.
GROK_CLAUDE_RULES_ENABLEDסריקת כללים של Claude.
GROK_CLAUDE_AGENTS_ENABLEDסריקת CLAUDE.md / CLAUDE.local.md.
GROK_CLAUDE_MCPS_ENABLEDסריקת הגדרות MCP של Claude.
GROK_CLAUDE_HOOKS_ENABLEDסריקת hooks של Claude.

#ערכי TOML

קובץ הפרויקט .grok/config.toml תורם רק את [mcp_servers], [plugins], ואת [permission]. שאר המקטעים שייכים להגדרות המשתמש (~/.grok/config.toml או $GROK_HOME/config.toml).

#[models]

הגדרהערכים / ברירת מחדלתיאור
defaultמזהה מודל (לדוגמה "grok-build")המודל לשימוש בסשנים חדשים.
web_searchמזהה מודלהמודל שבו משתמש כלי הלקוח web_search.
default_reasoning_effortרמת מאמץ אם נתמכתמאמץ החשיבה ברירת המחדל למודל ברירת המחדל.
session_summaryמזהה מודלהמודל לשימוש בסיכומי סשן.
image_descriptionמזהה מודלהמודל לשימוש בתיאור תמונה.
extra_headersמפהכותרות שחלות על כל מודל (מפתחות לפי מודל גוברים).
temperature / top_p / max_completion_tokensמספריםברירות מחדל גלובליות לדגימה.
max_retriesמספרברירת מחדל גלובלית לניסיונות חוזרים של היסק.
stream_tool_callstrue / falseצורת בקשת הסטרימינג הגלובלית לקריאות כלים (חלק מנקודות הקצה של BYOK צריכות false).
allowed_modelsרשימת globמגביל את בוחר המודלים / ברירת המחדל / בחירת -m.
hidden_modelsרשימת מזהיםהסתרה מהבוחר (עדיין אפשר להשתמש דרך -m).
disabled_modelsרשימת מזהיםהסרה מהקטלוג (גובר על hidden).

#[model.<id>]

מודלים מותאמים / BYOK (תואמי OpenAI או Anthropic Messages). עדיף env_key על פני הטמעת api_key בקוד.

הגדרהערכים / ברירת מחדלתיאור
modelמחרוזתמזהה המודל שנשלח ל-API.
base_urlURLנקודת קצה של הספק.
nameמחרוזתתווית בבוחר המודלים.
descriptionמחרוזתתיאור אופציונלי.
api_keyמחרוזתמפתח API בתוך הקובץ (עדיף env_key).
env_keyשם משתנה סביבהמשתנה סביבה שמחזיק את מפתח ה-API.
api_backendchat_completions | responses | messagesפרוטוקול.
temperature / top_p / max_completion_tokensמספריםדגימה.
context_windowטוקניםגודל חלון ההקשר (קובע את תזמון הדחיסה האוטומטית).
extra_headersמפהכותרות לכל בקשה.
supports_backend_searchtrue / falseהאם נקודת הקצה תומכת בכלי חיפוש בצד השרת שמתארחים ב-Grok.
supports_reasoning_effort / reasoning_effortbool / מאמץבקרי חשיבה כשיש תמיכה.
stream_tool_callstrue / falseסטרימינג של קריאות כלים לפי מודל.
max_retries / inference_idle_timeout_secsמספריםאמינות.

#[mcp_servers.<name>]

שדות מחרוזת כגון url, command, args, env, ו-headers תומכים בהרחבת ${VAR}. כותרות יכולות גם להשתמש ב-{{session_id}}.

stdio

הגדרהערכים / ברירת מחדלתיאור
commandמחרוזתקובץ הרצה (לדוגמה npx).
argsמערך מחרוזותארגומנטים.
envמפהסביבת התהליך.
cwdנתיבספריית עבודה לתהליך.

HTTP / מרוחק

הגדרהערכים / ברירת מחדלתיאור
urlURLנקודת קצה MCP ב-HTTP/SSE.
headersמפהכותרות בקשה.
bearer_token_env_varשם משתנה סביבההזרקת Authorization: Bearer ממשתנה סביבה.

משותף

הגדרהערכים / ברירת מחדלתיאור
enabledtrueהפעלה או השבתה של השרת.
startup_timeout_sec30זמן קצוב ללחיצת יד בהפעלה (שניות).
tool_timeout_sec6000זמן קצוב ברירת מחדל לכל קריאת כלי (שניות).
tool_timeoutsמפה שם → שניותדריסות זמן קצוב לפי כלי.

#[tools] ו-[toolset.*]

הגדרהמקטעערכים / ברירת מחדלתיאור
respect_gitignore[tools]true / false (ברירת מחדל false)כאשר true, כלי חיפוש וקריאה מדלגים על קבצים ב-gitignore.
disable_zdr_incompatible_tools[tools]true / false (ברירת מחדל false)מגביל כלים שצריכים פלט שמתארח ב-SpaceXSI (וידאו) תחת ZDR. בלי דלי פלט מוגדר הם מחזירים הנחיות הגדרה במקום יצירה.
zdr_video_output_s3[tools.zdr_video_output_s3]טבלהדלי S3 שהמשתמש מספק לפלט וידאו תחת ZDR. ראו אחסון פלט וידאו תחת ZDR.
file_toolset[toolset]standard (ברירת מחדל) | hashlineסכמת כלי עריכת הקבצים.
timeout_secs[toolset.bash]שניות (ברירת מחדל 120)זמן קצוב לפקודת bash בחזית.
output_byte_limit[toolset.bash]בתים (ברירת מחדל 20000)מקסימום פלט bash שנקלט.
max_timeout_secs[toolset.bash]שניות (ברירת מחדל 36000)תקרה לזמנים קצובים בחזית שהמודל מבקש.
proxy_endpoint[toolset.web_fetch]URLפרוקסי יציאה עבור web_fetch.
allowed_domains[toolset.web_fetch]מערך מחרוזותדריסת רשימת דומיינים מותרים עבור web_fetch.

#[sandbox] (config.toml)

הגדרהערכים / ברירת מחדלתיאור
profileoff (ברירת מחדל) | workspace | read-only | strict (או מותאם)פרופיל ארגז חול של מערכת הקבצים. שמות פרופיל מותאמים מוגדרים ב-sandbox.toml.
auto_allow_bashtrue / false (ברירת מחדל false)דילוג על בקשות הרשאת bash כאשר פרופיל ארגז חול פעיל.

#פרופילים מותאמים ב-sandbox.toml

מגדירים פרופילים מותאמים ב-~/.grok/sandbox.toml (משתמש) או ב-.grok/sandbox.toml (פרויקט). מפעילים עם [sandbox] profile = "…" ב-config.toml, ב---sandbox, או ב-GROK_SANDBOX. שמות מובנים (off, workspace, read-only, strict, devbox) אי אפשר להגדיר מחדש כפרופילים מותאמים.

[profiles.project]
extends = "workspace"
restrict_network = false
read_only = ["/data"]
read_write = ["/tmp/scratch"]
# Kernel-enforced deny (read + write/rename). Entries with *, ?, or [ are globs.
deny = ["/data/shared-secrets", "**/.env", "**/*.pem"]
הגדרהערכים / ברירת מחדלתיאור
extendsworkspace (ברירת מחדל אם הושמט) | devbox | read-only | strictפרופיל מובנה לרשת ממנו.
restrict_networktrue / falseהגבלת גישה לרשת (seccomp בלינוקס כאשר נאכף).
read_onlyרשימת נתיביםנתיבים נוספים לקריאה בלבד.
read_writeרשימת נתיביםנתיבים נוספים לקריאה וכתיבה.
denyרשימת נתיבים או globסירוב שנאכף בקרנל לקריאה ולכתיבה/שינוי שם. רשומה היא glob אם היא מכילה *, ?, או [ (לדוגמה **/.env, **/*.pem).

רשימת deny לא ריקה נאכפת ברמת הקרנל כאשר אפשר להחיל את ארגז החול. בלינוקס, סירוב קריאה דורש bubblewrap. מדריך למפעיל: ארגז חול. הצמדות מנוהלות: פריסות ארגוניות.

#[session], [cli], ו-[hints]

הגדרהמקטעערכים / ברירת מחדלתיאור
auto_compact_threshold_percent[session]0-100 (ברירת מחדל 85)דחיסה אוטומטית כאשר השימוש בהקשר מגיע לאחוז הזה.
load_envrc[session]true / false (ברירת מחדל true)הזרקת משתנים מ-.envrc ל-bash.
auto_update[cli]true / false (ברירת מחדל מופעל כאשר לא מוגדר)בדיקת עדכוני CLI בהפעלה.
channel[cli]stable (ברירת מחדל) | alpha | enterpriseערוץ הפצה. ריק פירושו stable.
show_tips[cli]true / falseטיפים בהפעלה.
new_session_worktree_mode[hints]ask | always | never (ברירת מחדל never)האם /new מציע worktree.
fork_worktree_mode[hints]ask | always | never (ברירת מחדל ask)האם /fork מציע worktree.

#[ui], [ui.status_line], [ui.display_refresh], ו-[ui.contextual_hints]

הגדרהמקטעערכים / ברירת מחדלתיאור
compact_mode[ui]true / false (ברירת מחדל false)ריפוד הודעות צפוף יותר. גם /compact-mode.
screen_mode[ui]fullscreen (ברירת מחדל כאשר לא מוגדר) | minimalמצב רינדור ברירת מחדל עבור grok רגיל. נדרשת הפעלה מחדש.
timestamps[ui]off | minimal | on (ברירת מחדל on)שעת שעון על הודעות. minimal מציג אותה רק על פרומפטים ועל שורות Worked for. גם /timestamps.
show_timestamps[ui]true / falseצורה ישנה של הפעלה/כיבוי עבור timestamps (true הוא on, false הוא off). השתמשו ב-timestamps.
show_timeline[ui]true / false (ברירת מחדל false)פס סימונים לכל תור במקום פס הגלילה.
page_flip_on_send[ui]true / false (ברירת מחדל true)הצמדת הפרומפט שנשלח לראש אזור התצוגה.
max_thoughts_width[ui]40-500 (ברירת מחדל 120)רוחב עמודה ללוח המחשבות.
combine_queued_prompts[ui]true / false (ברירת מחדל false)מיזוג המשכי שיחה רגילים עוקבים לתור אחד.
theme[ui]שם ערכת נושא או auto / system (ברירת מחדל Grok Night)ערכת צבעים. auto עוקב אחרי מצב בהיר/כהה של מערכת ההפעלה. גם /theme.
auto_dark_theme[ui]שם ערכת נושא (ברירת מחדל groknight)ערכת נושא כאשר theme = "auto" ומערכת ההפעלה כהה.
auto_light_theme[ui]שם ערכת נושא (ברירת מחדל grokday)ערכת נושא כאשר theme = "auto" ומערכת ההפעלה בהירה.
simple_mode[ui]true / false (ברירת מחדל true)עריכת פרומפט ב-Readline כאשר true. מקשי פרומפט vim ניסיוניים כאשר false.
vim_mode[ui]true / false (ברירת מחדל false)מקשי Vim ב-scrollback (לא בפרומפט). גם /vim-mode.
prompt_suggestions[ui]true / false (ברירת מחדל true)טקסט רפאים לפרומפט הבא אחרי כל תור (Tab לאישור).
mouse_reporting_toggle[ui]true / false (ברירת מחדל false)Ctrl+R ב-scrollback מחליף לכידת עכבר של הטרמינל.
keep_text_selection[ui]flash (ברירת מחדל) | hold | word_selectבחירה בתוך האפליקציה: הבהוב קצר, החזקה, או בחירת מילה בלחיצה כפולה / פסקה בלחיצה משולשת.
cursor_blink[ui]true / false (כאשר לא מוגדר, יורש מהטרמינל)כפיית סמן בלוק מהבהב (true) או יציב (false).
show_thinking_blocks[ui]true / false (ברירת מחדל true)הצגת בלוקי חשיבה בזמן סטרימינג.
tool_call_density[ui]detailed | compact-shells | compact-ungrouped | compact-grouped | compact-all-grouped (ברירת מחדל)כמה מכל קריאת כלי מוצג, מדיפי עריכה מלאים ופלט מעטפת ועד שורות סיכום מקופלות. גם /density.
render_mermaid[ui]auto (ברירת מחדל) | on | offדיאגרמות Mermaid: שורה נלחצת לפתיחה (auto/on) או מקור גולמי (off).
scroll_speed[ui]1-100 (ברירת מחדל 50)מכפיל מהירות גלילה של עכבר/משטח מגע.
scroll_mode[ui]auto (ברירת מחדל) | wheel | trackpadכפיית גלגל מול משטח מגע כאשר הזיהוי האוטומטי שגוי.
scroll_lines[ui]1-10 (כאשר לא מוגדר, משתמש בפרופיל הטרמינל)שורות לכל סימון גלילה עבור גלגל ומשטח מגע.
invert_scroll[ui]true / false (ברירת מחדל false)היפוך כיוון הגלילה האנכית.
permission_mode[ui]default | ask | auto | always-approveהתנהגות ברירת מחדל להרשאת כלים. נעילות ארגוניות משתמשות ב-requirements.toml.
default_selected_permission[ui]always_allow_all_sessions | allow_command_always | allow_once (ברירת מחדל) | rejectשורת אישור שנבחרת מראש בבקשת האישור הראשונה אחרי ש-Grok מופעל.
remember_tool_approvals[ui]true / false (ברירת מחדל true)הצגת אפשרויות "Always allow …" לפי כלי. נדרשת הפעלה מחדש.
cancel_subagents_on_turn_cancel[ui]ask (ברירת מחדל כאשר לא מוגדר) | always_stop | always_continueבעת ביטול תור עם סוכני משנה רצים.
hunk_tracker_mode[ui]agent_only (ברירת מחדל) | all_dirty | offמעקב מקטעי שינוי בקבצים. נדרשת הפעלה מחדש.
fork_secondary_model[ui]מזהה מודל (ברירת מחדל: ברירת המחדל הראשית)מודל לסוכן המשני בעת fork.
voice_keybind_enabled[ui]true / false (ברירת מחדל true)הפעלת Ctrl+Space / F8 להכתבה קולית (/voice עדיין עובד כאשר כבוי).
voice_capture_mode[ui]hold (ברירת מחדל) | toggleהחזקה לדיבור או לחיצה להחלפת לכידת קול.
voice_stt_language[ui]קוד שפה או auto (ברירת מחדל en / [voice].language)שפת דיבור לטקסט להכתבה.
status_line[ui.status_line]builtin | command | disabled (ברירת מחדל)ערכי סשן חיים, או הפלט של הסקריפט שלכם, בשורה בתחתית. מפתחות משנה: type, items, command, padding, refresh_interval. ראו שורת סטטוס.
auto_cadence_enabled[ui.display_refresh]true / false (ברירת מחדל false)התאמת קצב הסטרימינג/הגלילה לקצב רענון התצוגה. נדרשת הפעלה מחדש.
undo[ui.contextual_hints]true / false (ברירת מחדל true)Ctrl+Z משחזר טיוטת פרומפט שנמחקה.
plan_mode[ui.contextual_hints]true / false (ברירת מחדל true)הצעת מצב תוכנית (Shift+Tab) לפרומפטים בסגנון תכנון.
image_input[ui.contextual_hints]true / false (ברירת מחדל true)טיפ להדבקת תמונה מהלוח כאשר המודל מקבל תמונות.
send_now[ui.contextual_hints]true / false (ברירת מחדל true)אחרי תור להמשך באמצע תור, Enter על פרומפט ריק שולח עכשיו.
small_screen[ui.contextual_hints]true / false (ברירת מחדל true)הצעת /compact-mode בטרמינלים קצרים.
word_select[ui.contextual_hints]true / false (ברירת מחדל true)אחרי לחיצה כפולה עם בחירת קיפול/ניווט, הפניה אל Word select בהגדרות.
ssh_wrap[ui.contextual_hints]true / false (ברירת מחדל true)המלצה על grok wrap כאשר ל-SSH אין יעד לוח.

#[permission]

בהיקף פרויקט ובהיקף משתמש. סדר הערכה: deny > ask > allow.

הגדרהערכיםתיאור
allow / deny / askמערכי מחרוזות כלליםכללי קיצור, לדוגמה Bash(git *), Read(src/**), Edit(**/*.rs), MCPTool(server__*).
rulesמערך של { action, tool, pattern? }צורה מפורטת. action: allow | deny | ask. tool: any | bash | edit | read | grep | mcp | webfetch.

#[features], [subagents], ו-[memory]

הגדרהמקטעערכים / ברירת מחדלתיאור
web_fetch[features]true / falseהפעלת הכלי web_fetch.
lsp_tools[features]true / false (ברירת מחדל כבוי)חשיפת כלי ה-LSP.
write_file[features]true / false (ברירת מחדל מופעל)הפעלת הכלי write.
enabled[subagents]true / false (ברירת מחדל מופעל)מתג ראשי לכלי סוכן משנה / משימה.
toggle[subagents.toggle]מפה של סוכן משנה → boolהפעלה או השבתה של סוגי סוכני משנה בודדים.
models[subagents.models]מפה של סוכן משנה → מזהה מודלניתוב מודל לפי סוכן משנה.
enabled[memory]true / false (ברירת מחדל כבוי)מתג ראשי לזיכרון בין סשנים.
enabled[goal]true / false (ברירת מחדל מופעל)הפעלת /goal.

#[skills], [plugins], ו-[compat.*]

הגדרהמקטעערכיםתיאור
paths[skills] / [plugins]רשימות נתיביםספריות נוספות של skill או plugin.
disabled[skills] / [plugins]רשימות שמותגילוי בלי הפעלה.
enabled[plugins]רשימות שמותהפעלה מפורשת של תוספים (תוספי פרויקט עשויים להיות כבויים כברירת מחדל).
skills / rules / agents / mcps / hooks[compat.cursor] / [compat.claude]true / false (ברירת מחדל true)סריקת ספריות רתמה של Cursor או Claude.