Skip to main content
Goose ist der quelloffene, auf dem Gerät ausgeführte Coding-Agent von Block. Goose hat keinen integrierten Tokios-Anbieter, unterstützt aber benutzerdefinierte Anbieter über eine JSON-Datei, sodass Sie es auf https://api.tokios.com/v1 verweisen und jedes Modell hinter Ihrem Connector erreichen können.

​
Voraussetzungen

​
Einen benutzerdefinierten Anbieter konfigurieren

Erstellen Sie eine benutzerdefinierte Anbieterdatei für Goose. Die Konfiguration für benutzerdefinierte Anbieter hat sich über verschiedene Goose-Versionen hinweg geändert, daher bestätigen Sie das genaue JSON-Schema (Feldnamen, erforderliche versus optionale Schlüssel und ob ein models-Array oder eine andere Struktur erwartet wird) anhand Ihrer installierten Version.
Erstellen Sie eine JSON-Datei in ~/.config/goose/custom_providers/:
tokios.json
Die Datei benennt eine Umgebungsvariable statt den Schlüssel selbst zu enthalten, also exportieren Sie sie vor dem Start von Goose:
Ersetzen Sie gemma-tunnel durch den öffentlichen Deployment-Namen, den Sie auf der Models-Registerkarte registriert haben — nicht die lokale Modell-ID, die Ihr Backend (Ollama, llama.cpp, vLLM oder LM Studio) verwendet. Da api_key_env nur den Variablennamen speichert, ist diese Datei sicher zum Committen; der Schlüssel gelangt niemals darin.
Wenn Anfragen 404, prüfen Sie, wie Ihr Goose-Release base_url interpretiert. Das benutzerdefinierte Provider-Beispiel von Goose schreibt den vollständigen Endpunkt-Pfad (.../v1/chat/completions) statt nur die /v1-Root, und die beiden Formen sind nicht austauschbar — versuchen Sie https://api.tokios.com/v1/chat/completions, wenn https://api.tokios.com/v1 fehlschlägt.

​
Alternative: der integrierte OpenAI-Provider

Wenn Sie keinen Provider-Datei hinzufügen möchten, akzeptiert der integrierte openai-Provider von Goose einen benutzerdefinierten Host. Goose speichert diese in ~/.config/goose/config.yaml:
OPENAI_HOST ist die Host-Root und OPENAI_BASE_PATH ist der Anforderungspfad, der standardmäßig auf v1/chat/completions gesetzt ist — den Pfad, den Tokios bereitstellt, sodass Sie ihn normalerweise ungesetzt lassen.

​
Alternative: Umgebungsvariable

Statt einer benutzerdefinierten Provider-Datei können Sie den OpenAI-kompatiblen Client von Goose mit der OPENAI_HOST-Umgebungsvariable auf Tokios zeigen. Bestätigen Sie anhand Ihrer installierten Version, ob OPENAI_HOST den bloßen Host oder den vollständigen /v1-Pfad erwartet, und ob es zur Authentifizierung die Paarung mit OPENAI_API_KEY erfordert.
Goose behandelt Anthropic als separaten First-Party-Provider, und eine generische benutzerdefinierte Anthropic-Base-URL ist noch nicht verfügbar (verfolgt als offene Feature-Anfrage: block/goose#3777). Verwenden Sie den oben genannten OpenAI-kompatiblen Provider-Slot, um Tokios zu erreichen.

​
Wählen Sie ein Tool-fähiges Modell

Gooses Agent ist auf Tool-Calling angewiesen, um Dateien zu lesen, Befehle auszuführen und Code zu bearbeiten. Nicht jedes lokale Modell unterstützt Tool-Calls zuverlässig — wählen Sie eine Deployment, die von einem Modell mit starker Tool-Calling-Unterstützung gestützt wird, bevor Sie sich für echte Bearbeitungen auf Goose verlassen. Weitere Hinweise zur Auswahl eines Modells für agentic Coding finden Sie unter Modell nach Aufgabe auswählen.

​
Fehlerbehebung

Der von Goose gesendete API-Schlüssel fehlt, ist fehlerhaft oder wurde widerrufen. Stellen Sie sicher, dass api_key (oder OPENAI_API_KEY) den vollständigen sk-tok-…-Schlüssel ohne zusätzliche Leerzeichen enthält, und prüfen Sie dessen Status auf der Keys-Registerkarte.
Der Modellname in models stimmt nicht mit einer registrierten Deployment überein. Stellen Sie sicher, dass er exakt dem öffentlichen Namen auf der Models-Registerkarte entspricht — nicht Ihrer lokalen Modell-ID von Ollama, llama.cpp, vLLM oder LM Studio.
Der Connector für diese Deployment ist offline oder hat sein gleichzeitiges Limit erreicht. Prüfen Sie die Connectors-Registerkarte — der Connector muss als Online angezeigt werden, und der Rechner, auf dem er läuft, muss weiterhin erreichbar sein.

​
Nächste Schritte

Schnellstart

Richten Sie Ihren Connector ein, registrieren Sie ein Modell und erstellen Sie einen API-Schlüssel von Grund auf neu.

Wählen Sie ein Modell nach Aufgabe

Ordnen Sie einem lokalen Modell agentic Coding-Arbeiten zu, bevor Sie es in Goose integrieren.