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.
GOOSE_PROVIDER: openai
GOOSE_MODEL: claude-haiku-4-5-20251001
OPENAI_HOST: https://api.aicodewith.ai
OPENAI_BASE_PATH: v1/chat/completionsEinrichtungsschritte
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.
for rc in "$HOME/.zshrc" "$HOME/.bashrc"; do
touch "$rc"
echo 'export OPENAI_API_KEY=sk-***' >> "$rc"
doneNicht 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.
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 bashaus, danngoose --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. 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 Fügen Sie Ihren API-Schlüssel in ~/.bashrc ein
Führen Sie
echo 'export OPENAI_API_KEY=sk-***' >> ~/.bashrcaus und ersetzen Siesk-***durch Ihren API-Schlüssel (API-Schlüssel erhalten). Die letzte Zeile von~/.bashrcsollte diese Zeile sein.Überprüfen Sie, dass die letzte Zeile von ~/.bashrc export OPENAI_API_KEY=sk-*** ist (hier maskiert) Ö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.OKbedeutet, 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. 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.
Goose-Modelle wechseln: GOOSE_MODEL ändern
Ersetzen Sie den Modellnamen nach
GOOSE_MODELin 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 →
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 →
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 →
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
- Dokumentation zu Goose-Anbietern
- Goose GitHub-Repository (aaif-goose/goose, Installationsskript-Quelle)
- Dokumentation zur Goose-Installation