Goose nutzen: Schritt-für-Schritt-Anleitung zur Goose CLI

Um Goose zu nutzen, installierst du die CLI mit curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash, beantwortest die Fragen von goose configure, um Anbieter und Modell zu wählen, startest dann goose session in einem Projekt und beschreibst, was du willst. Goose startet im Modus auto und führt Befehle deshalb ohne Rückfrage aus, bis du in den Modus approve wechselst.

Diese Anleitung behandelt jeden Schritt für die Goose CLI, Stand November 2026 (Version 1.58): Installation, Einrichtung, Modi, Sitzungen, Extensions, Anweisungsdateien und Recipes, dazu die Fehler, die am meisten Zeit kosten.

Was ist Goose?

Goose ist ein universeller KI-Agent, der auf deinem Rechner läuft. Es gibt ihn als CLI, als Desktop-App für macOS, Linux und Windows und als API, alles in Rust gebaut. Goose ist an kein Modell gebunden: Du bringst einen Anbieter mit, etwa Anthropic, OpenAI, Gemini, OpenRouter oder ein lokales Modell, und Goose übernimmt Tool-Aufrufe, Bearbeitungen und die Arbeit in der Shell.

Block hat Goose entwickelt und es im Dezember 2025 zusammen mit MCP und AGENTS.md an die Agentic AI Foundation unter dem Dach der Linux Foundation übergeben. Im April 2026 ist das Repository nach aaif-goose/goose umgezogen und die Dokumentation nach goose-docs.ai. Ältere Links auf block/goose und block.github.io/goose leiten weiterhin um. Goose steht unter Apache-2.0, und neue Versionen erscheinen etwa einmal pro Woche.

Schritt 1: CLI installieren

Unter macOS, Linux oder Git Bash unter Windows:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

Unter macOS geht stattdessen auch Homebrew. Die Paketnamen enthalten noch „block“:

brew install block-goose-cli        # CLI
brew install --cask block-goose     # desktop app

In der Windows PowerShell:

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1"; .\download_cli.ps1

Die Windows-Binärdatei landet in %USERPROFILE%\.local\bin, das du eventuell zum PATH hinzufügen musst. Später aktualisierst du mit goose update. CLI und Desktop-App teilen sich eine Konfiguration, Anbieter und Extensions aus der einen tauchen also auch in der anderen auf.

Schritt 2: goose configure ausführen

Beim ersten Start läuft goose configure von selbst. Du hast drei Wege: bei OpenRouter anmelden, beim Tetrate Agent Router Service anmelden oder manuell konfigurieren, indem du einen Anbieter wählst, seinen Key einfügst und ein Modell angibst. Seit Version 1.54 fragt es außerdem, in welchem Modus du starten willst.

Keys landen im Schlüsselbund deines Systems (unter macOS in der Keychain). Gibt es keinen Schlüsselbund oder setzt du GOOSE_DISABLE_KEYRING, landen sie stattdessen in einer Klartextdatei secrets.yaml. Du kannst sie auch exportieren:

export ANTHROPIC_API_KEY=...
export GOOSE_PROVIDER=anthropic
export GOOSE_MODEL=claude-sonnet-5-5

Ein Key, der in config.yaml steht, wird ignoriert. Führe goose configure jederzeit erneut aus, um den Anbieter zu wechseln, Extensions hinzuzufügen oder an- und abzuschalten oder die Einstellungen für Modus und Tool-Berechtigungen zu öffnen.

Bezahlst du schon für Claude Code oder ChatGPT Plus/Pro, sieh dir die ACP-Provider an: Mit ihnen nutzt Goose diese Anmeldung statt eines API-Keys.

Schritt 3: Sitzung starten

cd my-project
goose session -n checkout-fix

Beschreibe die Aufgabe in einfachen Worten. Nützliche Tasten und Befehle in einer Sitzung:

• Ctrl+J fügt eine neue Zeile ein; Ctrl+C stoppt die laufende Anfrage oder beendet Goose in einer leeren Zeile.
• /mode, /model, /extension und /builtin ändern die Einrichtung, ohne die Sitzung zu verlassen.
• /compact kürzt die Unterhaltung, wenn sie lang wird; /clear fängt von vorn an.
• /status zeigt die Sitzung samt ihrer ID.

Um später weiterzumachen, führst du goose session -r -n checkout-fix aus. goose session list zeigt alle Sitzungen, und --fork kopiert eine, sodass du eine andere Richtung ausprobieren kannst, ohne das Original zu verlieren.

Schritt 4: Modus vor der echten Arbeit wählen

Goose hat vier Modi:

Du wechselst mit /mode approve in einer Sitzung, setzt GOOSE_MODE oder wählst einen Standard in goose configure. Für feinere Kontrolle legst du in goose configure Berechtigungen pro Tool fest; sie werden in permission.yaml gespeichert. In einem Repository, das dir wichtig ist, startest du mit approve oder smart_approve und lockerst das, sobald du der Einrichtung vertraust.

Schritt 5: Extensions und MCP-Server

Über Extensions bekommt Goose seine Tools, und jeder MCP-Server ist eine Extension. Die Developer-Extension (Shell und Dateibearbeitung) ist standardmäßig an. Weitere eingebaute sind Computer Controller, Memory und Auto Visualiser.

Um eine dauerhaft hinzuzufügen, führst du goose configure → Add Extension aus und wählst einen Kommandozeilen-Server (stdio) oder einen entfernten Server (Streamable HTTP). Für eine einzelne Sitzung:

goose session --with-extension "memory:npx -y @modelcontextprotocol/server-memory"
goose session --with-streamable-http-extension https://example.com/mcp

Gespeicherte Extensions stehen unter extensions: in ~/.config/goose/config.yaml (Windows: %APPDATA%\Block\goose\config\config.yaml). SSE-Server werden nicht mehr unterstützt; nimm Streamable HTTP.

Schritt 6: AGENTS.md und .goosehints

Goose liest AGENTS.md und danach .goosehints auf jeder Ebene vom Arbeitsordner bis zur Git-Wurzel und bezieht verschachtelte Dateien ein, sobald es in Unterordnern arbeitet. Eine globale Datei unter ~/.config/goose/.goosehints gilt für jedes Projekt.

Hat dein Projekt schon eine CLAUDE.md, musst du sie nicht kopieren:

export CONTEXT_FILE_NAMES='["AGENTS.md", ".goosehints", "CLAUDE.md"]'

Halte die Datei kurz: der Stack, wie Tests laufen, was tabu ist und was „fertig“ bedeutet. Was hineingehört, erklärt der Beitrag CLAUDE.md und AGENTS.md schreiben.

Schritt 7: goose run und Recipes

Für einmalige Aufgaben ohne Chat nimmst du goose run:

goose run -t "add a unit test for the price formatter"
goose run -i task.md --output-format json

Ein Recipe ist eine YAML-Datei, die eine Aufgabe mit ihren Anweisungen, Extensions und Parametern speichert, sodass ein Teammitglied oder ein geplanter Job sie wiederholen kann:

goose run --recipe release-notes.yaml --params version=2.4.0
goose schedule add --schedule-id weekly-notes --cron "0 0 9 * * 1" --recipe-source release-notes.yaml

goose recipe validate prüft eine Datei, bevor du sie teilst. Zwei weitere Befehle lohnen sich: goose review fordert ein KI-Review deines Git-Diffs an, und goose info -v zeigt die Version und wo Konfiguration, Sitzungen und Logs liegen.

Typische Stolperfallen

• Den Modus auto anlassen. Der Standard führt Shell-Befehle ohne Rückfrage aus. Wechsle den Modus vor der ersten Aufgabe in einem echten Repository.
• Alter Doku folgen. Tutorials aus 2025 verweisen auf block/goose und block.github.io. Die Befehle funktionieren meist noch, aber die aktuelle Doku liegt auf goose-docs.ai.
• Keys in config.yaml eintragen. Goose ignoriert sie dort. Nutze den Schlüsselbund, goose configure oder Umgebungsvariablen.
• Die veralteten CLI-Provider nutzen. Um mit einer Claude-Code- oder ChatGPT-Anmeldung zu arbeiten, richte stattdessen einen ACP-Provider ein.
• Lange Sitzungen. Die automatische Kompaktierung hält den Kontext im Rahmen, aber eine frische, benannte Sitzung pro Aufgabe hält die Antworten präziser.

Goose neben anderen CLIs in AgentVera betreiben

Goose hat eine eigene Desktop-App, und wenn Goose dein einziger Agent ist, reicht sie vielleicht schon. Schwieriger wird es, wenn Goose im selben Projekt neben Claude Code, Codex oder Gemini CLI läuft. AgentVera ist eine Desktop-App, die diese CLIs nebeneinander in echten Terminals ausführt, mit deinen eigenen Installationen und Keys. Die Goose-Unterstützung funktioniert so:

• Eine benannte Sitzung pro Agent. Jeder Goose-Agent bekommt einen eigenen Sitzungsnamen, und AgentVera öffnet sie bei späteren Starts mit goose session --resume --name wieder, sodass die Unterhaltung einen Neustart der App übersteht.
• Dein Anbieter und deine Keys. Goose nutzt weiter den Anbieter aus goose configure. Unter Einstellungen → Konten kannst du Konten mit API-Keys (Anthropic, OpenAI, OpenRouter, Google) für Goose-Agents hinzufügen.
• Modell, Aufwand und Rolle. Das gewählte Modell wird mit --model übergeben, die Aufwandsstufe über GOOSE_THINKING_EFFORT und die Rolle des Agents mit --system.
• MCP und der Browser. Die Server aus AgentVeras MCP-Manager werden als --with-extension oder --with-streamable-http-extension übergeben, du richtest sie also einmal für jede CLI ein.
• Panes, Worktrees und Review. Lass Goose im Workspace-Raster neben anderen Agents laufen, jeden in seinem eigenen Git-Worktree, und prüfe ihre Änderungen mit dem Code-Review.

Der kostenlose Plan umfasst bis zu 18 Agenten, MCP, Git, Docker, SSH, Code-Review und Token-Einsparungen. Pro kostet 9,99 $ im Monat; wenn du noch nie eine Testphase hattest, schaltet deine erste Anmeldung in der App Pro für 7 Tage frei, ohne Karte. Zum Ausprobieren: AgentVera herunterladen.

Fazit

Für den Start mit Goose brauchst du drei Befehle: Installation, goose configure, goose session. Die wichtigsten Einstellungen kommen direkt danach: vom Modus auto auf approve wechseln, die nötigen Extensions hinzufügen und dem Projekt eine AGENTS.md geben. Wiederholt sich eine Aufgabe, speicherst du sie als Recipe.

Quellen: Goose-Installation, CLI-Befehle, Berechtigungen, Extensions, Hints-Dateien, Releases.