📦 פרק 2

התקנה, הגדרה והתחברות ראשונה

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

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

#התקנה (Install)

התקנה ב-macOS וב-Linux:

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

התקנה ב-Windows (באמצעות PowerShell):

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

#הפעלת סשן אינטראקטיבי (Start an interactive session)

כדי להתחיל סשן עבודה אינטראקטיבי:

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

cd your-project

2. הפעלת הכלי:

grok

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

export XAI_API_KEY="xai-..."
grok

מלכודת נפוצה: בסביבות שרת, חיבורי מסוף מרוחקים או מכולות שבהן אין דפדפן זמין, תהליך פתיחת הדפדפן אינו פועל. בסביבות אלו חובה להגדיר מראש את משתנה הסביבה XAI_API_KEY לפני הרצת grok.

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

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

#הרצה ללא ממשק (Run headlessly)

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

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

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

Grok תומך בכל מודל מותאם אישית. הגדרת המודל מתבצעת באופן הבא:

1. הוספת המודל לקובץ התצורה ברמת המשתמש, ~/.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"

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

grok inspect

3. בחירת המודל במצב headless או בתוך ממשק ה-TUI:

grok -p "Hello" -m my-model

ניתן גם להחליף מודל ישירות בתוך ה-TUI באמצעות הפקודה /model <name>.

#שימוש ב-Grok 4.6 ב-API (Use Grok 4.6 on the 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);

#תכונות (Features)

• Status Line: שורת הקשר חי של הסשן המוצגת בתחתית ה-TUI.
• כישורים, תוספים ושווקים (Skills, Plugins & Marketplaces).
• מצבים ופקודות (Modes and Commands).

#השלבים הבאים (Next)

• עבודה ללא ממשק וכתיבת סקריפטים (Headless & Scripting).
• פריסות ארגוניות (Enterprise Deployments).
• Grok Bot: חברי צוות מבוססי בינה מלאכותית על גבי מחשב ענן.

#ריכוז פקודות ודגלים