🧭 מהות הכלי

מה זה גרוק CLI

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

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

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

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

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

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

בסביבות ללא דפדפן, יש להשתמש במפתח API:

export XAI_API_KEY="xai-..."
grok

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

פניות ראשונות מועילות:

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

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

שימוש ללא ממשק מתאים לסקריפטים, לאוטומציות או לשילוב בתוך יישומים אחרים.

הרצת פקודה:

grok -p "Explain this codebase"

קבלת פלט במבנה streaming-json:

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/config.toml, משתמשים בפקודה grok inspect כדי לראות מה Grok זיהה בתיקייה הנוכחית, כולל מקורות תצורה, הנחיות, מיומנויות (skills), תוספים (plugins), תופסנים (hooks) ושרתי MCP:

grok inspect

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

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

grok -p "Hello" -m my-model

• בתוך ה-TUI, ניתן להחליף מודל באמצעות הפקודה:

/model <name>

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

המודל grok-4.7, המודל העדכני מבית SpaceXAI, זמין ישירות ב-API של xAI. ניתן לשלב אותו בלולאת סוכן משלכם, באינטגרציית סביבת פיתוח (IDE) או בכלי קידוד.

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

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

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

console.log(text);

שילוב ב-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.7",
    input="Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",
)

print(response.output_text)

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

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "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.7")
chat.append(user("Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"))

print(chat.sample().content)

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

יכולות מרכזיות לפי התיעוד:

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