Dokumentation

goose

goose trennt den Endpunkt in zwei Teile: eine Host-URL und einen Anfragepfad, den es selbst anhängt. Gib den reinen Ursprung an und lass den Pfad unverändert. So kommuniziert der integrierte OpenAI-Provider über einen einzigen Schlüssel mit Claude und GPT.

Settings → Models → Configure providers → OpenAI: Host URL nimmt den unveränderten Ursprung, da goose den Anfragepfad (v1/chat/completions) selbst anhängt.

Configure providers → OpenAI oder die Umgebung

# goose Desktop → Settings → Models → Configure providers → OpenAI
API Key           sk-kn-...
Host URL          https://api.kunavo.com
Organization ID   (leave blank)
Project           (leave blank)

# …or as environment variables, which goose CLI reads too:
OPENAI_API_KEY=sk-kn-...
OPENAI_HOST=https://api.kunavo.com

# OPENAI_BASE_PATH is left unset on purpose. Its default is
# v1/chat/completions, which is the path Kunavo serves — that default is
# exactly why Host URL above carries no /v1.

In der Host-URL darf kein /v1 stehen. goose beschreibt OPENAI_BASE_PATH als „Anfragepfad, der an den Host angehängt wird (Standardwert: v1/chat/completions)“ und weist Benutzer von Proxys an, OPENAI_HOST auf „den Stamm deines Proxys (ohne nachgestellten Pfad)“ zu setzen. Daraus ergibt sich die richtige Eingabe: Der Ursprung kommt in das Feld, und mit dem Standardpfad folgt /v1. Wenn du https://api.kunavo.com/v1 eingibst, wird /v1/v1/chat/completions angefordert. Auf derselben Seite wird ein 404 als falscher Pfad und nicht als falscher Schlüssel beschrieben.

Diese Konfiguration wurde am unten angegebenen Datum aus der Dokumentation von goose übernommen. Kunavo hat goose nicht mit seinem Endpunkt ausgeführt – weder eine Sitzung noch einen gestreamten Durchlauf oder einen Tool-Roundtrip. Eine veröffentlichte Einrichtungsseite ist kein Test und sollte auch nicht als solcher verstanden werden. Das curl unten kannst du in zehn Sekunden überprüfen; das Verhalten des Clients liegt zwischen dir und goose.

Kunavo stellt keine Modelle für Embeddings, Text-to-Speech oder Speech-to-Text bereit. Dieser Endpunkt verarbeitet daher ausschließlich Chat-Completions. Für alles in deiner goose-Konfiguration, das Audio transkribiert oder einen Vektorindex erstellt, bleibt der bisherige Provider-Schlüssel bestehen. Wenn du den OpenAI-Provider hierher verweist, werden diese Aufrufe nicht umgeleitet.

Noch kein Schlüssel? Erstelle ein Kunavo-Konto, erstelle einen Schlüssel (er beginnt mit sk-kn-) und füge ab $10 Guthaben hinzu – Aufrufe werden aus diesem Guthaben bezahlt, fehlgeschlagene Aufrufe werden nicht berechnet. Das Dashboard öffnet anschließend die goose-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
In goose Desktop: Seitenleiste → Einstellungen → Modelle → Provider konfigurieren → OpenAI. In der CLI: goose configure → Provider konfigurieren → OpenAI.
Trage API-Schlüssel und Host-URL ein. Lass Organisations-ID und Projekt leer. Laut goose dienen sie der Nutzungsverfolgung und Ressourcenverwaltung für OpenAI-eigene Konten; bei Kunavo gibt es keine entsprechenden Angaben. Klicke auf Absenden.
Wähle das Modell aus. goose weist ausdrücklich darauf hin, dass goose configure „die Eingabe benutzerdefinierter Modellnamen nicht unterstützt“. Wenn die gewünschte ID nicht in der angezeigten Liste steht, gib sie in goose Desktop ein oder setze GOOSE_MODEL in config.yaml. Diese Umgebungsvariable überschreibt die Datei für diesen Prozess.
Starte eine Sitzung und gib dem Modell eine Aufgabe, bei der es eine Datei bearbeitet. goose setzt bei fast allem, was es tut, auf Tool-Aufrufe. Auf der eigenen Provider-Seite warnt goose, dass ein Modell ohne Tool-Aufrufe „nur Chat-Completions ausführen kann“ und dafür Erweiterungen deaktiviert werden müssen. Ein erster Durchlauf, bei dem das Modell etwas liest und bearbeitet, sagt daher mehr aus als eine Begrüßung.

Abgeglichen mit goose-Seite „LLM-Provider konfigurieren“ am 29. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in goose.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Modell-ID	Kunavo: Ein- und Ausgabe	Wo es in goose hineinpasst
`claude-sonnet-5`	$1.40 / $7.00	das Standardmodell für Sitzungen, in denen Dateien bearbeitet werden
`claude-opus-5`	$3.50 / $17.50	Planung einer Änderung, bei der ein Fehler teuer wäre
`claude-haiku-4-5`	$0.70 / $3.50	günstige Durchläufe — Triage, Zusammenfassungen und die Schleife, die den ganzen Tag läuft
`gpt-5-6-sol`	$2.00 / $12.00	eine zweite Einschätzung aus einer anderen Modellfamilie, mit demselben Schlüssel und derselben Host-URL

Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben ohne Monatsgebühr – siehe Abrechnung. Bei wiederholtem Kontext – dem Großteil dessen, was ein Editor oder Chat-Client sendet – verändert Prompt-Caching die Rechnung stärker als die Modellwahl.

Der andere Weg: Kunavos Provider-Datei

goose lädt Provider-Definitionen auch aus JSON-Dateien im Verzeichnis custom_providers. Auf diese Weise hinzugefügte Provider erhalten einen eigenen Eintrag im Auswahlmenü, einen eigenen Schlüssel und eine gespeicherte Modellliste, statt den OpenAI-Eintrag zu verwenden. Kunavo stellt eine solche Datei unter kunavo.com/goose/kunavo.json bereit. Sie wird aus dem aktuellen Katalog generiert und enthält daher die Modellliste der Modelle, die Kunavo derzeit bereitstellt. Angegeben ist der Name der Schlüsselvariable, niemals ein Schlüssel:

terminal

# macOS / Linux — goose reads every JSON file in this directory
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://kunavo.com/goose/kunavo.json \
  -o ~/.config/goose/custom_providers/kunavo.json

# The file names the variable; the key itself never goes in the file
export KUNAVO_API_KEY=sk-kn-...
goose session start --provider kunavo

Unter Windows lautet das Verzeichnis %APPDATA%\Block\goose\config\custom_providers\. In goose Desktop erscheint der Provider dann unter Provider konfigurieren als Kunavo. Dort kannst du den Schlüssel im Schlüsselbund statt in der Umgebung speichern.

Endpunkt. Die Datei setzt base_url auf https://api.kunavo.com/v1. In der Dokumentation von goose steht nicht, ob dieses Feld die /v1-Basis oder den vollständigen /v1/chat/completions aus dem Beispiel erwartet. Der Quellcode schafft Klarheit: derive_base_path wandelt beide Angaben in denselben Pfad v1/chat/completions um.
GPT-IDs verwenden die Responses API. goose sendet Modell-IDs, die mit gpt-5 oder gpt-6 beginnen, an /v1/responses und alle übrigen an /v1/chat/completions. Kunavo stellt beides bereit, sodass die Claude- und GPT-IDs in der Datei mit einem Schlüssel funktionieren.
Aufgeführt werden nur Modelle mit Tool-Aufrufen. goose setzt bei fast jedem Durchlauf auf Tools. Deshalb fehlen Bild-, Video- und Audiomodelle in der Datei, obwohl sie mit demselben Schlüssel aufgerufen werden können.

Es gilt derselbe Vorbehalt wie für den Rest dieser Seite: Die Angaben stammen aus der Dokumentation und dem Quellcode von goose; die Konfiguration wurde nicht ausgeführt. Möchtest du den Provider lieber selbst erstellen? Unter Provider konfigurieren → Benutzerdefinierten Provider hinzufügen werden dieselben Angaben abgefragt: Typ OpenAI Compatible, API-URL https://api.kunavo.com/v1, dein sk-kn--Schlüssel und eine durch Kommas getrennte Modellliste.

Häufig gestellte Fragen

Wie richte ich goose auf eine benutzerdefinierte OpenAI-kompatible API aus?

Verwende den integrierten OpenAI-Provider und gib einen Host an. In goose Desktop findest du ihn unter Einstellungen → Modelle → Provider konfigurieren → OpenAI. Die Felder heißen API Key, Host URL, Organization ID und Project. In der CLI lautet der Pfad `goose configure` → Configure Providers → OpenAI; dort wirst du nach denselben Werten gefragt. Als Umgebungsvariablen verwendest du OPENAI_API_KEY und OPENAI_HOST. Wenn du mehrere Endpunkte gleichzeitig benötigst, kannst du im Ablauf „Add Custom Provider“ von goose stattdessen für jeden einen eigenen Eintrag in der Providerliste anlegen.

Muss die Host-URL von goose auf /v1 enden?

Nein. Ein angehängtes /v1 führt zu einem fehlerhaften Request. Laut goose ist OPENAI_BASE_PATH der Anfragepfad, der an den Host angehängt wird; standardmäßig lautet er v1/chat/completions. Benutzer von Proxys sollen OPENAI_HOST auf den Stamm des Proxys setzen, ohne nachgestellten Pfad. In das Feld gehört also der reine Ursprung – https://api.kunavo.com – und /v1 wird durch den Standardpfad ergänzt. Ein Host, der auf /v1 endet, fordert /v1/v1/chat/completions an. Das führt zu einem 404 statt zu einem Authentifizierungsfehler.

Warum gibt goose nach dem Einrichten eines benutzerdefinierten Hosts einen 404-Fehler zurück?

Laut goose bedeutet ein 404-Fehler in der Regel, dass der Basispfad für den betreffenden Endpunkt falsch ist: Die meisten Proxys stellen v1/chat/completions bereit, manche dagegen chat/completions ohne v1. Der von dir festgelegte Wert muss dazu passen. Kunavo stellt v1/chat/completions bereit; das ist der Standardwert von goose. Ein 404 bei Kunavo bedeutet daher meist, dass auch /v1 im Host eingetragen wurde und der Pfad nun doppelt vorkommt. Ein 401-Fehler mit dem Hinweis, dass kein API-Schlüssel übermittelt wurde, hat eine andere Ursache: Laut goose wird ein in config.yaml eingetragener Schlüssel ignoriert.

Kann goose Claude-Modelle über einen OpenAI-kompatiblen Endpunkt verwenden?

Ja. Der Provider-Typ bezeichnet ein Wire-Protokoll, keinen Anbieter: goose sendet eine Chat-Completion im OpenAI-Format an den konfigurierten Host und übermittelt die Modell-ID unverändert. Dadurch wird eine Claude-ID an diesem Endpunkt aufgelöst und nicht innerhalb von goose. Beachte, dass goose intensiv auf Tool-Aufrufe setzt. Laut Provider-Seite kann ein Modell ohne Tool-Aufrufe nur Chat-Completions ausführen, wobei Erweiterungen deaktiviert werden müssen. Wähle deshalb IDs, die Tools unterstützen.

Wurde diese Einrichtung von Kunavo getestet?

Nein. Überprüft wurde die goose-eigene Dokumentation (21. und 29. September 2026) – die Feldnamen, ihre Reihenfolge und die Regel zu Host und Pfad stammen daraus. Für die Provider-Datei wurde außerdem der Provider-Quellcode von goose herangezogen (29. September). Kunavo hat keine goose-Sitzung mit seinem Endpunkt ausgeführt und macht keine Aussagen zum Streaming, zu Tool-Roundtrips oder zum Verhalten von Erweiterungen in diesem Client. Isoliert überprüfen lässt sich nur, ob Endpunkt und Schlüssel überhaupt funktionieren; dafür dient der curl-Befehl auf dieser Seite.

Gibt es eine fertige Kunavo-Provider-Datei für goose?

Ja: https://kunavo.com/goose/kunavo.json. Speichere die Datei im Verzeichnis custom_providers von goose (~/.config/goose/custom_providers/ unter macOS und Linux, %APPDATA%\Block\goose\config\custom_providers\ unter Windows), setze KUNAVO_API_KEY, und Kunavo erscheint mit bereits ausgefüllten Modell-IDs in der Providerliste. Die Datei wird aus dem aktuellen Katalog generiert und führt daher nur Modelle auf, die Kunavo derzeit bereitstellt. Sie enthält keinen Schlüssel.