Claude Code China Vollständiger Leitfaden

Funktioniert Claude in China? Die offizielle Regionenliste

Stand 2026-10-15 listet Anthropics Supported Regions Policy (gültig seit 2026-05-12) die Länder und Regionen auf, in denen Anthropic seine Produkte und Dienste anbietet; das chinesische Festland steht nicht auf dieser Liste.

Die Supported Regions Policy wird von Anthropic veröffentlicht; zitiert ist oben die seit 2026-05-12 gültige Fassung. Wo Anthropic seine eigenen Produkte und Dienste anbietet, richtet sich nach der jeweils aktuellen Fassung dieser Seite.

Claude-Abo (Pro/Max/Ultra) oder QCode-Key?

QCode.cc ist ein unabhängiger API-Zugangsdienst, nicht mit Anthropic verbunden oder von ihm empfohlen. Entwickler in China nutzen einen QCode-Key mit cr_-Präfix: In Claude Code zeigt ANTHROPIC_BASE_URL auf QCode, der Key steht in ANTHROPIC_AUTH_TOKEN, aufgeladen wird per Alipay oder WeChat Pay. QCode gibt Ihnen claude-sonnet-5 über eine einzelne API, ohne separaten Anthropic-Account, den Sie verwalten müssten. Derselbe Key ruft auch andere Claude-Modelle wie claude-opus-5-5 und claude-sonnet-5-5 auf; welche Modelle aufrufbar sind, steht auf /models.

Claude Code lässt sich auf zwei Arten nutzen: mit Anmeldung über ein Claude-Abo oder über ein Gateway mit API-Zugangsdaten. Laut offizieller Dokumentation tragen Anfragen, solange eine Gateway-Variable mit Zugangsdaten aktiv ist, diese Zugangsdaten statt der claude.ai-Abo-Anmeldung, und die Nutzungslimits des Abos gelten dafür nicht. Wer nur ANTHROPIC_BASE_URL ohne Zugangsdaten-Variable setzt, bleibt mit der gespeicherten claude.ai-Anmeldung aktiv. Für QCode brauchen Sie deshalb beide Variablen, ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN.

Die QCode-Dokumentation hält fest, dass ein Anthropic- oder OpenAI-Abo bei QCode nicht nutzbar ist und von QCode auch nicht verbraucht wird; beides sind parallele Systeme. Die Tarife von QCode sind Prepaid: erst aufladen, dann einen Tarif kaufen, der vom Guthaben abgebucht wird. Abgerechnet wird pro Token; die Preise je Modell stehen auf /models. Privatpläne haben kein 4-Stunden-Fenster, das Tageslimit wird um 00:00 Uhr Pekinger Zeit zurückgesetzt.

• Claude-Abo (Pro / Max / Ultra): Mitgliedschaft für die offiziellen Apps, monatlich bezahlt. Am 30.10.2026 hat Anthropic Max 5x in Max und Max 20x in Ultra umbenannt; die Preise sind unverändert.
• Offizieller API-Key: Entwickler-Key aus der Anthropic Console, Abrechnung pro Token, Aufladung auf Anthropics Plattform.
• QCode-Key (beginnt mit cr_): ein Key für Claude, GPT und führende chinesische Modelle, aufladbar per Alipay oder WeChat Pay.

Bezahlen aus China: von der Aufladung zum ersten Key

Das QCode-Dashboard nennt drei Schritte: aufladen, einen Privatplan oder ein Nutzungspaket kaufen, loslegen. In CNY zahlen Sie per Alipay oder WeChat Pay (keine Gebühr), CNY-Aufladungen beginnen bei ¥30 und Nutzungspakete bei $4; das nach dem Kauf verbleibende Guthaben können Sie für den Nachkauf eines Pakets oder für einen Privatplan verwenden. In USD zahlen Sie per Visa / Mastercard, Apple Pay, Google Pay oder Krypto über viele Coins und Netzwerke. CNY- und USD-Guthaben werden getrennt geführt; jede Aufladung landet im Guthaben ihrer Währung.

Ist das Guthaben da, wählen Sie unter qcode.cc/subscribe einen empfohlenen Tarif oder eine eigene Konfiguration; dieser Schritt wird vom Guthaben bezahlt, die Karte wird nicht erneut belastet. Die Bestätigungsseite zeigt „Subscription Activated — Your API Key is created and ready to use“, und Ihr cr_-Key lässt sich sofort kopieren. Wenn Sie unsicher sind, starten Sie klein: Ein Upgrade ist jederzeit ohne Verlust möglich. Kaufen Sie den höheren Tarif und schreiben Sie an hi@qcode.cc; die ungenutzte Laufzeit des alten Tarifs wird anteilig Ihrem QCode-Guthaben gutgeschrieben.

• Alipay und WeChat Pay: Gutschrift auf das CNY-Guthaben.
• Karten, Apple Pay und Google Pay: Gutschrift sofort nach Abschluss der Zahlung.
• Krypto: 0 % Plattformgebühr, manuelle Prüfung in etwa einem Tag.
• Tageskontingent aufgebraucht: Im Dashboard ein Booster-Paket kaufen; es wird separat um 02:00 Uhr Pekinger Zeit am Folgetag zurückgesetzt.

Einrichtung in China: Installation, dauerhafte Konfiguration, typische Fehler

Installation: Das offizielle npm-Paket braucht Node.js 22 oder neuer, und die QCode-Dokumentation nennt einen Mirror für Netze auf dem Festland: npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com. Alternativ führen Sie das Einzeiler-Skript aus der Dokumentation aus, curl -fsSL https://qcode.cc/install/claude-code.sh | bash (unter Windows: irm https://qcode.cc/install/claude-code.ps1 | iex), das die gesamte Konfiguration mit einem Befehl erledigt.

Dauerhafte Konfiguration: Die offizielle Dokumentation empfiehlt, ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN in den env-Block von ~/.claude/settings.json zu schreiben, damit auch Hintergrund-Sitzungen sie erhalten; setzen Shell und Einstellungsdatei dieselbe Variable, gilt die Einstellungsdatei. Legen Sie den Key nicht in die .claude/settings.json eines Projekts, denn diese Datei wird mit dem Repository committet. Führen Sie danach /status in Claude Code aus: Zeigt die Zeile Anthropic base URL Ihre QCode-Adresse und nennt die Zeile Auth token ANTHROPIC_AUTH_TOKEN, ist die Einrichtung aktiv.

• 401: Der Key ist ungültig oder wurde falsch übergeben; prüfen Sie, ob das cr_-Präfix vollständig ist. Ein Key mit sk-ant- ist ein offizieller Anthropic-Key, kein QCode-Key.
• 404: meist ein falsches Pfadpräfix oder ein überzähliger Schrägstrich am Ende. Setzen Sie ANTHROPIC_BASE_URL auf https://asia.qcode.cc/api oder https://api.qcode.cc/api, ohne /v1/messages.
• model_not_available_on_endpoint: Ein Claude-Modell wurde an eine Adresse mit OpenAI-Protokoll geschickt; Claude funktioniert nur über das Anthropic-Protokoll.
• Tägliches Kostenlimit erreicht: Das Limit wird um 00:00 Uhr Pekinger Zeit zurückgesetzt, für den Rest des Tages hilft ein Booster-Paket.
• ETIMEDOUT bei der Installation: Wechseln Sie auf den oben genannten Mirror.