Grok Build in zwei Minuten unter macOS, Linux oder Windows installieren

Vor der Installation

Grok Build ist eine Terminal-App von SpaceXSI (ehemals xAI). Es gibt vorkompilierte Binärdateien für macOS, Linux und Windows. Sie brauchen:

• Ein Terminal: Terminal oder iTerm unter macOS, eine beliebige Shell unter Linux, PowerShell oder Git Bash unter Windows.
• Einen Webbrowser für die erste Anmeldung oder einen API-Schlüssel, wenn Sie es auf einem Server einrichten.
• Ein Konto. Grok Build lässt sich kostenlos ausprobieren, und der Plus-Plan von The X Subscription ($8 pro Monat) sowie höhere Tarife bieten mehr Nutzung.

Installationsbefehle

1. macOS, Linux oder Git Bash: Führen Sie curl -fsSL https://x.ai/cli/install.sh | bash aus
2. Windows PowerShell: Führen Sie irm https://x.ai/cli/install.ps1 | iex aus
3. Prüfen, ob es geklappt hat: Führen Sie grok --version aus. Wird eine Versionsnummer angezeigt, war die Installation erfolgreich.

Beide Befehle stammen von der offiziellen Grok-Build-Seite und aus dem GitHub-Repo. Laut einer Einrichtungsanleitung eines Drittanbieters legt der Installer das Programm in ~/.grok/bin ab.

Entwickler können es auch aus dem Quellcode bauen. Dafür brauchen Sie eine Rust-Toolchain (über rustup installiert und fixiert), DotSlash (cargo install dotslash) und protoc. Unterstützte Build-Systeme sind macOS und Linux. Windows-Builds sind „best-effort“ (ohne Gewähr), daher sollten Windows-Nutzer die vorkompilierte Binärdatei verwenden.

Erster Start und Anmeldung

1. Öffnen Sie ein Terminal in Ihrem Projektordner, nicht in Ihrem Home-Ordner.
2. Führen Sie grok aus.
3. Ein Browserfenster öffnet sich zur Anmeldung, meist auf grok.com.
4. Nach der Anmeldung startet die Terminal-Oberfläche. Die Zugangsdaten werden in ~/.grok/auth.json gespeichert.

Warum der Projektordner wichtig ist: Im Juli 2026 konnte das Ausführen von Grok Build das gesamte aktuelle Verzeichnis in den Cloud-Speicher des Unternehmens hochladen. SpaceXSI hat das noch am selben Tag deaktiviert und sagt, Build könne jetzt vollständig lokal laufen. Im Projektordner zu starten ist trotzdem die sicherere Gewohnheit, denn der Agent kann dort, wo er läuft, Dateien lesen und bearbeiten.

Standardmäßig nutzt Grok Build den Plan mode: Es schlägt einen Plan vor und nimmt keine Änderungen vor, bis Sie ihn freigeben.

Aktualisieren und Einrichtung prüfen

• grok update aktualisiert Grok Build auf die neueste Version.
• grok doctor prüft Ihre Terminal-Einrichtung und meldet Probleme.
• grok --version zeigt die installierte Version an.

Aktualisieren Sie oft. SpaceXSI liefert Funktionen schnell aus, und neue Modelle wie Grok 4.7 kommen am Erscheinungstag in Grok Build an.

Einen API-Schlüssel in CI nutzen

Eine Browser-Anmeldung funktioniert auf Build-Servern nicht. Setzen Sie für CI stattdessen die Umgebungsvariable XAI_API_KEY und nutzen Sie den Headless-Modus für Skripte und Pipelines.

1. Erstellen Sie ein Konto auf console.x.ai.
2. Laden Sie Guthaben auf. Die API ist prepaid, und Anfragen werden abgelehnt, wenn das Guthaben aufgebraucht ist.
3. Erzeugen Sie auf der Seite API Keys einen Schlüssel.
4. Speichern Sie ihn als Secret in Ihrem CI-System und stellen Sie ihn als XAI_API_KEY bereit.

Die Nutzung über einen API-Schlüssel wird zu API-Tarifen abgerechnet, nicht aus Ihrem Abo-Kontingent. Das Modell grok-build-0.1 kostet $1 pro Million Input-Tokens und $2 pro Million Output-Tokens.

Konfigurationsdatei und Berechtigungen

Grok Build speichert seine Einstellungen in ~/.grok/config.toml. Dort werden MCP-Server konfiguriert, für Verbindungen zu Tools wie Linear, Sentry oder Postgres.

Projektspezifische Konventionen gehören in eine AGENTS.md-Datei im jeweiligen Verzeichnis. Ein Ratgeber eines Drittanbieters nennt diese Berechtigungsmodi: default, acceptEdits, auto, dontAsk, bypassPermissions und plan. Nützliche Flags sind unter anderem --worktree, --no-plan und --no-subagents. Vermeiden Sie bypassPermissions, sofern Sie Build nicht in einer Sandbox ausführen.

Häufige Probleme

• „grok: command not found“: Öffnen Sie ein neues Terminal, damit Ihre Shell den Pfad neu lädt, und prüfen Sie, ob ~/.grok/bin in Ihrem PATH liegt.
• Die Anzeige sieht kaputt aus: Führen Sie grok doctor aus, um die Terminal-Unterstützung zu prüfen.
• Das Anmeldefenster öffnet sich nicht: Nutzen Sie auf einem entfernten Rechner stattdessen XAI_API_KEY.
• API-Schlüssel abgelehnt: Prüfen Sie, ob auf Ihrem Konsolen-Konto Guthaben geladen ist.
• Grok 4.7 Fast fehlt: Fast ist nicht Teil des kostenlosen Tarifs.
• Nutzung aufgebraucht: Bezahlte Pläne teilen sich ein Wochenkontingent mit dem Grok-Chat und Cursor. Intensive Nutzung an einer Stelle lässt weniger für die anderen übrig.

Häufige Fragen