OpenCode-Anbindung an die Claude-API

Anleitung zur Konfiguration der 1折AI Claude-API-Weiterleitung in OpenCode mit Adresse, Schlüssel und Modellen, einschließlich Protokollauswahl, Konfigurationsbeispielen, Verifikationsschritten und häufigen Fehlern.

Nutze die Funktion für benutzerdefinierte Anbieter in OpenCode, um dich mit 1折AI zu verbinden. Erstelle zuerst einen API-Schlüssel und prüfe die aktuell verfügbaren Modelle; die nachfolgenden Modell-IDs sind Beispiele und müssen entsprechend den Berechtigungen deines Schlüssels angepasst werden.

Datum der Überprüfung der offiziellen Konfiguration: 2026-10-15. Die folgende Konfiguration basiert auf der offiziellen Dokumentation; die End-to-End-Verifizierung auf dieser Seite ist noch nicht abgeschlossen. Führe zuerst eine kurze Frage-Antwort- und Tool-Call-Verifizierung durch, bevor du sie für lange Aufgaben verwendest. OpenAI-/GPT-Modelle sind live; Modellliste und Preise findest du in der Modellbeschreibung.

OpenCode-v1-Konfiguration

Gemäß offiziellen v1-Providern: Führe /connect aus, wähle Other, gib als Provider-ID onezhe ein und trage den API-Schlüssel dieser Seite ein. Im Projekt opencode.json zusammenführen:

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "provider": {
4
    "onezhe": {
5
      "npm": "@ai-sdk/openai-compatible",
6
      "name": "1折AI",
7
      "options": { "baseURL": "https://1zheai.com/v1" },
8
      "models": {
9
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
10
      }
11
    }
12
  }
13
}

Anschließend /models das Modell dieses Providers auswählen. /connect speichert nur Zugangsdaten und ersetzt nicht die Provider-Konfiguration. Hier wird explizit das SDK für Chat Completions gewählt; es darf nicht versehentlich auf @ai-sdk/openai für Responses umgestellt werden. Die offizielle Seite erlaubt auch die Referenzierung von Umgebungsvariablen über options.apiKey: "{env:ONEZHE_API_KEY}".

OpenCode-v2-Konfiguration

Gemäß offiziellen v2-Providern die nativen v2-Felder verwenden; sie dürfen nicht mit dem v1 von oben vermischt werden. Im Projekt opencode.jsonc zusammenführen:

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "providers": {
4
    "onezhe": {
5
      "name": "1折AI",
6
      "env": ["ONEZHE_API_KEY"],
7
      "package": "@opencode/ai/providers/openai-compatible",
8
      "settings": { "baseURL": "https://1zheai.com/v1" },
9
      "models": {
10
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
11
      }
12
    }
13
  }
14
}

Im Prozessumfeld, das OpenCode startet, ONEZHE_API_KEY bereitstellen und dann /models onezhe/claude-sonnet-4-6 auswählen. Der Hauptunterschied bei v2 sind providers, package, settings statt provider, npm, options bei v1. Prüfe zuerst mit opencode --version die verwendete Hauptversion.

Wenn natives Anthropic verwendet werden soll, erlaubt v1 offiziell das Überschreiben von provider.anthropic.options.baseURL; das Beispiel enthält /v1; v2 listet @opencode/ai/providers/anthropic-compatible. Dieses Tutorial folgt einer expliziten OpenAI-kompatiblen Konfiguration; das Protokoll darf nicht basierend auf dem Modellnamen eigenmächtig gewechselt werden, und es wird nicht versprochen, dass Caching und Tool-Calls bereits verifiziert sind.

Anbindung verifizieren und Fehler beheben

Konfiguration speichern und neu laden, prüfen, dass der aktuell ausgewählte Anbieter onezhe oder das hinzugefügte benutzerdefinierte Modell ist.
Eine kurze Frage senden und prüfen, ob eine Antwort zurückkommt; anschließend einen kleinen, rückgängig zu machenden Auftrag versuchen und Tool-Calls sowie Mehr-Runden-Dialoge separat bestätigen.
Die Aufrufprotokolle öffnen und Anfragezeit, Modell, Status und Verbrauch abgleichen. Eine erfolgreiche Textantwort bedeutet nicht, dass alle Agent-Fähigkeiten kompatibel sind.
Bei 404 Adresse und Protokoll dieser Seite auf Passung prüfen; bei 401 Herkunft des Schlüssels und ob der Prozess die Umgebungsvariable gelesen hat, prüfen; bei 429 Rate-Limit-Informationen ansehen und dann erneut versuchen. Weitere Fälle siehe Fehlercodes und Fehlerbehebung.

Schlüssel werden nur in der lokalen Umgebung oder im Zugangsdatenspeicher des Tools gespeichert und dürfen nicht in Code-Repositorys, Screenshots oder öffentliche Protokolle eingecheckt werden. Hintergrunddienste erben möglicherweise nicht die Terminal-Umgebungsvariablen; Hilfsmodelle, Suche und andere Tools haben möglicherweise eigene Anbieter-Einstellungen und müssen separat geprüft werden.

Kosten und andere Anbindungsmethoden

Siehe Claude-API-Echtzeitpreise und Abrechnungsregeln. Für andere Clients zum Tool-Anbindungsverzeichnis zurückkehren; für eigene Programme die SDK- und Entwicklungsleitfäden nutzen.