OpenCode-Konfiguration für Claude: Einrichtung von opencode.json, Modelle und häufige Fehler

OpenCode liest seine Einstellungen aus opencode.json. Um es mit Claude über dieses Gateway zu betreiben, ändern Sie einen einzigen Wert, die folgende Einstellung des Anthropic-Anbieters: baseURL, und hinterlegen einen Schlüssel. Im Folgenden finden Sie zwei funktionierende Konfigurationen, die relevanten Modell- und Kontexteinstellungen sowie Lösungen für Fehler, die OpenCode-Nutzern bei diesem Gateway begegnen – basierend auf unseren eigenen Anfrageprotokollen.

Wo opencode.json liegt

OpenCode führt eine globale Konfiguration mit einer projektspezifischen zusammen: ~/.config/opencode/opencode.json für Einstellungen, die überall gelten sollen, und opencode.json im Stammverzeichnis eines Projekts für das jeweilige Repository. Durch Hinzufügen der $schema -Zeile erhalten Sie in den meisten Editoren Autovervollständigung und Validierung.

Speichern Sie den Schlüssel nicht in der Datei. Hinterlegen Sie ihn in einer Umgebungsvariablen und referenzieren Sie ihn als {env:AIPRIME_API_KEY}. Schlüssel, die Sie mit /connect innerhalb von OpenCode hinzufügen, werden gespeichert in ~/.local/share/opencode/auth.json; opencode auth list zeigt an, was dort gespeichert ist.

export AIPRIME_API_KEY=your_gateway_key   # add to ~/.bashrc or ~/.zshrc
opencode auth list                         # credentials OpenCode already knows about

Option 1: Den integrierten Anthropic-Anbieter auf das Gateway ausrichten

Die kleinste Änderung: Behalten Sie den eigenen Anthropic-Anbieter von OpenCode und dessen Modellliste bei und überschreiben Sie das Ziel seiner Anfragen.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://aiprimetech.io/v1",
        "apiKey": "{env:AIPRIME_API_KEY}"
      }
    }
  },
  "model": "anthropic/claude-sonnet-5",
  "small_model": "anthropic/claude-haiku-4-5"
}

Option 2: ein benutzerdefinierter Anbieter mit Ihrer eigenen Modellliste

Ein separater Anbietereintrag hält das Gateway von jeder Anthropic-Anmeldung getrennt, ermöglicht Ihnen, genau die gewünschten Modelle in der Auswahl aufzulisten, und erlaubt es, Kontextlimits pro Modell festzulegen.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aiprime": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Prime Tech",
      "options": {
        "baseURL": "https://aiprimetech.io/v1",
        "apiKey": "{env:AIPRIME_API_KEY}"
      },
      "models": {
        "claude-sonnet-5":  { "name": "Claude Sonnet 5",  "limit": { "context": 200000, "output": 64000 } },
        "claude-opus-5-5":  { "name": "Claude Opus 5.5",  "limit": { "context": 200000, "output": 64000 } },
        "claude-haiku-4-5": { "name": "Claude Haiku 4.5", "limit": { "context": 200000, "output": 32000 } }
      }
    }
  },
  "model": "aiprime/claude-sonnet-5",
  "small_model": "aiprime/claude-haiku-4-5"
}

Bevorzugen Sie @ai-sdk/anthropic für Claude: Es verwendet die native Messages API, sodass Prompt-Caching und Thinking so funktionieren, wie Anthropic sie vorgesehen hat. Das Gateway unterstützt auch das OpenAI-Format, sodass @ai-sdk/openai-compatible mit derselben https://aiprimetech.io/v1 Basis-URL ebenfalls funktioniert und der Weg ist, den Sie für GPT-Modelle mit demselben Schlüssel verwenden sollten.

Modelle und Kontextlimits

model verwendet der Hauptagent; small_model übernimmt kostengünstige Nebenaufgaben wie Sitzungstitel. Die limit.context Zahl teilt OpenCode mit, wann die Sitzung komprimiert werden soll. Wenn eine lange Sitzung mit prompt is too longfehlschlägt, setzen Sie sie herab (200000 ist ein sicherer Wert), damit OpenCode früher zusammenfasst, statt mehr zu senden, als der Endpunkt akzeptiert.

Modell-IDs sind exakte Zeichenfolgen. Ältere Namen wie claude-3-5-sonnet-20241022 oder datierte Snapshots werden nicht bereitgestellt; verwenden Sie die oben genannten IDs oder die Liste in Ihrem Dashboard.

Prüfen Sie Schlüssel und URL, bevor Sie OpenCode starten

Eine Anfrage aus dem Terminal zeigt Ihnen unabhängig von der OpenCode-Konfiguration, ob Schlüssel und URL korrekt sind:

curl -s https://aiprimetech.io/v1/messages \
  -H "x-api-key: $AIPRIME_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":20,"messages":[{"role":"user","content":"ping"}]}'

Eine JSON-Antwort mit einem content Array bedeutet, dass auf der Gateway-Seite alles in Ordnung ist und jedes verbleibende Problem in opencode.json. Invalid API key bedeutet, dass die Variable leer ist oder den falschen Schlüssel enthält.

Fehlerbehebung: typische Fehler bei OpenCode

Dies sind die Fehler, die bei OpenCode mit diesem Gateway am häufigsten auftreten, jeweils mit der passenden Lösung.

Bei Fehlern, die vom Modell und nicht vom Client ausgehen, siehe Anleitung zu Claude API-Fehlern.

Häufig gestellte Fragen

AI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber.