Goose-Provider einrichten

goose' Anthropic- und OpenAI-kompatible Provider auf QCode richten: was ins HOST-Feld gehört, was goose configure nicht kann

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Zuletzt geprüft: 2026-10-13 · 📄 Laut offizieller Dokumentation (goose v1.54.0)

Auf einen Blick¶

goose beschreibt sich selbst als "your native open source AI agent — desktop app, CLI, and API". Das Projekt gehört inzwischen zur Agentic AI Foundation: die Doku liegt auf goose-docs.ai (die frühere Adresse block.github.io/goose leitet nur noch weiter), das Repository ist aaif-goose/goose, die Homebrew-Formel heißt dagegen weiterhin block-goose-cli. Diese Seite steht im Einklang mit der stabilen Version v1.54.0, veröffentlicht am 2026-10-08.

Welches Protokoll¶

Rufen Sie Claude niemals über die OpenAI-kompatible Seite auf. QCode liefert claude-* ausschließlich auf der Anthropic-Messages-Seite; die OpenAI-Seite lehnt diese IDs ab (model_not_available_on_endpoint). Legen Sie besser zwei Provider an und wählen Sie pro Sitzung mit goose run --provider … --model …. Details: Endpunkte & API-Formate.

Das Feld heißt HOST, nicht base_url. goose fragt ANTHROPIC_HOST, OPENAI_HOST und GOOSE_PROVIDER__HOST. Tragen Sie nur Host plus Pfad-Präfix ein — schreiben Sie kein /v1/messages in das Feld. Auf der OpenAI-Seite ist der Anfragepfad ein eigenes dokumentiertes Feld: Die Tabelle der Doku beschreibt OPENAI_BASE_PATH als "Request path appended to the host (defaults to v1/chat/completions)". Wie ANTHROPIC_HOST mit dem Nachrichtenpfad verbunden wird, sagt die offizielle Dokumentation nicht; diese Seite nennt deshalb nur den QCode-Wert und behauptet nichts als gemessen.

Installation¶

CLI per Homebrew oder über das offizielle Skript:

brew install block-goose-cli

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

goose update
goose --version

Desktop: für macOS per Homebrew oder die Download-Buttons; für Linux bietet die offizielle Seite .deb-, .rpm- und Flatpak-Pakete:

brew install --cask block-goose

Claude einrichten (Anthropic-Provider)¶

Der interaktive Weg folgt den offiziellen Abfragen:

goose configure
# Configure Providers (Change provider or update credentials)  -> Anthropic wählen
# Provider Anthropic requires ANTHROPIC_API_KEY, please enter a value  -> Ihr QCode-Schlüssel
# Enter your desired ANTHROPIC_HOST or press Enter to use the default.  -> https://api.qcode.cc/api

Ohne Assistenten gehen die Variablen, die die offizielle Umgebungsvariablen-Seite unter custom endpoints sammelt:

export GOOSE_PROVIDER="anthropic"
export GOOSE_MODEL="claude-sonnet-5"
export GOOSE_PROVIDER__TYPE="anthropic"
export GOOSE_PROVIDER__HOST="https://api.qcode.cc/api"
export GOOSE_PROVIDER__API_KEY="cr_your_qcode_key"

In der config.yaml (macOS/Linux: ~/.config/goose/config.yaml) stehen Provider-Einstellungen unter active_provider und providers:

active_provider: anthropic
providers:
  anthropic:
    enabled: true
    model: claude-sonnet-5
    configured: true

• Der Schlüssel gehört nicht in diese Datei — offiziell: "Provider API keys do not go in config.yaml". Speichern Sie ihn im Keyring (über goose configure), in secrets.yaml oder in der Provider-Umgebungsvariablen.
• Regionale Knoten: tauschen Sie den Host gegen https://asia.qcode.cc/api oder https://us.qcode.cc/api. Der gleiche Schlüssel bleibt gültig.
• Bei QCode verfügbare Claude-Modelle: claude-sonnet-5, claude-sonnet-5-5, claude-opus-5, claude-opus-5-5, claude-haiku-5-5, claude-haiku-4-5-20251001, claude-sonnet-4-6, claude-fable-5, claude-fable-5-1. Abgerechnet wird pro Token; die Preise je Modell stehen unter https://qcode.cc/models

GPT und chinesische Modelle einrichten (OpenAI-kompatibel)¶

Die Doku sagt, der eingebaute OpenAI-Provider "can connect to OpenAI's official API (api.openai.com) or any OpenAI-compatible endpoint", und für ein solches Gateway gilt die offizielle Anweisung: "set OPENAI_HOST to your proxy's root (no trailing path) and OPENAI_BASE_PATH to the path it serves (usually v1/chat/completions)".

export OPENAI_API_KEY="cr_your_qcode_key"
export OPENAI_HOST="https://api.qcode.cc"
export OPENAI_BASE_PATH="openai/v1/chat/completions"
export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="gpt-6.1-sol"

Die Alternative: den dokumentierten Standardpfad lassen und das Präfix in den Host schieben — export OPENAI_HOST="https://api.qcode.cc/openai", während OPENAI_BASE_PATH auf v1/chat/completions bleibt. Beide Formen zielen auf den dokumentierten Endpunkt /openai/v1/chat/completions.

Als benannter Custom Provider¶

goose configure ausführen, Custom Providers wählen, dann Add A Custom Provider (im Menü steht "Add a new OpenAI/Anthropic/Ollama compatible Provider"):

Den Schlüssel liest der Provider aus der Umgebungsvariablen, die Sie ihm zugewiesen haben. Offiziell heißt es "Then use the api_key_env to set the key for your session", das Beispiel lautet:

export CUSTOM_CORP_API_API_KEY="your-api-key"
goose session start --provider custom_corp_api

Ersetzen Sie custom_corp_api und CUSTOM_CORP_API_API_KEY durch Ihre eigenen Namen. Wer die JSON-Datei selbst schreibt, legt sie in macOS/Linux: ~/.config/goose/custom_providers/ ab. Zwei Hinweise: Offiziell gilt "Custom providers must use OpenAI, Anthropic, or Ollama compatible API formats." — und in den offiziellen Beispielen taucht engine nur als "engine": "openai" auf. Für die Anthropic-Seite nennt die Doku keinen Wert; legen Sie Anthropic-kompatible Custom Provider daher über goose configure an und überlassen Sie goose diese Zeile.

Chinesische Modell-IDs bei QCode: deepseek-v4.1-flash, deepseek-v4-flash, deepseek-v4-pro, glm-5.3, glm-5.2, qwen3.8-max, qwen3.8-flash, qwen3.7-plus, kimi-k3 — siehe Chinesische Modelle.

Prüfen¶

goose info
goose run --provider anthropic --model claude-sonnet-5 -t "ping"

Zu goose info sagt die Doku: "Shows goose information, including the version, configuration file location, session storage, and logs." Die Flags von goose run sind als "Specify the provider to use for this session (overrides environment variable)" und "Specify the model to use for this session (overrides environment variable)" beschrieben.

Prüfen Sie erst den Endpunkt, bevor Sie goose selbst untersuchen:

KEY="cr_your_qcode_key"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

Steht in der Antwort ein JSON mit content, hat der Endpunkt geantwortet und die Ursache liegt in den Einstellungen von goose. Diese Seite entsteht ausschließlich aus der offiziellen Dokumentation; ohne Test-Key wurde hier keine Anfrage gegen QCode gemessen.

Bekannte Grenzen¶

Preise in einem Satz: Abgerechnet wird pro Token, die Preise je Modell stehen unter https://qcode.cc/models

Verwandte Seiten¶

• Endpunkte & API-Formate — Protokoll × Modellfamilie
• Kompatibilität der Werkzeuge — welches Werkzeug über welches Protokoll läuft
• OpenCode einrichten — das gleiche Protokollpaar bei einem anderen Terminal-Agenten
• Crush einrichten — gleiche Provider, aber eine JSON-Datei statt Assistent
• Aider einrichten — beide Seiten, nach Modellname gewählt
• Modellauswahl
• Chinesische Modelle

Enterprise →