Grok CLI und Grok Build: Installation und API-Einrichtung

„Grok CLI“ kann zwei verschiedene Werkzeuge bezeichnen:

• Grok Build — der offizielle Coding Agent von xAI;
• Community Grok CLI — ein Open-Source-Projekt ohne Verbindung zu xAI.

Im macOS-Test mit einem GPT-Modell gab Community Grok CLI 1.1.7 bei Textanfragen OK zurück, der Datei-Lesetest wurde jedoch nicht erfolgreich abgeschlossen. Grok Build 1.0.67 verarbeitete Textanfragen und Datei-Leseaufrufe mit api_backend = "chat_completions"; sein Responses-Stream scheiterte beim clientseitigen Parsen (siehe Grok Build). Beide Konfigurationen verwenden einen BetterToken API Key, eine Base URL und eine Model ID.

Beide Werkzeuge verwenden den Befehl grok. Sind beide installiert, startet die zuerst in PATH gefundene Version.

Grok CLI und Grok Build im Vergleich

Merkmal	Offizieller Grok Build	Community Grok CLI
Entwickler	xAI	superagent-ai/grok-cli, nicht mit xAI verbunden
Geeignet für	Nutzer des offiziellen xAI-Coding-Agenten	Nutzer, die ein Modell über eine eigene Base URL aufrufen möchten
Authentifizierung	Browser-Anmeldung oder XAI_API_KEY	GROK_API_KEY
Eigene Base URL	In ~/.grok/config.toml	Mit GROK_BASE_URL
Modell	Alias in der Konfiguration	GROK_MODEL
Modelle über BetterToken aufrufen	Textanfragen und Datei-Leseaufrufe erfolgreich (1.0.67, chat_completions)	Textanfrage gab OK zurück; Datei-Lesetest fehlgeschlagen (1.1.7)
Startbefehl	grok	grok

Diese Anleitung behandelt Text- und Codeanfragen über BetterToken. xAI-spezifische APIs wie X Search, Sprachtranskription sowie Bild- und Videogenerierung sind nicht enthalten.

Community Grok CLI mit BetterToken verwenden

Die folgenden Befehle gelten für macOS, Linux und WSL. Die native Windows-Installation des Community-Clients wurde nicht getestet.

Installation

curl -fsSL https://raw.githubusercontent.com/superagent-ai/grok-cli/main/install.sh | bash
grok --version

Mit bereits installiertem Bun:

bun add -g grok-dev

Das ältere Paket @vibe-kit/grok-cli wird in der aktuellen README des Projekts nicht mehr als Installationsweg empfohlen.

BetterToken konfigurieren

export GROK_BASE_URL="https://bettertoken.ai/v1"
export GROK_API_KEY="YOUR_API_KEY"
export GROK_MODEL="YOUR_MODEL_ID"

Ersetze YOUR_MODEL_ID durch die vollständige Model ID aus der model plaza und verwende deinen BetterToken API Key.

Verbindung prüfen

grok -p "Reply with only: OK"

Erst eine Modellantwort bestätigt, dass API Key, Base URL und Model ID funktionieren. Starte den Client nach Änderungen an Umgebungsvariablen neu.

Community Grok CLI 1.1.7 gab bei allen drei Textversuchen OK zurück, meldete jedoch Stream-Validierungsfehler: Am Stream-Ende wurde delta.role: null abgelehnt; außerdem traten Schemafehler in Fortsetzungs-Chunks von Tool-Aufrufen auf. Der Datei-Lesetest wurde nicht erfolgreich abgeschlossen. Verwende diesen Client nur für Textanfragen innerhalb des getesteten Umfangs; Datei-Leseaufrufe haben nicht bestanden.

Eine offene Grok-CLI-Sitzung lädt Umgebungsvariablen nicht automatisch neu. Beende den Client und starte ihn nach einer Konfigurationsänderung erneut.

Modell wechseln

Setze GROK_MODEL auf eine andere vollständige Model ID, starte Grok CLI neu und wiederhole die kurze Anfrage.

Offizieller Grok Build

Grok Build ist der offizielle Terminal-Coding-Agent von xAI. Er unterstützt eine interaktive TUI, den Headless-Betrieb und ACP.

Installation und Anmeldung

macOS / Linux / WSL

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

Windows PowerShell

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

Ein xAI-Konto oder einen API Key verwenden

Beim ersten Start öffnet Grok Build zur Anmeldung einen Browser. Für Umgebungen ohne Browser dokumentiert xAI XAI_API_KEY:

export XAI_API_KEY="YOUR_XAI_API_KEY"
grok

Optional: BetterToken in Grok Build konfigurieren

Grok Build unterstützt OpenAI-kompatible benutzerdefinierte Modelle mit Base URL, Model ID, Authentifizierungs-Umgebungsvariable und Anfrageprotokoll.

[model.bettertoken]
model = "YOUR_MODEL_ID"
base_url = "https://bettertoken.ai/v1"
name = "BetterToken"
env_key = "BETTERTOKEN_API_KEY"
api_backend = "chat_completions"

[models]
default = "bettertoken"

BETTERTOKEN_API_KEY ist ein Beispiel für einen Variablennamen und keine feste Grok-Build-Anforderung. Grok Build liest die in env_key benannte Variable.

export BETTERTOKEN_API_KEY="YOUR_API_KEY"
grok inspect
grok -p "Reply with only: OK" -m bettertoken

Grok Build 1.0.67 verarbeitete Textanfragen und Datei-Leseaufrufe mit api_backend = "chat_completions". Mit responses erhielt es einen HTTP-200-Stream, scheiterte beim clientseitigen Parsen zunächst an keepalive; der aufgezeichnete Stream enthielt außerdem response.metadata. Verwende chat_completions, wenn unknown variant keepalive oder unknown variant response.metadata auftritt. xAI-spezifische APIs wurden nicht getestet.

Zusätzliche Modellanfragen

Beide Clients können zusätzliche Anfragen an selbst ausgewählte Modelle senden, etwa grok-4.20-non-reasoning in Community Grok CLI und grok-4.6 in Grok Build. Im Test antwortete BetterToken für diese Zusatzmodelle mit 503 model_not_found und No available channel, während die Hauptanfrage erfolgreich war. Wenn die Hauptanfrage abgeschlossen wird, kannst du diese Fehler ignorieren; sie bedeuten nicht, dass die ausgewählte Model ID fehlgeschlagen ist.

Konflikte mit dem Befehl grok vermeiden

macOS / Linux / WSL

type -a grok
grok --version

Windows PowerShell

Get-Command grok -All
grok --version

type -a grok und Get-Command grok -All listen alle Befehle mit demselben Namen auf. Entferne den ungenutzten Client oder passe PATH an, wenn beide installiert sind.

Häufige Fehler

Problem	Prüfung
Nach der Installation startet der falsche Grok-Client	Liste jeden grok-Befehl auf und prüfe Pfad und Version.
Grok Build scheitert mit unknown variant response.metadata	Setze api_backend = "chat_completions" für das BetterToken-Modell und führe grok inspect erneut aus.
Der offizielle Grok Build öffnet einen Browser	Dies ist der Standard-Anmeldeablauf von Grok Build. Verwende ihn mit xAI; für BetterToken konfiguriere ein benutzerdefiniertes Modell.
401 oder Unauthorized	Ein benutzerdefiniertes Grok-Build-Modell liest die von env_key benannte Variable; der Community-Client liest GROK_API_KEY. Setze nur die Variable für den aktuellen Client.
model not found	Kopiere die vollständige Model ID aus der model plaza und starte den Client neu.
Anfragen gehen weiterhin an xAI	Prüfe GROK_BASE_URL für den Community-Client. Führe in Grok Build grok inspect aus, um base_url und den aktiven Modellalias zu prüfen.
Eine xAI-spezifische Funktion funktioniert nicht	BetterToken verarbeitet nur die hier beschriebenen Modellanfragen. Verwende die offizielle xAI-API für X Search, Sprache und Medienfunktionen.

• Alle unterstützten Tools vergleichen
• API-Fehler, Statuscodes und Ratenbegrenzungen

Modelle und Funktionsgrenzen

Kopiere eine vollständige Model ID für OpenAI-kompatible Anfragen aus der model plaza. Eine konfigurierbare Base URL allein belegt nicht, dass Anfragen, Tool-Aufrufe oder das Kontextformat einer Modellfamilie kompatibel sind.

Diese Seite behandelt nur Text- und Codeanfragen. Über diese Konfiguration stellt BetterToken weder X Search noch Sprachtranskription, Bild- und Videogenerierung oder andere xAI-spezifische APIs bereit.

Quellen

• BetterToken model plaza

• Grok Build: xAI-Übersicht

• Grok Build: Settings Reference

• Community Grok CLI: Repository

• BetterToken-Protokolle