Source: https://aiprimetech.io/de/learn/use-claude-api-with-opencode/ [Startseite](/de/) / [Lernen](/de/learn/) / OpenCode-Konfiguration für Claude: Einrichtung von opencode.json, Modelle und häufige Fehler # 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. TerminalKopieren ``` 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. opencode.jsonKopieren ``` { "$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" } ``` Das baseURL muss enden auf /v1. Der Anthropic-Anbieter von OpenCode ist die folgende Komponente des AI SDK: @ai-sdk/anthropic, deren Standardwert https://api.anthropic.com/v1ist; sie hängt Folgendes an: /messages an alles an, was Sie angeben. Ohne /v1 landet die Anfrage auf der Website und liefert HTML zurück, was OpenCode als Parsing-Fehler meldet. ## 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. opencode.jsonKopieren ``` { "$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 | Modell-ID | Einsatzbereich | claude-sonnet-5 | Standard für Programmier- und Agentenaufgaben: schnell, leistungsstark, mittleres Preisniveau. | claude-opus-5-5 | Anspruchsvollere Denkaufgaben, umfangreiche Refactorings, lange Agentenläufe. | claude-fable-5-1 | Am leistungsfähigsten und am teuersten; für die schwierigsten Aufgaben reservieren. | claude-haiku-4-5 | Günstig und schnell: Titel, Zusammenfassungen, Klassifizierung, kleine Schritte. 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: TerminalKopieren ``` 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. | Was Sie sehen | Ursache | Lösung | Ein JSON-Parsing-Fehler, die Antwort beginnt mit < | baseURL ohne /v1: Die Anfrage hat die Website erreicht, nicht die API | Beenden Sie baseURL durch /v1 | 404 page not found | /v1 zweimal, sodass der Pfad zu /v1/v1/messages | Verwenden Sie genau https://aiprimetech.io/v1 | Invalid API key | Die Variable ist in der Shell, aus der OpenCode gestartet wurde, nicht exportiert, oder es wird ein anderer Schlüssel verwendet | echo $AIPRIME_API_KEY, opencode auth list, starten Sie OpenCode neu | Modell nicht unterstützt / Modell nicht gefunden | Eine ID, die der Endpunkt nicht bereitstellt, häufig ein alter datierter Name | Verwenden Sie eine ID aus der obigen Tabelle | prompt is too long: N tokens > N tokens | Die Sitzung hat das vom Modell akzeptierte Limit überschritten | /compact, und senken Sie limit.context | Concurrency limit exceeded for user | Parallele Unteragenten überschreiten das Parallelitätslimit Ihres Schlüssels | Führen Sie weniger Unteragenten gleichzeitig aus oder bitten Sie den Support um ein höheres Parallelitätslimit | Insufficient account balance | Das Guthaben ist aufgebraucht | [Guthaben aufladen](/de/topup/) und versuchen Sie es erneut | No available accounts oder This request could not be completed | Vorübergehendes Kapazitätsproblem beim vorgelagerten Anbieter | Senden Sie die Nachricht erneut; wechseln Sie das Modell, wenn das Problem bestehen bleibt Bei Fehlern, die vom Modell und nicht vom Client ausgehen, siehe [Anleitung zu Claude API-Fehlern](/de/learn/claude-api-errors-troubleshooting/). ## Häufig gestellte Fragen Wo befindet sich die OpenCode-Konfigurationsdatei? Global unter ~/.config/opencode/opencode.json und pro Projekt als opencode.json im Stammverzeichnis des Repositorys. OpenCode führt beide zusammen. Wie verwende ich Claude in OpenCode mit einem API-Schlüssel? Setzen Sie provider.anthropic.options.baseURL auf die Gateway-URL mit der Endung /v1 und apiKey auf {env:YOUR_VAR}, oder fügen Sie einen benutzerdefinierten Anbieter mit npm @ai-sdk/anthropic hinzu und wählen Sie dann das Modell mit model: provider/model-id. Warum schlägt OpenCode mit einem Parsing-Fehler oder einer Antwort fehl, die mit '<' beginnt? In der baseURL fehlt /v1, sodass Anfragen die Website statt der API erreichen. @ai-sdk/anthropic erwartet das vollständige Präfix, z. B. https://aiprimetech.io/v1. Kann OpenCode eine Claude Pro- oder Max-Anmeldung verwenden? Die OpenCode-Dokumentation weist darauf hin, dass Anthropic Pro-/Max-Plugins von Drittanbietern untersagt und OpenCode seit 1.3.0 keine solchen Plugins mehr mitliefert. Ein API-Schlüssel ist der unterstützte Weg. Claude in wenigen Minuten nutzen Holen Sie sich einen API-Schlüssel – ohne Anthropic-Konto oder Warteliste.[API-Schlüssel erhalten](/register) 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. ## Weitere Anleitungen zur Claude API [So erhalten Sie einen Claude API-Schlüssel](/de/learn/how-to-get-a-claude-api-key/)[Claude-API-Preise erklärt](/de/learn/claude-api-pricing-explained/)[Die günstigste Möglichkeit, die Claude API zu nutzen](/de/learn/cheapest-way-to-use-claude-api/)[Cursor unbegrenzt mit der Claude API nutzen](/learn/use-claude-api-with-cursor/)[Unbegrenzter Zugang zu Claude Code](/de/learn/use-claude-api-with-claude-code/)[Claude API-Gateway vs. direkter Zugang zu Anthropic](/de/learn/claude-api-vs-anthropic-direct/)[Claude über eine OpenAI-kompatible API nutzen](/de/learn/openai-compatible-claude-api/)[Claude-Modelle erklärt: ein Vergleich von Claude Opus, Sonnet, Haiku und Fable — alle Claude-API-Modelle, Anthropic-Modellnamen und Preise (2026)](/de/learn/claude-api-models-compared/)[Die Claude API mit Kryptowährungen bezahlen](/de/learn/claude-api-with-crypto-payment/)[Zugang zur Claude API ohne Warteliste](/de/learn/claude-api-without-waitlist/)[So reduzieren Sie den Token-Verbrauch von Claude](/de/learn/how-to-reduce-claude-token-usage/)[Cline unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-cline/)[Roo Code unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-roo-code/)[Claude unbegrenzt in JetBrains-IDEs nutzen](/de/learn/use-claude-api-with-jetbrains/)[Aider unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-aider/)[Claude unbegrenzt in VS Code nutzen](/de/learn/use-claude-api-with-vscode/)[Einen unbegrenzten Hermes-Agenten mit Claude betreiben](/de/learn/run-hermes-agent-with-claude-api/)[OpenClaw unbegrenzt mit Claude betreiben](/de/learn/run-openclaw-with-claude-api/)[Was eine Anthropic-kompatible API bedeutet](/de/learn/anthropic-compatible-api/)[Claude Code-API-Schlüssel — ANTHROPIC_API_KEY: So erhalten und konfigurieren Sie ihn, und wann Sie stattdessen claude setup-token verwenden sollten](/de/learn/claude-code-api-key-setup/)[Claude Code-API-Kosten — Preise und Möglichkeiten zur Kostensenkung](/de/learn/claude-code-api-costs/)[Claude API-Fehler erklärt: Serverfehler 500, Überlastung 529, Ratenlimit 429, fehlerhafte Anfrage 400 — und die jeweilige Lösung](/de/learn/claude-api-errors-troubleshooting/)[So kaufen Sie Claude API-Guthaben – und warum Claude-Guthaben besser ist als jedes Angebot zum „Kauf eines Claude-Kontos“](/de/learn/buy-claude-api-credits/)[Kostenlose Claude API: Gibt es einen kostenlosen Claude API-Schlüssel, und was ist in 2026 tatsächlich kostenlos?](/de/learn/claude-api-free-trial/)[Claude API vs. Claude Pro/Max-Abonnement — welche Option wählen?](/de/learn/claude-api-vs-subscription/)[Die Codex CLI mit Claude ausführen](/de/learn/use-claude-api-with-codex/)[Claude mit n8n verbinden](/de/learn/use-claude-api-with-n8n/)[LiteLLM-Anfragen an Claude weiterleiten](/de/learn/use-claude-api-with-litellm/)[Claude in Kilo Code verwenden](/de/learn/use-claude-api-with-kilo-code/)[Claude in GitHub Copilot integrieren](/de/learn/use-claude-api-with-github-copilot/)[Zed über das Gateway mit Claude verbinden](/de/learn/use-claude-api-with-zed/)[Cherry Studio mit Claude verbinden](/de/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic in LangChain: Import, base_url, Streaming, Tools und Fehler](/de/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: installieren, base_url setzen, streamen und Fehler behandeln](/de/learn/anthropic-python-sdk/)[Claude mit dem Vercel AI SDK: createAnthropic baseURL, Streaming und Fehlerbehebung](/de/learn/use-claude-api-with-vercel-ai-sdk/)[Factory Droid mit Claude betreiben](/de/learn/use-claude-api-with-factory-droid/)[Die Claude Code API erklärt](/de/learn/claude-code-api/)[Die Claude API in Ihre Anwendung integrieren](/de/learn/claude-api-integration/)[So nutzen Sie Claude unbegrenzt – und warum es kein „gecracktes Claude Code“ gibt](/de/learn/get-unlimited-claude-usage/)