Claude Code ruft standardmäßig die Anthropic API auf. Entwickler in China stoßen dabei häufig auf instabile Verbindungen, eingeschränkte Zahlungswege und Team-Kontingente, die sich schwer verwalten lassen. Deshalb suchen viele nach einem „Claude Code Relay“.

Dieser Artikel erklärt, was ein Relay ist, welche Probleme es löst und welche nicht, wie Sie einen Anbieter auswählen, wie die Konfiguration aussieht und welche Risiken bestehen.

Hinweis: Claude Code und Anthropic sind Marken ihrer jeweiligen Inhaber. Dieser Artikel dient ausschließlich der technischen Diskussion; maßgeblich sind die offiziellen Dokumente und die Anbieterdokumentation.

1. Was ist ein Claude Code Relay?

Es ist kein zweites Claude Code, sondern eine API-Gateway-Schicht:

Claude Code → Relay-Gateway (Authentifizierung/Abrechnung/Routing) → Anthropic oder andere kompatible Modelle

Sie verwenden weiterhin den Claude-Code-Client und tauschen lediglich ANTHROPIC_BASE_URL und den Key gegen die Werte des Gateways. Aus Sicht des Clients bleibt es ein Aufruf der Anthropic Messages API.

2. Was es löst

  • Instabiler Zugang aus dem Inland.
  • Unbequeme Zahlungsmethoden und Aufladewege.
  • Teams benötigen eine einheitliche Abrechnung und Kontingente.
  • Ein Key für den Wechsel zwischen mehreren Modellanbietern.
  • Nutzungsprotokolle und Unterstützung bei der Fehlersuche.
  • Limits pro Mitglied oder Projekt.

3. Was es nicht löst

  • Es verwandelt weder die Weboberfläche noch ein Abonnement in eine API.
  • Es kann keine vollständige Verfügbarkeit zusichern; Störungen beim Upstream wirken sich weiterhin aus.
  • Es ersetzt keine Compliance- oder Datenbewertung.
  • Es ist nicht gesagt, dass jede neue Claude-Code-Funktion sofort unterstützt wird.
  • Es hebt Preisänderungen der Upstream-Modelle nicht auf.

4. Wie Sie ein Claude Code Relay auswählen

4.1 Protokollkompatibilität

Das Gateway muss die Anthropic Messages API unterstützen und mindestens Folgendes zuverlässig verarbeiten:

  • Normale Unterhaltungen.
  • Streaming-Ausgaben.
  • Tool-Aufrufe.
  • Lange Kontexte.
  • Die üblichen Anfragen von Claude Code.

Ein Relay, das nur das OpenAI-Protokoll unterstützt, ist für Claude Code nicht zwangsläufig direkt nutzbar. Prüfen Sie, ob ein Anthropic-kompatibler Endpunkt vorhanden ist.

4.2 Stabilität

Achten Sie auf Fehlerrate, P95-Latenz, Rate-Limits sowie darauf, ob Wiederholungen und Ersatzkanäle vorgesehen sind. Eine einzelne erfolgreiche Anfrage sagt wenig aus.

4.3 Abrechnung

Klären Sie, wie Eingabe, Ausgabe und Caching berechnet werden, ob es Mindestumsätze gibt und welche Rückerstattungsregeln gelten. Maßgeblich sind die Modellpreise.

4.4 Kontingentverwaltung

Lassen sich ein Key pro Person, Limits pro Projekt und Ablaufzeiten einrichten? Für Teams ist das unverzichtbar.

4.5 Protokolle

Lassen sich Modell, Token, Dauer und Fehler jeder Anfrage nachvollziehen? Das ist die Grundlage für Fehlersuche und Kostenanalyse.

4.6 Compliance

Werden Daten gespeichert, wie lange, werden sie für das Training verwendet, und lassen sich Verträge abschließen? Im Unternehmensumfeld müssen diese Punkte geklärt sein.

5. Einrichtung

5.1 Key erstellen

Registrieren Sie sich beim ZSQH AI Gateway, erstellen Sie einen speziellen Key für claude-code und legen Sie ein Ausgabenlimit fest.

5.2 Umgebungsvariablen konfigurieren

macOS/Linux:

export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_API_KEY="sk-Ihr-Schluessel"
claude

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
$env:ANTHROPIC_API_KEY="sk-Ihr-Schluessel"
claude

Einige Clients verwenden ANTHROPIC_AUTH_TOKEN. Richten Sie sich nach der jeweiligen Client-Dokumentation.

5.3 Modell wählen

Die Modellnamen entnehmen Sie den Modellpreisen. In Claude Code können Sie je nach Aufgabe zwischen Opus, Sonnet und Haiku wechseln.

5.4 Prüfen

Starten Sie claude im Projektverzeichnis und geben Sie eine einfache Aufgabe ein. Prüfen Sie, ob Dateien gelesen, Code geändert und Befehle ausgeführt werden können.

6. Testcheckliste

  1. Werden normale Unterhaltungen beantwortet?
  2. Funktioniert die Streaming-Ausgabe?
  3. Funktionieren Tool-Aufrufe (Dateien lesen, Befehle ausführen)?
  4. Wird ein langer Kontext abgeschnitten?
  5. Bleibt es bei 5 bzw. 10 gleichzeitigen Anfragen stabil?
  6. Sind die Fehlercodes verständlich?
  7. Ist die Abrechnung plausibel?

Beobachten Sie den Dienst drei bis sieben Tage lang, bevor Sie sich für eine dauerhafte Nutzung entscheiden.

7. Risiken und typische Fallen

7.1 Nur OpenAI-Protokoll

Claude Code arbeitet mit dem Anthropic-Protokoll. Prüfen Sie die Kompatibilität vor dem Kauf.

7.2 Key-Leck

Schreiben Sie den Key nicht in Code, Screenshots oder öffentliche Repositories. Ein Key pro Person und feste Limits sind Pflicht.

7.3 Lockangebote

Ein sehr niedriger Preis kann auf gemeinsam genutzte Kontingente, Rate-Limits, schwache Upstreams oder versteckte Einschränkungen hindeuten. Testen Sie zuerst mit kleinem Volumen.

7.4 Veraltete Modellnamen

Nach Upgrades beim Upstream können alte Namen ungültig werden. Beobachten Sie die Preisseite und Ankündigungen.

7.5 Datencompliance

Klären Sie vor dem Unternehmenseinsatz Datenaufbewahrung, Trainingsnutzung, Verträge und Rechnungen.

8. Offizieller Direktzugang vs. Relay

Kriterium Offizieller Direktzugang Relay-Gateway
Zugang Von der Netzverbindung abhängig Meist besser auf das Inland abgestimmt
Zahlung Offizielle Methoden Aufladung im Portal
Modelle Claude Mehrere Modelle möglich
Abrechnung Offizielles Backend Einheitliche Konsole
Risiko Konto- und Zahlungshürden Risiko der falschen Anbieterwahl

Es gibt kein pauschales Besser oder Schlechter. Entscheidend sind Ihre Netzwerk-, Zahlungs-, Team- und Compliance-Anforderungen.

Häufige Fragen

Kann ein Claude Code Relay zur Kontosperrung führen?

Das hängt von der Compliance des Upstreams beim Anbieter und von Ihrer Nutzung ab. Wählen Sie einen Anbieter mit klaren Bedingungen und stabilem Betrieb und halten Sie die Upstream-Richtlinien ein.

Unterstützt ein Relay alle Claude-Code-Funktionen?

Nicht unbedingt. Neue Funktionen können von bestimmten API-Fähigkeiten abhängen. Testen Sie sie vor dem Einsatz mit Ihrem eigenen Workflow.

Kann man ein Relay selbst betreiben?

Ja. Open-Source-Gateways wie New API oder One API lassen sich selbst hosten, erfordern aber Server, Upstream-Kanäle und Betriebsaufwand. Lesen Sie dazu unseren Leitfaden zu API-Relay-Plattformen.

Nächster Schritt

Wenn Sie Claude Code in China stabil nutzen möchten, können Sie sich zunächst beim ZSQH AI Gateway registrieren, einen Key mit kleinem Volumen erstellen und die Testcheckliste aus diesem Artikel durchlaufen. Details zur Einrichtung finden Sie in der Claude-Code-Einrichtungsanleitung.

Weiterlesen: