OpenCode

OpenCode leitet Anthropic- und OpenAI-Modelle über austauschbare Provider. Richten Sie den Block anthropic auf OneProvider aus, und Sie sind fertig.

Konfigurieren

Konfigurationspfad: ~/.config/opencode/opencode.json (oder opencode.jsonc). Legen Sie die Datei an, falls sie nicht existiert.

{
"provider": {
"anthropic": {
"options": {
"baseURL": "https://api.oneprovider.dev/v1",
"apiKey": "sk-your-key-here"
},
"npm": "@ai-sdk/anthropic"
}
},
"$schema": "https://opencode.ai/config.json"
}

Den API-Schlüssel können Sie direkt eintragen (wie oben) oder aus der Datei heraushalten: Der Befehl /connect in OpenCode (oder opencode auth login im Terminal) speichert ihn separat (in 1.x unter ~/.local/share/opencode/auth.json), und die Konfiguration behält nur baseURL.

Einfachere Wege

• Pro Projekt. Legen Sie dasselbe JSON als opencode.json im Projektstamm ab: Es gilt nur dort und wird über die globale Datei gelegt.
• Schlüssel aus einer Umgebungsvariable. Schreiben Sie "apiKey": "{env:ONEPROVIDER_KEY}" und führen Sie export ONEPROVIDER_KEY=sk-your-key-here aus. Die Datei enthält dann kein Geheimnis und darf committet werden. Ist die Variable nicht gesetzt, wird ein leerer String eingesetzt.

Entfernter Rechner, CI, Container

Sie müssen ~/.config nicht per SSH kopieren. Halten Sie opencode.json mit {env:ONEPROVIDER_KEY} im Repository und setzen Sie ONEPROVIDER_KEY auf dem Rechner (CI-Secret, docker run -e, export). In OpenCode 1.x können Sie die ganze Konfiguration auch als eine Variable übergeben, OPENCODE_CONFIG_CONTENT: Inline-JSON, das nach allen Konfigurationsdateien angewendet wird; auf die Festplatte wird nichts geschrieben. OPENCODE_CONFIG=/path/to/config.json verweist auf eine Konfigurationsdatei an anderer Stelle.

export OPENCODE_CONFIG_CONTENT='{"provider":{"anthropic":{"npm":"@ai-sdk/anthropic","options":{"baseURL":"https://api.oneprovider.dev/v1","apiKey":"sk-your-key-here"}}}}'
opencode

OpenCode 1.x und OpenCode 2

Prüfen Sie Ihre Version mit opencode --version: Die Nummer beginnt mit 1 ( OpenCode 1.x , das liefert der Installer standardmäßig) oder mit 2 ( OpenCode 2 ). Die Konfiguration auf dieser Seite hat das 1.x-Format (provider, npm, options), und OpenCode 2 liest sie unverändert von denselben Speicherorten. Das native 2-Format ist optional; es schreibt dieselben Einstellungen mit providers, package, settings:

{
"providers": {
"anthropic": {
"package": "aisdk:@ai-sdk/anthropic",
"settings": { "baseURL": "https://api.oneprovider.dev/v1", "apiKey": "sk-your-key-here" }
},
"openai": {
"package": "aisdk:@ai-sdk/openai",
"settings": { "baseURL": "https://api.oneprovider.dev/v1", "apiKey": "sk-your-key-here" }
}
}
}

Richten Sie OpenCode 1.x nicht auf eine Datei im 2-Format: Beide Versionen lesen dieselben Dateien. OPENCODE_CONFIG und OPENCODE_CONFIG_CONTENT sind für 1.x dokumentiert; in OpenCode 2 nutzen Sie die opencode.json im Projekt und für einen entfernten Rechner die Variable ONEPROVIDER_KEY.

Auch gpt-*-Modelle routen

Derselbe Schlüssel funktioniert auch für GPT-Modelle – fügen Sie einen zweiten Provider-Block hinzu. Beide stehen in derselben Datei; ein Modell wählen Sie als provider/model-id.

{
"provider": {
"anthropic": { "options": { "baseURL": "https://api.oneprovider.dev/v1", "apiKey": "sk-your-key-here" }, "npm": "@ai-sdk/anthropic" },
"openai": { "options": { "baseURL": "https://api.oneprovider.dev/v1", "apiKey": "sk-your-key-here" }, "npm": "@ai-sdk/openai" }
}
}

Welches Modell wählen

Nutzen Sie anthropic/claude-sonnet-5-5 als Alltagsmodell: ausgewogenes Verhältnis von Preis und Qualität. Wechseln Sie zu anthropic/claude-opus-5-5 für Architekturarbeit und große Refactorings und nutzen Sie anthropic/claude-haiku-5-5, wenn Tempo wichtiger ist als Tiefe. Für GPT-Modelle dient der Block openai: openai/gpt-6.1-terra ist der ausgewogene Standard, openai/gpt-6.1-sol die Frontier-Stufe. Öffnen Sie /models, um eines zu wählen; ein günstiges Modell passt auch zur OpenCode-Einstellung small_model für Titel und kurze Aufgaben. IDs stehen auf der Modellseite , die Preise auf der Preisseite .

Häufige Fehler und Lösungen

404 „The requested API endpoint does not exist“

In OpenCode erwartet der Provider @ai-sdk/anthropic eine baseURL mit /v1: https://api.oneprovider.dev/v1. Hängen Sie nicht selbst /messages an und verwenden Sie hier nicht den reinen Host.

401 Invalid API key

Der Schlüssel in der Konfiguration ist abgeschnitten oder von Anführungszeichen umgeben. Sie können auch /connect ausführen und ihn dort einfügen (OpenCode 1.x legt ihn in ~/.local/share/opencode/auth.json ab); entfernen Sie dann apiKey aus der Konfiguration.

Die Konfiguration wird nicht geladen

Intelligente Anführungszeichen aus einem Messenger oder Notion zerstören das JSON. Prüfen Sie die Datei mit jq . ~/.config/opencode/opencode.json oder nutzen Sie opencode.jsonc, wenn Sie Kommentare möchten.

Das Modell steht nicht in der Liste

Wählen Sie es genau als provider/model-id, zum Beispiel anthropic/claude-sonnet-5-5, und stellen Sie sicher, dass der passende Provider-Block in der Datei steht.

429 „Insufficient balance“

Das Guthaben oder das Ausgabenlimit des Schlüssels ist aufgebraucht. Laden Sie das Konto auf; ein erneuter Versuch hilft nicht.

Streams brechen ab

Schalten Sie VPN oder VLESS-Proxys aus: Diese puffern SSE und stören HTTP/2.

FAQ

Wo liegt die Konfigurationsdatei?

~/.config/opencode/opencode.json (oder opencode.jsonc). Ein Projekt kann auch eine eigene opencode.json haben.

Wie halte ich den Schlüssel aus der Datei heraus?

OpenCode setzt Umgebungsvariablen ein: Schreiben Sie "apiKey": "{env:ONEPROVIDER_KEY}" und exportieren Sie die Variable in Ihrer Shell.

Wie nutze ich es auf einem entfernten Rechner oder in CI?

Ohne Dateien per SSH zu kopieren: Halten Sie opencode.json mit {env:ONEPROVIDER_KEY} im Repository und setzen Sie ONEPROVIDER_KEY auf dem Rechner, oder (OpenCode 1.x) übergeben Sie die ganze Konfiguration in der Variable OPENCODE_CONFIG_CONTENT. Siehe „Entfernter Rechner, CI, Container“ oben.

Kann ich Claude und GPT gemeinsam nutzen?

Ja. Fügen Sie den Block openai von dieser Seite neben dem Block anthropic hinzu; ein Schlüssel funktioniert für beide.

Brauche ich ein Claude- oder OpenAI-Konto?

Nein, der OneProvider-Schlüssel ist die einzige Zugangsberechtigung.

Kurze Antworten

Welche base URL verwende ich?

Claude Code und die Anthropic-SDKs verwenden https://api.oneprovider.dev. OpenAI-SDKs und OpenAI-kompatible Clients verwenden https://api.oneprovider.dev/v1. Ein Schlüssel funktioniert an beiden Adressen; die Modellliste finden Sie auf der Modellseite , die Preise auf der Preisseite .

Wie authentifiziere ich mich?

Senden Sie den unveränderten sk-…-Schlüssel in x-api-key oder Authorization: Bearer: nur eines von beiden, nie beide. Bewahren Sie den Schlüssel in einer Umgebungsvariable auf, nicht in einer Datei, die ins Repository committet wird. Mehr zur Authentifizierung .

Wo bekomme ich einen Schlüssel?

Öffnen Sie Ihr Konto im Telegram-Bot @oneprovider_robot oder auf app.oneprovider.dev, laden Sie das Guthaben auf und tippen Sie auf „Schlüssel ausstellen“. Jeder Schlüssel kann ein eigenes Ausgabenlimit haben. Konto & API-Schlüssel .

Was bedeuten 401, 404 und 429?

401: Der Schlüssel fehlt, ist falsch geschrieben oder steht im falschen Header; fügen Sie den ganzen Schlüssel ohne Anführungszeichen und Leerzeichen ein. 404: meist eine falsche base URL, zum Beispiel ein fehlendes oder doppeltes /v1. 429 mit „Insufficient balance“: Das Guthaben des Kontos oder das Ausgabenlimit des Schlüssels ist aufgebraucht – laden Sie auf, statt es erneut zu versuchen; jedes andere 429 ist ein Rate-Limit, warten Sie dann die Zeit aus Retry-After ab. Details: Fehlercodes und Fehlerbehebung .

Warum brechen Streams ab oder werden zurückgesetzt?

VPN- und VLESS-Proxys puffern SSE oft oder stören die HTTP/2-Aushandlung. OneProvider hat keine regionalen Beschränkungen und puffert keine Streams – schalten Sie den Proxy aus und versuchen Sie es erneut.

Wohin wende ich mich, wenn das nicht reicht?

Schreiben Sie @Oneproviderhelpbot auf Telegram oder öffnen Sie „Support“ im Web-Konto – mit HTTP-Statuscode und genauer Fehlermeldung. So arbeitet der Support .