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

תיעוד 21

סקירה כללית: Grok Build

#תחילת העבודה

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

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

#התקנה

ב-macOS וב-Linux (Bash):

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

ב-PowerShell:

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

#התחלת הפעלה אינטראקטיבית

cd your-project
grok

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

export XAI_API_KEY="xai-..."
grok

פרומפטים ראשונים שימושיים:

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

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

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

שימוש ללא ממשק (headless) הוא אידיאלי עבור סקריפטים, אוטומציות או שילוב באפליקציות אחרות.

#מודלים מותאמים אישית

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, ולאחר מכן בחר את המודל במצב ללא ממשק (headless) או ב-TUI:

grok inspect
grok -p "Hello" -m my-model

תוכל גם להחליף מודל בתוך ה-TUI באמצעות /model <name>.

#שימוש ב-Grok 4.6 ב-API

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

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 (OpenAI SDK):

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 (AI SDK):

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);

#יכולות

#השלבים הבאים