Einrichtung des Goose API-Schlüssels

Goose API-Schlüssel: Legen Sie Ihren eigenen Schlüssel in config.yaml fest

Fügen Sie den folgenden Block in config.yaml ein, legen Sie Ihren eigenen API-Schlüssel in ~/.bashrc ab, und Goose kann Claude-Modelle verwenden. Zahlen Sie nur, was Sie nutzen.

~/.config/goose/config.yamlyaml
config
GOOSE_PROVIDER: openai
GOOSE_MODEL: claude-haiku-4-5-20251001
OPENAI_HOST: https://api.aicodewith.ai
OPENAI_BASE_PATH: v1/chat/completions

Einrichtungsschritte

Diesen Schlüssel für spätere Terminals speichern

Sobald Sie angemeldet sind, enthält dieser Befehl Ihren eigenen Schlüssel. Kopieren Sie ihn, führen Sie ihn einmal aus, und das Tool behält den Schlüssel an der von uns getesteten Stelle.

bash
for rc in "$HOME/.zshrc" "$HOME/.bashrc"; do
  touch "$rc"
  echo 'export OPENAI_API_KEY=sk-***' >> "$rc"
done

Nicht angemeldete Besucher sehen nur einen Platzhalter. Melden Sie sich an, dann tragen wir Ihren Schlüssel ein. Sign in · Einen Schlüssel in der Konsole abrufen

Durch das Kopieren wird der Befehl nur in die Zwischenablage gelegt. Sie müssen ihn weiterhin in einem Terminal ausführen oder den Schlüssel in die Tool-Einstellungen einfügen. So erhalten Sie einen API-Schlüssel

Diese Schritte wurden unter Linux (bash) getestet. macOS und Windows wurden noch nicht getestet und sind daher nicht aufgeführt.

  1. Noch kein Goose? Installieren Sie es (überspringen, falls installiert)

    Führen Sie curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash aus, dann goose --version. Eine Versionsnummer bedeutet, dass es installiert ist.

    Goose installieren: curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash (CONFIGURE=false überspringt die interaktive Einrichtung). Es wird in ~/.local/bin/goose installiert. goose --version gibt 1.54.0 aus.
  2. Fügen Sie die Konfiguration in config.yaml ein

    Öffnen Sie ~/.config/goose/config.yaml, fügen Sie den Block von oben auf dieser Seite ein und speichern Sie. Sie müssen diese nicht mehr exportieren.

    Der Endpunkt in ~/.config/goose/config.yaml
  3. Fügen Sie Ihren API-Schlüssel in ~/.bashrc ein

    Führen Sie echo 'export OPENAI_API_KEY=sk-***' >> ~/.bashrc aus und ersetzen Sie sk-*** durch Ihren API-Schlüssel (API-Schlüssel erhalten). Die letzte Zeile von ~/.bashrc sollte diese Zeile sein.

    Überprüfen Sie, dass die letzte Zeile von ~/.bashrc export OPENAI_API_KEY=sk-*** ist (hier maskiert)
  4. Öffnen Sie ein neues Terminal und testen Sie Goose

    Öffnen Sie ein neues Terminal und führen Sie goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" aus. OK bedeutet, dass Goose Ihren API-Schlüssel verwendet.

    Überprüfen: Schließen Sie das Terminal, öffnen Sie ein neues, führen Sie goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" aus; eine OK-Antwort bedeutet, dass es eingerichtet ist.
  5. Kein OK? Vergleichen Sie Ihren Fehler

    Vergleichen Sie den Fehler in Ihrem Terminal mit Häufige Fehler unten. Jeder Eintrag listet die Ursache und die Lösung.

  6. Goose-Modelle wechseln: GOOSE_MODEL ändern

    Ersetzen Sie den Modellnamen nach GOOSE_MODEL in config.yaml durch die neue Modell-ID, exakt so geschrieben. Modell-IDs finden Sie unter Modelle und Preise.

Häufige Fehler

Kein Schlüssel gesetzt: Authentifizierung fehlgeschlagen für https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Antwort: {"error":"请在请求中提供有效的 API Key。"}

Was du siehst

error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}.
(English: "Please provide a valid API key in the request.")
Ursache
Das Terminal hat keine OPENAI_API_KEY-Variable: Sie steht nicht in ~/.bashrc, oder Sie haben sie hinzugefügt, aber kein neues Terminal geöffnet.
So behebst du es
Fügen Sie den Schlüssel wie in Schritt 3 in ~/.bashrc ein und öffnen Sie dann ein neues Terminal.

Zurück zu Schritt 3: Fügen Sie Ihren API-Schlüssel in ~/.bashrc ein →

Kein Schlüssel gesetzt: Das neue Terminal hat keine OPENAI_API_KEY. Die Ausführung von goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" gibt zweimal Folgendes aus: error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}. (English: "Please provide a valid API key in the request.") gefolgt von Please retry if you think this is a transient or recoverable error.

Falscher Schlüssel: Authentifizierung fehlgeschlagen für https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Antwort: {"error":"请在请求中提供有效的 API Key。"}

Was du siehst

error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}.
(English: "Please provide a valid API key in the request.")
Ursache
Die OPENAI_API_KEY in ~/.bashrc ist falsch; der Fehler ist derselbe wie ohne Schlüssel.
So behebst du es
Kopieren Sie den Schlüssel erneut aus der Konsole, korrigieren Sie die letzte Zeile in ~/.bashrc und öffnen Sie dann ein neues Terminal.

Zurück zu Schritt 3: Fügen Sie Ihren API-Schlüssel in ~/.bashrc ein →

Falscher Schlüssel: tail -n 1 ~/.bashrc zeigt export OPENAI_API_KEY=sk-wrong. Die Ausführung von goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" gibt zweimal Folgendes aus: error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}. (English: "Please provide a valid API key in the request.") – derselbe Fehler wie ohne Schlüssel.

404 "不支持的请求路径" (nicht unterstützter Anforderungspfad)

Was du siehst

404 "不支持的请求路径" (unsupported request path)
Ursache
Der OPENAI_BASE_PATH ist falsch (zum Beispiel nope/chat/completions), daher geht die Anfrage an https://api.aicodewith.ai/nope/chat/completions.
So behebst du es
Setzen Sie ihn zurück auf v1/chat/completions.

Zurück zu Schritt 2: Fügen Sie die Konfiguration in config.yaml ein →

Häufiger Fehler: Ein falscher OPENAI_BASE_PATH (hier nope/chat/completions) sendet die Anfrage an https://api.aicodewith.ai/nope/chat/completions und gibt 404 (nicht unterstützter Pfad) zurück. Setzen Sie ihn zurück auf v1/chat/completions. Hinweis: Dieses Relay akzeptierte (getestet) weiterhin einen HOST, der bereits /v1 enthält; das ist also keine zuverlässige Methode, um eine falsche Einstellung zu erkennen.

FAQ

Wie verwende ich meinen eigenen API-Schlüssel in Goose?

Setzen Sie in ~/.config/goose/config.yaml GOOSE_PROVIDER: openai, OPENAI_HOST: https://api.aicodewith.ai und OPENAI_BASE_PATH: v1/chat/completions, und fügen Sie dann export OPENAI_API_KEY=your key zu ~/.bashrc hinzu.

Sollte der Goose-OPENAI_HOST /v1 enthalten?

Nein. Setzen Sie OPENAI_HOST auf https://api.aicodewith.ai und fügen Sie /v1 in OPENAI_BASE_PATH ein.

Goose meldet 401. Was nun?

Das Terminal hat keine OPENAI_API_KEY, oder der Schlüssel ist falsch. Siehe die häufigen Fehler oben für die Lösung.

Goose kann das Modell nicht finden. Was nun?

Stellen Sie sicher, dass GOOSE_MODEL exakt mit einer AI Code With Model ID übereinstimmt.

Quellen

Verwandte Links