Claude Code ist das Kommandozeilen-Werkzeug von Anthropic für die Programmierung: Code im Terminal lesen, ändern, Tests ausführen und Refactorings durchführen. Standardmäßig ruft es die Anthropic-API auf, weshalb Entwickler in China häufig auf drei Probleme stoßen: instabiler Zugang zur offiziellen Schnittstelle, eingeschränkte Zahlungsmethoden und schwer verwaltbare Teamkontingente und Kosten.
Das ZSQH AI Gateway bietet einen einheitlichen API-Zugang: Mit einem einzigen API Key lassen sich Claude und andere gängige Modelle über kompatible Schnittstellen aufrufen. Dieser Artikel führt vollständig durch Registrierung, Key-Erstellung, Base-URL-Konfiguration und den ersten Lauf.
Hinweis: Claude Code wird häufig aktualisiert; Umgebungsvariablen und Menübezeichnungen können sich mit der Version ändern. Dieser Artikel beschreibt den üblichen Stand im Oktober 2026; maßgeblich sind
claude --helpund die offizielle Dokumentation.
1. Zuerst klären: Welche Schnittstelle nutzt Claude Code?
Claude Code verwendet standardmäßig die Anthropic Messages API, nicht die Chat Completions API von OpenAI. Für die Anbindung an ein Drittanbieter-Gateway sind drei Dinge nötig:
- Base URL: die Schnittstellenadresse, zum Beispiel
https://ai.zhongshangqihang.com. - API Key: ein im ZSQH-Kontrollzentrum erstelltes Token, üblicherweise beginnend mit
sk-. - Modellname: etwa
claude-sonnet-4-5oderclaude-opus-4-1; maßgeblich sind die aktuell auf der Preisseite angezeigten Namen.
Wenn Sie das OpenAI SDK oder andere OpenAI-kompatible Werkzeuge verwenden, lautet die Base URL üblicherweise https://ai.zhongshangqihang.com/v1; bei Verwendung des Anthropic-Protokolls in Claude Code wird in der Regel die Stammasdresse eingetragen, und der Client ergänzt /v1/messages selbst.
2. Konto und API Key vorbereiten
2.1 Registrieren und anmelden
Öffnen Sie das ZSQH AI Gateway, registrieren Sie ein Konto und melden Sie sich im Kontrollzentrum an.
2.2 API Key erstellen
Rufen Sie im Kontrollzentrum die Seite „API-Schlüssel“ auf und legen Sie einen neuen Schlüssel an. Empfehlungen:
- Den Namen eindeutig nach Zweck benennen, etwa
claude-code-arbeitsrechner. - Eine Obergrenze setzen, damit ein geleakter Key nicht massenhaft verbraucht wird.
- Eine Ablaufzeit setzen, damit der Key bei längerer Nichtnutzung automatisch ungültig wird.
- Den Key sofort nach der Erstellung kopieren und speichern; er wird meist nur einmal vollständig angezeigt.
2.3 Guthaben prüfen
Prüfen Sie den Kontostand auf der Seite „Wallet“ oder „Aufladen“. Die Abrechnung unterscheidet sich je Modell; konkrete Einzelpreise stehen in den Modellpreisen.
3. Claude Code konfigurieren
Variante A: Umgebungsvariablen unter macOS / Linux
Im Terminal ausführen:
export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_API_KEY="sk-IHR-SCHLUESSEL"
claude
Sollen die Einstellungen bei jedem Öffnen des Terminals gelten, die beiden Zeilen in ~/.zshrc oder ~/.bashrc eintragen und anschließend source ~/.zshrc ausführen.
Variante B: Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
$env:ANTHROPIC_API_KEY="sk-IHR-SCHLUESSEL"
claude
Variante C: Wenn der Client AUTH_TOKEN verlangt
Einige Drittanbieter-Clients oder Proxy-Konfigurationen verwenden ANTHROPIC_AUTH_TOKEN statt ANTHROPIC_API_KEY:
export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_AUTH_TOKEN="sk-IHR-SCHLUESSEL"
Existieren beide Variablen gleichzeitig, gemäß Client-Dokumentation nur eine behalten, um Konflikte bei den Authentifizierungsheadern zu vermeiden. Verschiedene Claude-Code-Versionen unterstützen die Variablennamen nicht vollständig identisch; bei 401 zuerst diesen Punkt prüfen.
Variante D: Projektbezogene Konfiguration
Wenn die globale Umgebung unverändert bleiben soll, können Sie im Projektverzeichnis über .env oder ein Startskript Umgebungsvariablen injizieren. Achten Sie darauf, .env nicht in Git einzuchecken:
# .env.local (nicht einchecken)
ANTHROPIC_BASE_URL=https://ai.zhongshangqihang.com
ANTHROPIC_API_KEY=sk-IHR-SCHLUESSEL
Laden Sie die Datei anschließend vor dem Start von Claude Code. Die Ladeart unterscheidet sich je Shell; halten Sie sich an die Projektkonventionen.
4. Modell auswählen
Die Claude-Reihe ist üblicherweise in drei Stufen gegliedert: Opus, Sonnet und Haiku:
| Stufe | Geeignete Szenarien | Eigenschaften |
|---|---|---|
| Opus | Komplexe Refactorings, lange Agent-Ketten, schwieriges Reasoning | Stärkste Fähigkeiten, meist höchster Einzelpreis |
| Sonnet | Tägliches Programmieren, Bugfixing, Code-Review | Ausgewogen zwischen Fähigkeit und Kosten |
| Haiku | Einfache Vervollständigung, Batch-Aufgaben, kostengünstige Aufrufe | Schnell, meist niedrigerer Einzelpreis |
In Claude Code lässt sich das Modell über Modellparameter oder Umgebungsvariablen festlegen. Die tatsächlich verfügbaren Modellnamen stehen auf der Seite Modellpreise; ein nicht existierender Name führt üblicherweise zu model not found.
5. Erster Aufruf und Fehlersuche
Nach der Konfiguration im Projektverzeichnis starten:
claude
Dann eine einfache Aufgabe eingeben, etwa „Erklären Sie die Verzeichnisstruktur dieses Projekts“. Kommt eine normale Antwort, funktionieren Base URL, Key und Modell.
Häufige Fehler:
| Fehler | Mögliche Ursache | Vorgehen |
|---|---|---|
401 (nicht authentifiziert) |
Key falsch, abgelaufen oder Variablenname falsch | Key neu kopieren; ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN prüfen |
404 Not Found |
Base URL mit zu viel oder zu wenig /v1 |
Claude Code nutzt die Stammasdresse; OpenAI SDK nutzt /v1 |
model not found |
Modellname existiert nicht oder ist nicht freigeschaltet | Aktuellen Modellnamen von der Preisseite kopieren |
429 Too Many Requests |
Parallelität oder Rate überschritten | Parallelität senken, später erneut versuchen; Kontingent prüfen |
insufficient quota |
Guthaben reicht nicht | Aufladen und erneut versuchen |
| Hängt fest / Timeout | Netz- oder Proxyproblem | Netz, DNS und Proxy-Einstellungen prüfen |
6. Kosten und Kontingente steuern
Die Kosten von Claude Code entstehen vor allem durch Eingabe-Tokens, Ausgabe-Tokens sowie langen Kontext und Caching. Zur Kontrolle:
- Für jedes Projekt einen eigenen Key mit Kontingent und Ablaufzeit anlegen.
- Einfache Aufgaben mit Sonnet/Haiku, komplexe Aufgaben mit Opus.
- Nicht das gesamte große Repository in den Kontext laden; Claude Code zunächst die relevanten Dateien lesen lassen.
- Regelmäßig die Nutzungslogs prüfen, um Projekte und Modelle mit dem höchsten Verbrauch zu finden.
- Im Team ein einheitliches Gateway nutzen, um Mitglieder, Keys, Kontingente und Abrechnung getrennt zu verwalten.
Konkrete Einzelpreise und Abrechnungsregeln stehen in den Modellpreisen. Preise ändern sich mit Modellversionen und Upstream-Richtlinien; im Text werden keine festen Zahlen genannt, um veraltete Angaben zu vermeiden.
7. Sicherheitsempfehlungen
- API Keys nicht in Code, Screenshots, Git-Repositories oder öffentliche Dokumente schreiben.
- Für Keys Obergrenzen und Ablaufzeiten setzen.
- Bei Verdacht auf Kompromittierung den alten Key sofort löschen und neu erstellen.
- Im Team pro Person einen Key verwenden, um Prüfung und Deaktivierung zu erleichtern.
- Produktions- und Testumgebung mit unterschiedlichen Keys betreiben.
Häufige Fragen
Sind Claude Code und die Claude API dasselbe?
Nein. Claude Code ist ein Programmierwerkzeug, die Claude API eine Modellschnittstelle. Claude Code ruft Modelle über die API auf; mit der Claude API lassen sich auch eigene Anwendungen entwickeln.
Lässt sich ein ZSQH-Key direkt in Claude Code verwenden?
Ja, sofern der Client das Anthropic-kompatible Protokoll nutzt und Base URL, Key und Modellname korrekt konfiguriert sind. Maßgeblich sind die Einbindungshinweise auf dieser Website und die aktuelle Client-Version.
Warum wird ein Gateway statt direkter Anbindung empfohlen?
Der Wert eines Gateways liegt vor allem in einheitlichem Zugang, einheitlicher Abrechnung, Kontingentverwaltung, nachvollziehbarer Nutzung und Modellwechseln. Für Teams und den Zugang aus China ist es meist leichter zu verwalten, als für jedes Mitglied ein eigenes Herstellerkonto zu beantragen.
Wird Node.js benötigt?
Claude Code wird üblicherweise über npm installiert und benötigt eine Node.js-Umgebung. Die Installationsart richtet sich nach der offiziellen Dokumentation.
Nächste Schritte
Falls Sie noch kein Konto haben, können Sie sich beim ZSQH AI Gateway registrieren, einen Test-Key erstellen und gemäß diesem Artikel die erste Aufgabe ausführen. Bei Fragen zu Modellnamen oder Abrechnung zuerst die Modellpreise prüfen und dann die Nutzungslogs im Kontrollzentrum auswerten.
Weiterlesen:
