goose installieren und einen benutzerdefinierten Anbieter konfigurieren

goose ist ein KI-Assistent für allgemeine Zwecke, der auf Ihrem Computer läuft. Neben dem Programmieren kann er bei Recherche, Schreiben, Automatisierung und Datenorganisation helfen. Sie können ihn über die Desktop-App, das Terminal oder die API nutzen; Desktop- und Terminal-Version teilen sich dieselbe Modellkonfiguration. Er eignet sich für wiederkehrende Programmieraufgaben und kann auch eine Verbindung zu GitHub, Datenbanken und Dateien herstellen.

Vorbereitung

goose bietet zwei Installationsoptionen: Desktop und CLI. Desktop ist die grafische Version mit Fenster, während CLI durch Eingabe von Befehlen in einem Terminal verwendet wird. Beide teilen sich dieselbe Kernkonfiguration, einschließlich Anbieter (Provider) und Modell. Ein Anbieter ist die Verbindungskonfiguration, die goose mitteilt, welcher Modelldienst verwendet werden soll.

Möchten ein Fenster

goose Desktop

Zip auf macOS herunterladen
Oder brew cask verwenden
Installationspaket auf Linux verwenden

Nur Terminal

goose CLI

download_cli.sh
Oder Homebrew CLI
Dann goose session ausführen

Windows

Zuerst eine Umgebung wählen

Git Bash oder MSYS2
Sie können auch PowerShell verwenden
Falls der Befehl nicht gefunden wird, zu PATH hinzufügen

Auf macOS können Sie es durch Herunterladen der App oder über Homebrew installieren. Auf Linux verwenden Sie das Paket Ihrer Distribution für die Desktop-Version. Auf Windows prüfen Sie zuerst die unterstützten Terminalumgebungen.

Halten Sie vor dem Start die Modell-ID aus der aktuellen Modellliste bereit. Eine Modell-ID ist der Name, den der Modelldienst zur Identifizierung eines bestimmten Modells verwendet; Sie müssen die vollständige ID kopieren.

Installation und erster Start

Wenn Sie ein grafisches Fenster wünschen

Es gibt zwei dokumentierte Installationsmethoden für macOS:

Laden Sie es von der Installationsseite herunter. Die Seite bietet Versionen für macOS Silicon und macOS Intel. Entpacken Sie nach dem Download die Zip-Datei und führen Sie die Anwendung darin aus.
Alternativ verwenden Sie Homebrew:

brew install --cask block-goose

Dies lädt dieselbe Anwendung herunter und kann auch Updates verwalten.

Wenn Sie einen Apple Mac M3 verwenden und nach dem Öffnen der App kein Fenster erscheint, prüfen Sie, ob ~/.config les- und schreibbar ist. goose verwendet dieses Verzeichnis zum Schreiben von Protokollen.

Für die Linux-Desktop-Version laden Sie diese von der Installationsseite herunter. Verfügbare Pakete sind DEB für Ubuntu/Debian, RPM für RHEL/Fedora und Flatpak. Laden Sie unter Debian oder Ubuntu die DEB-Datei herunter, öffnen Sie das Verzeichnis, in dem sie gespeichert wurde, führen Sie sudo dpkg -i (filename).debaus und öffnen Sie goose dann über das Anwendungsmenü. Ersetzen Sie (filename) durch den tatsächlichen Dateinamen.

Für die Windows-Desktop-Version laden Sie diese von der Installationsseite herunter, entpacken die Zip-Datei und führen die Anwendung darin aus.

Wenn Sie nur die Terminal-Version wünschen

Führen Sie auf macOS und Linux aus:

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

Um die interaktive Konfiguration während der Installation zu überspringen, fügen Sie CONFIGURE=false vor bash:

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

Auf macOS können Sie auch ausführen:

brew install block-goose-cli

Um eine installierte CLI zu aktualisieren, führen Sie aus:

goose update

Auf Windows ist eine der folgenden drei Umgebungen erforderlich: Git Bash, die mit Git for Windows geliefert und als empfohlen markiert ist; MSYS2; oder PowerShell, die mit Windows 10/11 geliefert wird. Verwenden Sie in Git Bash und MSYS2 denselben download_cli.sh Befehl wie oben gezeigt. Laden Sie in PowerShell zuerst das Skript herunter und führen Sie es dann aus:

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

Wenn Ihnen mitgeteilt wird, dass goose nicht im PATH ist, folgen Sie der Installationsseite und fügen Sie ~/.local/bin oder %USERPROFILE%\.local\bin zur aktuellen Shell-Konfiguration hinzu und starten Sie dann das Terminal neu. PATH ist eine Reihe von Verzeichnissen, die das Terminal nach Programmen durchsucht. Wenn das Installationsverzeichnis nicht enthalten ist, können Sie ein installiertes Programm möglicherweise nicht durch Eingabe seines Namens direkt ausführen.

Am 09.10.2026 war die CLI-Version 1.54.0. Standardmäßig platziert das Installationsskript das Programm in ~/.local/bin. Sie können dieses Verzeichnis mit der GOOSE_BIN_DIR Umgebungsvariable ändern. Wenn Sie es ändern, aktualisiert das Skript die Shell-Konfiguration nicht automatisch, und das Terminal meldet, dass das Verzeichnis nicht im PATH ist. Fügen Sie dieses Verzeichnis zum PATH hinzu oder führen Sie goose mit seinem vollständigen Pfad aus.

Beim ersten Mal, wenn Sie goose verwenden, werden Sie aufgefordert, einen Anbieter zu konfigurieren. Sie können die integrierten Anbieter überspringen und einen benutzerdefinierten Anbieter wie im nächsten Abschnitt beschrieben hinzufügen. Navigieren Sie im Terminal zu dem Verzeichnis, in dem Sie arbeiten möchten, und führen Sie aus:

goose session

Verbindungswerte aus OmniProxy abrufen

Bereiten Sie Adresse, Schlüssel und Modellname aus Ihrer eigenen OmniProxy-Instanz vor. Das Beispiel für einen benutzerdefinierten Anbieter verwendet eine base_url die auf /v1/chat/completionsendet, daher folgt diese Anleitung demselben Format:

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   Copy from the current OmniProxy model list; separate multiple models with commas

Kopieren Sie den vollständigen Modellnamen aus der aktuellen OmniProxy-Liste, einschließlich etwaiger Schrägstriche. Am 09.10.2026 waren zwei Referenz-IDs in der Anbieterdokumentation grok-4.7 für Grok und gpt-6-luna aus der OpenAI-Dokumentation. gpt-6-luna unterstützt Chat Completions; Funktionsaufrufe in Chat Completions werden nur unterstützt, wenn reasoning_effort auf nonegesetzt ist. Kopieren Sie keinen Namen, der nicht in der Liste erscheint.

Tool-Konfiguration eingeben

Ein benutzerdefinierter Anbieter kann ein OpenAI-, Anthropic- oder Ollama-kompatibles Format verwenden. Ein kompatibles Format bedeutet, dass das Tool Anfragen gemäß einer gemeinsamen API-Spezifikation sendet. Wählen Sie bei der Verbindung mit OmniProxy OpenAI Compatible.

Desktop

Klicken Sie auf die Schaltfläche in der oberen linken Ecke, um die Seitenleiste zu öffnen.
Klicken Sie auf Settings.
Klicken Sie auf Models.
Klicken Sie auf Configure providers.
Klicken Sie unten im Fenster auf Add Custom Provider.
Wählen Sie für den Anbietertyp OpenAI Compatible. Sie können den Anzeigenamen auf OmniProxy setzen. Geben Sie die Adresse aus dem vorherigen Abschnitt in API URL ein. Wenn ein Schlüssel erforderlich ist, wählen Sie die Option, die einen API-Schlüssel erfordert, und geben Sie Ihren OmniProxy-Schlüssel ein. Geben Sie unter Available Models die Modellnamen ein und trennen Sie mehrere Namen durch Kommas.
Klicken Sie auf Create Provider.

Die Desktop-Version kann derzeit keine benutzerdefinierten Anfrage-Header in diesem Fenster definieren. Wenn Sie Anfrage-Header benötigen, bearbeiten Sie die Konfigurationsdatei nach dem Erstellen des Anbieters.

Terminal

Führen Sie aus:

goose configure

Wählen Sie Custom Providers und dann Add A Custom Provider. Wählen Sie für den API-Typ OpenAI Compatible und folgen Sie dann den Anweisungen zur Eingabe von Name, API-URL, ob ein Schlüssel erforderlich ist, Modellnamen und ob Streaming-Antworten unterstützt werden.

Wenn Sie unter Windows manuell konfigurieren und der Schlüsselbund einen Fehler meldet, besagen die Installationsanweisungen, das Speichern des Schlüssels im Schlüsselbund abzulehnen und stattdessen eine Umgebungsvariable zu verwenden. Führen Sie dann goose configure erneut aus. Der Schlüsselbund ist ein kleines sicheres Speichersystem, das vom Betriebssystem zum Speichern von Geheimnissen verwendet wird.

Konfigurationsdatei

Die dokumentierten Verzeichnisse sind:

macOS und Linux: ~/.config/goose/custom_providers/
Windows: %APPDATA%\Block\goose\config\custom_providers\

Sie können die Datei auf dem bereitgestellten Beispiel basieren. Ersetzen Sie Name, Adresse und Modelle durch Ihre eigenen Werte. Speichern Sie den Schlüssel in der Umgebungsvariable, die durch api_key_envangegeben ist; schreiben Sie den echten Schlüssel nicht in die Datei:

{
  "name": "omniproxy",
  "engine": "openai",
  "display_name": "OmniProxy",
  "api_key_env": "OMNIPROXY_API_KEY",
  "base_url": "https://your-omniproxy-origin.example/v1/chat/completions",
  "models": [
    { "name": "grok-4.7", "context_limit": 128000 },
    { "name": "gpt-6-luna", "context_limit": 128000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Behalten Sie einen numerischen Wert für context_limitbei, wie im Beispiel gezeigt. Das tatsächliche Kontextlimit hängt vom Modell und OmniProxy ab; behandeln Sie die Beispielzahl nicht als offizielles Limit des Modells. Führen Sie vor der Verwendung aus:

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

Wechseln Sie nach dem Betreten des Arbeitsverzeichnisses und führen Sie aus:

goose session --provider omniproxy --model grok-4.7

Ersetzen Sie den Wert von --model durch die vollständige ID aus der Liste. goose session hat keinen start Unterbefehl. Sie können auch --provider und --model durch die GOOSE_PROVIDER und GOOSE_MODEL Umgebungsvariablen setzen. Auch wenn das Gateway keine Schlüssel validiert, OMNIPROXY_API_KEY muss dennoch einen Wert haben. Es kann eine Platzhalter-Zeichenfolge sein, die nur auf Ihrem lokalen Computer verwendet wird. Diese Konfiguration konnte im Test am 09.10.2026 erfolgreich eine Datei lesen.

Fenster

Einstellungen

Einstellungen in der Seitenleiste
Modellseite
Benutzerdefinierten Anbieter hinzufügen

Terminal

goose configure

Benutzerdefinierte Anbieter auswählen
Dann Hinzufügen auswählen
OpenAI Compatible als Typ wählen

Datei

custom_providers

Auf macOS und Linux unter ~/.config
Auf Windows unter APPDATA
base_url gemäß offiziellem Beispiel setzen

Alle drei Methoden erstellen denselben Konfigurationstyp. Wählen Sie OpenAI Compatible als Anbietertyp.

Überprüfung mit einer echten Aufgabe

Öffnen Sie ein Verzeichnis mit einer regulären Datei und führen Sie goose session wie im vorherigen Abschnitt gezeigt aus. Bitten Sie es, die erste Zeile einer von Ihnen angegebenen Datei zu lesen. Es sollte den Dateiinhalt zurückgeben, anstatt nur zu sagen, dass die Konfiguration gespeichert wurde.

Um Dateien zu lesen oder Befehle auszuführen, benötigt die Sitzung die Developer-Erweiterung. Die Developer-Erweiterung ist ein Tool-Modul, mit dem goose mit lokalen Dateien und Befehlen arbeiten kann. Sie ist im Allgemeinen in der Standardkonfiguration enthalten. Wenn goose meldet, dass es keine Dateitools hat, fügen Sie dem Befehl Folgendes hinzu:

--with-builtin developer

Fügen Sie nicht auch --no-profilehinzu, da diese Option die Standarderweiterungen deaktiviert.

Im Test am 09.10.2026 konnte goose 1.54.0 erfolgreich die erste Zeile der angegebenen Datei lesen. Die erste Antwort kann etwa eine Minute dauern.

Prüfen Sie dann die OmniProxy-Anfrageprotokolle, um Quelle und Modellname zu bestätigen.

Starten

Eine Sitzung öffnet sich

goose session
Anbieter ist der gerade hinzugefügte
Der Modellname steht in der Liste

Aufgabe

Es hat die Aufgabe tatsächlich erledigt

Zum Beispiel das aktuelle Verzeichnis auflisten
Antwort prüfen
Verlassen Sie sich nicht nur auf ein erfolgreiches Speichern

Protokolle

Im Gateway sichtbar

Verwenden Sie die Adresse aus dem Dokumentationsbeispiel
Speichern Sie den Schlüssel nicht im Repository
Die Modell-ID stimmt mit der Liste überein

Bestätigen Sie den Anbieter nach dem Speichern mit einer echten Sitzung.

Häufige Fehler

Der goose Befehl kann nicht gefunden werden: Fügen Sie das Installationsverzeichnis zum PATH hinzu, wie auf der Installationsseite beschrieben, und starten Sie dann das Terminal neu.
Kein Fenster erscheint in der Desktop-Version auf einem M3-Mac: Prüfen Sie die Lese- und Schreibberechtigungen für ~/.config.
Der Schlüsselbund schlägt fehl: Speichern Sie den Schlüssel nicht im Schlüsselbund; verwenden Sie stattdessen eine Umgebungsvariable.
Das Modell ist nicht in der Liste: Wählen Sie in der Desktop-Version Use custom model und geben Sie den Modellnamen manuell ein. goose configure kann keinen benutzerdefinierten Modellnamen akzeptieren. Wechseln Sie für die Terminalnutzung zur Desktop-Version oder bearbeiten Sie GOOSE_MODEL direkt in der Konfiguration.
Die Adresse ist nicht erreichbar: Bestätigen Sie, dass die API-URL auf /v1/chat/completionsendet, wie im Beispiel, und dass OmniProxy läuft.
Es meldet, dass es Dateien nicht lesen kann: Fügen Sie die Developer-Erweiterung hinzu und verwenden Sie nicht --no-profile.
Es gibt unsupported Responses role: systemzurück: Die Adresse ist normalerweise korrekt. Wechseln Sie zu einer anderen vollständigen ID aus der Modellliste.

Offizielle Referenzen

Für die Installation siehe Install goose. Für benutzerdefinierte Anbieter siehe goose providers. Für die in den Beispielen verwendeten Modell-IDs siehe die xAI-Modellseite und GPT-6 Luna.

Ersetzen Sie jeden Platzhalter mit Werten aus Ihrer eigenen OmniProxy-Konfiguration. Veröffentlichen Sie niemals einen echten Schlüssel.

Ein gespeicherter HTTP 200 allein beweist keine vollständige Agenten-Kompatibilität. Überprüfen Sie die Quelle und das Modell im Aufrufprotokoll von OmniProxy.

Offizielle Quellen · goose ↗