OpenCode-Anbieter oder -Modell nicht gefunden: Diagnoseleitfaden

Bei OpenCodes Fehler „Anbieter oder Modell nicht gefunden“ gleichen Sie zunächst das ausgewählte Modell mit den Anbieter- und Modell-IDs ab, die OpenCode tatsächlich geladen hat. Die Referenz hat normalerweise die Form providerId/modelId. Ein korrekter API-Schlüssel kann keine falsch geschriebene ID, kein nicht deklariertes benutzerdefiniertes Modell und keine Konfigurationsdatei reparieren, die der laufende Prozess nie einliest.

Folgen Sie dem Fehler, nicht nur der Formulierung „Anbieterproblem“

Der offizielle Fehlerbehebungsleitfaden verweist bei „Modell nicht gefunden“-Fehlern auf Modellreferenzen. In der Anbieterquelle prüft die Suche sowohl den Anbietereintrag als auch dessen Modellzuordnung. Derselbe Fehler kann auch den Fehler eines Adapters wegen eines fehlenden Modells einschließen. Erfassen Sie die genaue Meldung, bevor Sie Anmeldedaten ändern oder weiteres Guthaben kaufen.

1. Version und ausgewähltes Modell identifizieren

Führen Sie diese Prüfungen in dem Projekt aus, in dem der Fehler auftritt. Wenn die Desktop-Anwendung einen anderen Server verwendet, vergleichen Sie dessen Version und Konfiguration mit dieser Terminalinstallation:

opencode --version
opencode models
opencode auth list

Suchen Sie die vollständige Modellreferenz in der Liste und vergleichen Sie sie Zeichen für Zeichen mit Ihrer Auswahl. Das Anbieterpräfix ist Teil der Identität. Ein über ein benutzerdefiniertes Gateway angebotenes Modell wird nicht zum integrierten Anthropic-Anbieter, nur weil sein Name Claude enthält.

Interpretieren Sie eine gespeicherte Anmeldedateninformation nicht als Beweis für eine erfolgreiche Remote-Authentifizierung. Sie bestätigt, dass lokal eine Anmeldedateninformation vorhanden ist; der Endpunkt muss sie bei einer Anfrage dennoch akzeptieren.

2. Anbieter-/Modellpaar korrigieren

Dieses Beispiel verwendet das v1-Anbieterformat und veranschaulicht die drei übereinstimmenden Bezeichner. Setzen Sie die referenzierte Umgebungsvariable in dem Prozess, der OpenCode startet, oder verwenden Sie den dokumentierten Anmeldedatenablauf. Führen Sie die relevanten Felder in Ihre Konfiguration ein, statt nicht zusammengehörige Einstellungen zu überschreiben:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "kunavo/claude-sonnet-5",
  "provider": {
    "kunavo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kunavo",
      "options": {
        "baseURL": "https://api.kunavo.com/v1",
        "apiKey": "{env:KUNAVO_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5"
        }
      }
    }
  }
}

Hier ist kunavo der Anbieterschlüssel und claude-sonnet-5 der Modellschlüssel. Daher lautet die Auswahl kunavo/claude-sonnet-5. Mit anthropic/claude-sonnet-5 wählen Sie einen anderen Anbieter; mit Kunavo/Claude Sonnet 5 ersetzen Sie Suchschlüssel durch Anzeigenamen. Keines von beiden verweist auf den oben gezeigten Eintrag.

Bei der Verwendung von /connect und Other für einen benutzerdefinierten Anbieter geben Sie dieselbe Anbieter-ID ein. Die Anmeldedateninformation definiert den Modellkatalog nicht selbst. Prüfen Sie auch den Adapter: Der hier gezeigte v1-kompatible Adapter verwendet Chat Completions; ein Responses-Endpunkt erfordert den passenden Adapter.

3. v1- und v2-Konfiguration getrennt halten

Die v2-Anbieterdokumentation verwendet providers, package und settings anstelle von provider, npm und options aus v1. Verwenden Sie die versionsspezifische Einrichtung, statt den vorangehenden Block unverändert in eine v2-Konfiguration zu kopieren.

In v2 kann sich der Zuordnungsschlüssel eines Modells auch von modelID des Upstreams unterscheiden. Wenn die Zuordnung coder enthält und das Upstream-Modell upstream/coder-v2 sendet, wählen Sie company/coder für Anbieter company. Wenn Sie die Auswahl auf den Upstream-Namen ändern, umgehen Sie den konfigurierten Alias.

4. Prüfen, welche Konfiguration Vorrang hat

OpenCode führt Konfigurationsquellen zusammen. Eine Projektdatei kann das globale Modell überschreiben; benutzerdefinierte Pfade, Inline-Konfiguration und verwaltete Einstellungen können ebenfalls relevant sein. Prüfen Sie die Datei des fehlschlagenden Projekts, die globale Konfiguration und alle konfigurierten Überschreibungen. Prüfen Sie Anbietereintrags- oder deaktivierte-Anbieter-Listen.

Nehmen Sie eine gezielte Änderung vor, starten Sie den betroffenen Prozess neu und listen Sie die Modelle erneut auf. Wenn das Modell nun verfügbar ist, die erste Anfrage aber einen HTTP-Fehler zurückgibt, folgen Sie diesem neuen Fehler. Bewahren Sie die ursprünglichen Dateien und Sitzungsdaten während der Diagnose auf; das Löschen des gesamten Datenverzeichnisses kann Anmeldedaten und Verlauf entfernen, ohne eine falsche Modellreferenz zu beheben.

Mit einer kleinen Anfrage abschließen

Sobald die Auswahl aufgelöst wird, testen Sie einen kurzen Prompt, bevor Sie eine Repository-Aufgabe ausführen. Bestätigen Sie, dass der vorgesehene Anbieter die Anfrage erhält und das erwartete Modell protokolliert. Wenn der Fehler weiterhin auftritt, sammeln Sie Version, bereinigte Konfiguration, exakte Fehlermeldung und relevanten Logauszug. Prüfen Sie Logs vor dem Teilen auf Schlüssel und Projektinhalte.

Für Kunavo fahren Sie mit dem OpenCode-Integrationsleitfaden fort und prüfen Sie Ihren Nutzungsdatensatz. Der aktuelle Claude Sonnet 5-Satz beträgt $1.40 Eingabe und $7.00 Ausgabe pro Million Tokens. Ein Preisvergleich wird erst sinnvoll, wenn der Client die beabsichtigte Route auswählt.

Häufig gestellte Fragen

Offizielle Dokumentation und Anbieterquelle geprüft am 17. September 2026. Das Beispiel erklärt die Konfigurationsidentität; es ist kein End-to-End-Aufgabenbenchmark.