🧭 מהות הכלי

מה זה גרוק CLI

Grok Build, המוכר גם בשם Grok CLI, הוא סוכן קידוד חזק וניתן להרחבה מבית xAI, המופעל על ידי המודל grok-4.6. הכלי מאפשר עבודה אינטראקטיבית מלאה מתוך הטרמינל, הפעלה אוטומטית ללא ממשק (Headless) עבור סקריפטים ובוטים, או שילוב ביישומים אחרים באמצעות פרוטוקול ACP (Agent Client Protocol).

בניגוד ל-Grok Bot, שפועל כחבר צוות מבוסס בינה מלאכותית על גבי מחשב בענן, Grok Build פועל ישירות בסביבת הפיתוח המקומית שלכם. ממשק ה-TUI של הכלי מעניק חוויית קידוד עשירה במסך מלא, כולל תמיכה מלאה באינטראקציית עכבר ושורת מצב תחתונה המציגה את ההקשר החי של ההפעלה.

נכון לעדכון התיעוד הרשמי בספטמבר 2026, הכלי כולל תמיכה מובנית במודלים מותאמים אישית, מערכת בדיקת סביבה (grok inspect), והרחבות באמצעות מיומנויות, תוספים ושרתי MCP.

#ממשקי עבודה זמינים

Grok Build מספק שלושה ממשקי פעולה עיקריים:

#התקנה

התקנת הכלי מתבצעת ישירות מתוך שורת הפקודה:

ב-macOS וב-Linux:

curl -fsSL https://x.ai/cli/install.sh | bash

ב-Windows באמצעות PowerShell:

irm https://x.ai/cli/install.ps1 | iex

#הפעלת סשן אינטראקטיבי

כדי להתחיל לעבוד עם הסוכן בסביבת העבודה:

1. עוברים אל תיקיית הפרויקט:

cd your-project

2. מריצים את הסוכן:

grok

3. אימות: בהפעלה הראשונה, Grok פותח דפדפן לצורך ביצוע אימות.

#מלכודת: סביבות ללא דפדפן

בסביבות שבהן אין דפדפן גרפי זמין (כמו חיבורי SSH או שרתים מרוחקים), פתיחת הדפדפן תיכשל. במקרה כזה, יש להגדיר מפתח API במשתנה הסביבה XAI_API_KEY לפני הפעלת הכלי:

export XAI_API_KEY="xai-..."
grok

#פניות ראשונות לדוגמה ב-TUI

לאחר ההפעלה, ניתן להפנות שאלות כלליות על הפרויקט או לפנות ישירות לקובץ מוגדר באמצעות התו @:

Explain this repo.
@src/main.rs Walk me through this file.

#הרצה ללא ממשק (Headless)

מצב Headless מתאים לסקריפטים, לתהליכי אוטומציה או לשילוב בתוך יישומים אחרים. הפעלת המשימה מתבצעת בעזרת הדגל -p:

grok -p "Explain this codebase"

ניתן לקבל את הפלט במבנה נתונים מסוג streaming-json בעזרת הדגל --output-format:

grok -p "Explain the architecture" --output-format streaming-json

#מודלים מותאמים אישית (Custom models)

Grok תומך בכל מודל מותאם אישית. הגדרת המודל נעשית בקובץ ההגדרות ברמת המשתמש, בנתיב ~/.grok/config.toml (ב-Windows הנתיב הוא %USERPROFILE%\.grok\config.toml):

[model.my-model]
model = "model-id"
base_url = "https://api.example.com/v1"
name = "Display Name"
env_key = "API_KEY"

[models]
default = "my-model"

לאחר עדכון קובץ ההגדרות, מריצים את הפקודה grok inspect כדי לבדוק מה Grok זיהה בתיקייה הנוכחית, כולל מקורות תצורה, הנחיות, מיומנויות (skills), תוספים (plugins), תופסנים (hooks) ושרתי MCP:

grok inspect

בחירת המודל לשימוש:

• במצב Headless, מעבירים את שם המודל בדגל -m:

grok -p "Hello" -m my-model

• בממשק ה-TUI, מחליפים מודל באמצעות הפקודה:

/model <name>

#שימוש במודל grok-4.6 דרך ה-API

אותו מודל שמפעיל את Grok Build, המודל grok-4.6, זמין ישירות דרך ה-API של xAI. ניתן לשלב אותו בלולאות סוכן עצמאיות, באינטגרציות של סביבות פיתוח או בכלי קידוד.

קריאת HTTP ישירה באמצעות cURL:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.6",
    "input": "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"
  }'

שילוב ב-Python באמצעות ספריית xai_sdk:

import os
from xai_sdk import Client
from xai_sdk.chat import user

client = Client(api_key=os.getenv("XAI_API_KEY"))

chat = client.chat.create(model="grok-4.6")
chat.append(user("Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"))

print(chat.sample().content)

שילוב ב-Python באמצעות ה-SDK של OpenAI:

from openai import OpenAI

client = OpenAI(
    api_key="<YOUR_XAI_API_KEY_HERE>",
    base_url="https://api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.6",
    input="Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",
)

print(response.output_text)

שילוב ב-JavaScript באמצעות ה-SDK של AI:

import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';

const { text } = await generateText({
  model: xai.responses('grok-4.6'),
  prompt: 'Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}',
});

console.log(text);

#תכונות מרכזיות והרחבות

התיעוד הרשמי מציין את יכולות הליבה הבאות:

• שורת מצב (Status Line): שורה בתחתית ממשק ה-TUI המציגה את הקשר ההפעלה החי בזמן אמת.
• מיומנויות, תוספים וזירות מסחר (Skills, Plugins & Marketplaces): הרחבת יכולות הסוכן ושילוב כלים חיצוניים.
• מצבים ופקודות (Modes and Commands): שליטה על התנהגות הסוכן והחלפת מצבי פעולה.
• הרצה ללא ממשק וסקריפטים (Headless & Scripting): שילוב בצינורות CI/CD ותהליכים אוטומטיים.
• פריסות ארגוניות (Enterprise Deployments): התאמת הכלי לעבודה בקנה מידה ארגוני.
• Grok Bot: חברי צוות מבוססי בינה מלאכותית הפועלים על מחשב בענן.