---
title: "OpenCode-Anbindung an die Claude-API"
description: "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."
headingIds: {"OpenCode-v1-Konfiguration":"section-1","OpenCode-v2-Konfiguration":"section-2","Anbindung verifizieren und Fehler beheben":"section-3","Kosten und andere Anbindungsmethoden":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

Dokumentation gepflegt von [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Quellen und Korrekturen](https://1zheai.com/en/editorial/).

Fehler gefunden? [Support kontaktieren](mailto:support@1zheai.com) mit Seitenadresse und Beschreibung. Senden Sie keine API-Schlüssel oder Kontodaten.

</aside>
Nutze die Funktion für benutzerdefinierte Anbieter in OpenCode, um dich mit 1折AI zu verbinden. Erstelle zuerst einen [API-Schlüssel](/de/docs/api-keys/) und prüfe die [aktuell verfügbaren Modelle](/de/docs/models/); die nachfolgenden Modell-IDs sind Beispiele und müssen entsprechend den Berechtigungen deines Schlüssels angepasst werden.

<Note>
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](/de/docs/models/).
</Note>

## OpenCode-v1-Konfiguration

Gemäß [offiziellen v1-Providern](https://opencode.ai/docs/providers/): 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:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "onezhe": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "1折AI",
      "options": { "baseURL": "https://1zheai.com/v1" },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}
```

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](https://opencode.ai/v2/docs/providers) die nativen v2-Felder verwenden; sie dürfen nicht mit dem v1 von oben vermischt werden. Im Projekt `opencode.jsonc` zusammenführen:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "onezhe": {
      "name": "1折AI",
      "env": ["ONEZHE_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": { "baseURL": "https://1zheai.com/v1" },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}
```

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

1. Konfiguration speichern und neu laden, prüfen, dass der aktuell ausgewählte Anbieter `onezhe` oder das hinzugefügte benutzerdefinierte Modell ist.
2. 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.
3. Die [Aufrufprotokolle](/de/docs/usage-logs/) öffnen und Anfragezeit, Modell, Status und Verbrauch abgleichen. Eine erfolgreiche Textantwort bedeutet nicht, dass alle Agent-Fähigkeiten kompatibel sind.
4. 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](/de/docs/troubleshooting/).

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](https://1zheai.com/en/pricing/) und [Abrechnungsregeln](/de/docs/pricing-explained/). Für andere Clients zum [Tool-Anbindungsverzeichnis](/de/docs/integrations/) zurückkehren; für eigene Programme die [SDK- und Entwicklungsleitfäden](/de/docs/guides/) nutzen.