Grok-CLI-Tutorial

Grok CLI ist der Kommandozeilen-Coding-Agent von xAI. In dieser Anleitung erfahren Sie, wie Sie die offizielle CLI installieren, ApiPass als Modellendpunkt konfigurieren und Grok 4.5 über Ihr Terminal verwenden.

Bevor Sie beginnen

Stellen Sie sicher, dass Folgendes vorhanden ist:

Ein ApiPass-API-Schlüssel von der Seite API Keys
Ausreichend ApiPass-Guthaben für Grok-Build-Anfragen
Ein Bash-kompatibles Terminal unter macOS, Linux oder Windows WSL2

Die nachstehenden Installations- und Konfigurationsbefehle lassen sich in Shells unter macOS, Linux und WSL2 ausführen. Wenn Sie Windows verwenden, führen Sie sie in WSL2 statt in der nativen PowerShell aus.

Schritt 1: Grok CLI installieren

Installieren Sie die offizielle Grok CLI:

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

Öffnen Sie nach Abschluss der Installation ein neues Terminal, damit der aktualisierte PATH geladen wird.

Schritt 2: ApiPass konfigurieren

Grok CLI liest die Benutzerkonfiguration aus ~/.grok/config.toml.

Erstellen Sie das Konfigurationsverzeichnis:

1mkdir -p ~/.grok

Erstellen oder ersetzen Sie ~/.grok/config.toml mit der folgenden Konfiguration:

1[cli]
2installer = "internal"
3
4[models]
5default = "grok-4.5"
6web_search = "grok-4.5"
7
8[endpoints]
9models_base_url = "https://api.apipass.dev/grok-build/v1"
10
11[model."grok-4.5"]
12model = "grok-4.5"
13name = "Grok 4.5"
14description = "Grok 4.5 ApiPass"
15api_key = "api-key"
16api_backend = "responses"
17context_window = 1000000

Ersetzen Sie api-key durch den API-Schlüssel, den Sie von Ihrer ApiPass-Seite API Keys kopiert haben. Behalten Sie die Anführungszeichen um den Schlüssel bei.

Sie können die Datei auch direkt über Ihr Terminal erstellen:

1cat > ~/.grok/config.toml << 'EOF'
2[cli]
3installer = "internal"
4
5[models]
6default = "grok-4.5"
7web_search = "grok-4.5"
8
9[endpoints]
10models_base_url = "https://api.apipass.dev/grok-build/v1"
11
12[model."grok-4.5"]
13model = "grok-4.5"
14name = "Grok 4.5"
15description = "Grok 4.5 ApiPass"
16api_key = "api-key"
17api_backend = "responses"
18context_window = 1000000
19EOF

Wenn Sie den Terminalbefehl verwenden, bearbeiten Sie anschließend die Datei und ersetzen Sie api-key durch Ihren tatsächlichen ApiPass-API-Schlüssel:

1nano ~/.grok/config.toml

Da die Datei Ihren API-Schlüssel enthält, sollten Sie ihre Zugriffsrechte einschränken:

1chmod 600 ~/.grok/config.toml

Konfigurationsreferenz

[cli] sorgt dafür, dass CLI-Aktualisierungen den internen Installationskanal verwenden.
[models] wählt grok-4.5 für normale Prompts und Websuchanfragen aus.
[endpoints] leitet die Modellsuche und Anfragen an die Responses API über ApiPass weiter.
[model."grok-4.5"] registriert das statische Grok-4.5-Modell und speichert den ApiPass-API-Schlüssel zur Authentifizierung von Anfragen.
api_backend = "responses" legt fest, dass die CLI das vom ApiPass-Grok-Build-Endpunkt unterstützte Protokoll der Responses API verwendet.
context_window = 1000000 gibt das Kontextfenster des Modells mit einer Million Token an.

Verwenden Sie die Basis-URL genau wie dargestellt:

1https://api.apipass.dev/grok-build/v1

Hängen Sie nicht /responses an models_base_url an. Grok CLI fügt die Pfade für das Modell und die Responses API automatisch hinzu.

Schritt 3: Konfiguration überprüfen

Prüfen Sie die aktive Grok-CLI-Konfiguration:

1grok inspect

Vergewissern Sie sich, dass grok-4.5 verfügbar ist und der konfigurierte Endpunkt https://api.apipass.dev/grok-build/v1 lautet.

Senden Sie einen einmaligen Prompt, um die Verbindung durchgängig zu überprüfen:

1grok -p "Antworte exakt mit: ApiPass connected" -m grok-4.5

Schritt 4: Grok verwenden

Öffnen Sie eine interaktive Grok-Sitzung in Ihrem aktuellen Projekt:

1grok

Sie können auch einen einzelnen Prompt über die Kommandozeile ausführen:

1grok -p "Prüfe dieses Repository und schlage die wirkungsvollste Verbesserung vor." -m grok-4.5

Durch die Modelleinstellung default verwenden interaktive Sitzungen Grok 4.5, ohne dass Sie jedes Mal -m übergeben müssen.

Kosten und Nutzung

ApiPass zieht Guthaben ab, wenn Grok CLI Anfragen über den Grok-Build-Endpunkt sendet. Der genaue Betrag hängt von der Token-Nutzung und den jeweils geltenden ApiPass-Preisregeln ab.

Auf diesen Seiten können Sie Ihr Konto und Ihre Anfrageaktivitäten einsehen:

Pricing für die aktuellen Modellpreise
API Logs für einzelne Anfragen und Guthabenabzüge
API Usage für die Gesamtnutzung und deren Entwicklung
API Keys, um den in Ihrer Grok-Konfiguration gespeicherten Schlüssel zu verwalten

Fehlerbehebung

`grok: command not found`

Schließen und öffnen Sie Ihr Terminal nach Ausführung des Installationsprogramms erneut. Wenn der Befehl weiterhin nicht verfügbar ist, befolgen Sie die PATH-Anweisungen des Installationsprogramms und öffnen Sie anschließend eine weitere Terminalsitzung.

Konfiguration wird nicht geladen

Vergewissern Sie sich, dass die Datei in demselben Benutzerkonto und derselben Umgebung vorhanden ist, in der Sie Grok CLI ausführen:

1ls -l ~/.grok/config.toml

Wenn Sie WSL2 verwenden, muss sich die Konfiguration im WSL-Home-Verzeichnis befinden. Eine im nativen Windows-Benutzerprofil erstellte Datei wird von der in WSL2 ausgeführten CLI nicht geladen.

Authentifizierung schlägt fehl

Öffnen Sie ~/.grok/config.toml und vergewissern Sie sich, dass api_key einen aktiven ApiPass-API-Schlüssel und nicht den Platzhalterwert enthält:

1api_key = "YOUR_APIPASS_API_KEY"

Auf der ApiPass-Seite API Keys können Sie Schlüssel erstellen oder verwalten.

404 Not Found oder falscher Endpunkt

Vergewissern Sie sich, dass models_base_url den Pfad /grok-build/v1, aber nicht /responses enthält:

1models_base_url = "https://api.apipass.dev/grok-build/v1"

Der Grok-Build-CLI-Endpunkt ist vom allgemeinen Grok-API-Endpunkt getrennt. Verwenden Sie daher für diese Konfiguration die oben angegebene URL.

`model refresh failed`

Einige Versionen von Grok CLI zeigen möglicherweise eine nicht blockierende Warnung vom Typ model refresh failed an, wenn eine benutzerdefinierte models_base_url konfiguriert ist. Mit dem statischen Eintrag [model."grok-4.5"] funktionieren Anfragen an Grok 4.5 dennoch.

Führen Sie den einmaligen Überprüfungs-Prompt aus, um die Verbindung zu bestätigen:

1grok -p "Antworte exakt mit: ok" -m grok-4.5

Modell nicht verfügbar

Verwenden Sie an allen drei Konfigurationsstellen die exakte Modellkennung grok-4.5:

1default = "grok-4.5"
2web_search = "grok-4.5"
3[model."grok-4.5"]

Cookie Preferences

Grok-CLI-Tutorial