Qwen4 in Claude Code einrichten: Modellzuordnung, Schlüssel und Verbindungsfehler
Qwen4-Max mit dem richtigen QwenCloud-Endpunkt in Claude Code verbinden. 401, 403 und CC-Switch-Fehler bei der Modellliste gezielt eingrenzen.
Um Qwen4-Max in Claude Code zu verwenden, konfigurieren Sie die Anthropic-kompatible Basis-URL von QwenCloud, einen für diese Route gültigen Schlüssel und die ausdrückliche Modellzuordnung qwen4-max. Ein anderer Modellname im Menü wechselt noch nicht den Anbieter. Eine erfolgreiche Modelllistenprüfung ist keine Voraussetzung für ein funktionierendes Gespräch.
Grundlage ist die am 17. November 2026 geprüfte QwenCloud-Dokumentation. Es geht um das veröffentlichte Modell, nicht um qwen4-max-preview. Wenn Sie die Versionen zunächst unterscheiden müssen, beginnen Sie mit dem Qwen4-Leitfaden zu API und Migration. Hier ist die Aufgabe enger: den Coding-Client auf die gewünschte Route bringen und die fehlerhafte Ebene ermitteln.
Die folgende Shell-Konfiguration wurde lokal mit einem Ersatzclient geprüft, der Konfigurationsnamen aufzeichnet, nicht mit einem echten Modell. Für dieses Tutorial haben wir keine kostenpflichtigen Qwen4-Aufrufe durchgeführt. Das abschließende Gespräch und die Abrechnungsprüfung führen Sie mit Ihrem eigenen autorisierten Konto durch.
Wählen Sie die Route, bevor Sie den Schlüssel eingeben
QwenCloud dokumentiert getrennte Routen für Token Plan und regionale nutzungsabhängige Abrechnung. Entscheiden Sie sich zuerst für eine davon. Kombinieren Sie keinen Schlüssel der einen Route mit der Basis-URL einer anderen.
| Gewünschte Route | Basis-URL für Claude Code | Zu prüfen |
|---|---|---|
| QwenCloud Token Plan | https://token-plan.maas.qwencloudapi.com/apps/anthropic | Planschlüssel und Zugriff auf das gewählte Modell |
| QwenCloud nach Nutzung, Singapur | https://ap-southeast-1.maas.qwencloudapi.com/apps/anthropic | In dieser Region ausgestellter Schlüssel und Modellzugriff |
| Andere QwenCloud-Region | Dokumentierte Anthropic-kompatible URL dieser Region verwenden | Region, Dienstverfügbarkeit und Geltungsbereich des Schlüssels |
Dies sind Basis-URLs, keine vollständigen URLs für Nachrichtenanfragen. Hängen Sie bei dieser Konfiguration kein /v1 an die QwenCloud-Basis-URL an. Der Client nutzt den darunterliegenden Nachrichtenpfad. Die QwenCloud-Anleitung für Claude Code und die Regionendokumentation beschreiben die jeweiligen Schnittstellenbedingungen.
Ein Ofox-API-Schlüssel ist kein QwenCloud-Schlüssel. Wenn Sie stattdessen ein von Ofox unterstütztes Modell wählen, verwenden Sie die Ofox-Dokumentation zur Authentifizierung und die dort unterstützten Integrationseinstellungen. Geben Sie keinen Ofox-Schlüssel für eine der QwenCloud-Adressen ein. Dieser Leitfaden belegt keine Qwen4-Verfügbarkeit bei Ofox; prüfen Sie das aktuelle Ofox-Modellverzeichnis separat.
Starten Sie eine isolierte Sitzung mit eindeutiger Qwen4-Zuordnung
Verwenden Sie zur ersten Diagnose eine neue Terminalsitzung und ein kleines synthetisches Projekt. Sichern Sie Ihre normale Konfiguration. Der folgende Bash-Starter beschränkt seine exportierten Variablen auf den eigenen Prozess und dessen Client. Er überschreibt keine globale Einstellungsdatei, gibt den Schlüssel nicht aus und speichert ihn nicht im Skript.
Speichern Sie dies als launch-qwen4.sh:
#!/usr/bin/env bash
set -euo pipefail
# Singapore pay-as-you-go. For Token Plan, replace only this route
# and enter the matching Token Plan key when prompted.
export ANTHROPIC_BASE_URL="https://ap-southeast-1.maas.qwencloudapi.com/apps/anthropic"
unset ANTHROPIC_API_KEY
read -r -s -p "QwenCloud key for this route: " ANTHROPIC_AUTH_TOKEN
printf '\n'
if [[ -z "$ANTHROPIC_AUTH_TOKEN" ]]; then
printf 'No key entered; no request sent.\n' >&2
exit 1
fi
export ANTHROPIC_AUTH_TOKEN
# Deliberately use one model while diagnosing routing.
export ANTHROPIC_MODEL="qwen4-max"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen4-max"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen4-max"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen4-max"
export CLAUDE_CODE_SUBAGENT_MODEL="qwen4-max"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"
exec claude "$@"
Führen Sie im Testprojekt bash launch-qwen4.sh aus. Für einen Token-Plan-Test ersetzen Sie die Basis-URL durch den Tabellenwert für Token Plan und geben den dazugehörigen Schlüssel ein. Verwenden Sie keine beliebige günstigere Modell-ID, bevor ihre Verfügbarkeit auf Ihrer Route bestätigt ist.
Alle Aliase auf Qwen4-Max zu legen, dient der Diagnose und ist keine Kostenempfehlung. So lässt sich ausschließen, dass eine Hintergrundaufgabe oder ein Subagent ein anderes konfiguriertes Modell gewählt hat. Sobald die Route bestätigt ist, können Sie einfache Aufgaben gezielt einem anderen unterstützten Modell zuordnen und diese Zuordnung separat testen.
Der Starter überschreibt nicht jede mögliche verwaltete Einstellung, jeden Wrapper oder jede IDE-Erweiterung. Bei einem organisatorisch verwalteten Client gelten dessen Vorgaben. Starten Sie für diesen Test die CLI direkt, damit keine IDE-Konfiguration unbemerkt eine andere Umgebung liefert. Unter Windows nutzen Sie das Bash-Beispiel in einer passenden WSL- oder Git-Bash-Umgebung; native PowerShell verwendet eine andere Syntax für Umgebungsvariablen. Gehen Sie nicht davon aus, dass eine Windows-CLI dieselbe Konfiguration wie eine WSL-Installation liest.
Prüfen Sie Anbieter und Aufgabe getrennt
Führen Sie in der neuen Claude-Code-Sitzung /status aus. Vergleichen Sie Anbieter-URL und gewähltes Modell mit Ihren Sollwerten. Veröffentlichen Sie keine rohen Einstellungsdaten oder Screenshots mit Zugangsdaten. Ist die Route leer oder zeigt weiterhin auf einen anderen Anbieter, prüfen Sie zunächst die von genau diesem Clientprozess geladene Konfiguration, bevor Sie erneut das Modell wechseln.
Nutzen Sie eine kleine Aufgabe ohne private Repository-Inhalte:
Create a Python function named normalize_code(value).
It must accept a string, trim surrounding spaces and preserve leading zeros.
Raise TypeError for non-string input.
Add tests for " 0017 ", "", and the integer 17.
Do not install dependencies or access the network.
Show which files you changed and how to run the tests.
Ein brauchbarer Abnahmenachweis besteht aus drei getrennten Teilen:
- Routing: Die Sitzung meldet den erwarteten Anbieter und die Zuordnung; das Anfrageprotokoll des Anbieters bestätigt, soweit verfügbar, das gewünschte Modell. Die Selbstauskunft eines Modells belegt keine Route.
- Ergebnis: Die Datei existiert,
" 0017 "wird zu"0017", die leere Zeichenfolge bleibt leer und eine Ganzzahl löstTypeErroraus. Führen Sie die erzeugten Tests aus und prüfen Sie den Diff. - Abrechnung: Der Aufruf erscheint in der Nutzungsansicht des vorgesehenen Kontos oder Plans. Leiten Sie die Abrechnungsquelle nicht vom angezeigten Modellnamen ab.
Ist die Antwort gut, aber das falsche Konto wird belastet, ist die Einrichtung nicht bestanden. Stimmt die Route, aber die Tests schlagen fehl, erfassen Sie einen Aufgabenfehler statt eines Verbindungsproblems. Halten Sie den ersten Versuch klein; erst danach folgen umfangreichere Repository-Änderungen oder längere Aufgaben.
Ordnen Sie das Symptom der fehlerhaften Ebene zu
Der offizielle Abschnitt zur Fehlerbehebung trennt mehrere Fehler, die sonst wie ein einziges Problem „Qwen funktioniert nicht“ aussehen können.
| Symptom | Erste sinnvolle Prüfung | Gezielter nächster Schritt |
|---|---|---|
401 invalid_api_key | Schlüsselroute und Region; tatsächlich verwendete Anbieter-URL | Passenden QwenCloud-Schlüssel verwenden und Client neu starten; Schlüssel nicht protokollieren |
| Claude Code verbindet sich weiter mit Anthropic | /status und vom Prozess geladene Konfiguration | Anbieterumgebung und Einstellungen korrigieren; Wrapper und konkurrierende Authentifizierung prüfen |
| CC Switch findet keinen Endpunkt für die Modellliste | Prüft die Abfrage Modellerkennung statt Nachrichten? | Modellzuordnung manuell setzen und echte Nachricht auf der dokumentierten Route testen |
403 AccessDenied nach Modellwechsel | Modellberechtigung und Lebenszyklusstatus in der QwenCloud-Galerie | Nicht verfügbare oder auslaufende Zuordnungen durch zugängliches aktuelles Modell ersetzen; Fehler und Anfrage-ID aufbewahren |
| Modellwechsel bleibt auf alter Route wirkungslos | Enthält die Basis-URL claude-code-proxy? | Auf die dokumentierte Schnittstelle /apps/anthropic wechseln |
| Lange Antwort endet vorzeitig | Angefordertes Client-Ausgabelimit und Abbruchgrund der Antwort | Modellspezifisches Limit prüfen; Aufgabe verkleinern oder Client-Grenze gezielt anpassen |
Wenn die gewünschte eigene Anbieterroute konfiguriert ist, der Start aber weiterhin die offizielle Anthropic-Anmeldung versucht, empfiehlt QwenCloud in den FAQ außerdem die Prüfung von hasCompletedOnboarding: true in ~/.claude.json — einer anderen Datei als ~/.claude/settings.json. Sichern Sie die JSON-Datei zuerst und ergänzen Sie nur das betreffende Feld. Ersetzen Sie nicht die ganze Datei und ändern Sie keine organisatorisch verwalteten Einstellungen. Starten Sie in einem neuen Terminal neu. Scheitert die dokumentierte Einrichtung weiterhin, aktualisieren Sie den Client über seinen offiziellen Installationsweg und prüfen die geladene Konfiguration erneut.
Die Modellliste verdient besondere Aufmerksamkeit. Laut QwenCloud bietet die Anthropic-kompatible Route /v1/messages, aber keinen Modelllisten-Endpunkt. CC Switch kann daher eine fehlgeschlagene Erkennung melden, obwohl die Gesprächsroute funktioniert. Das bedeutet nicht, dass sich jeder 404 ignorieren lässt: Eine falsche Nachrichten-URL, ein zusätzliches Pfadsegment oder ein nicht unterstütztes Modell muss weiterhin korrigiert werden. Prüfen Sie, welche Anfrage fehlgeschlagen ist.
Wenn ein direkter Aufruf funktioniert, der Coding-Client aber weiterhin scheitert, hilft unser Leitfaden zu Verbindungsfehlern in Claude Code (Englisch). Für eine nicht verfügbare genaue Modell-ID siehe OpenAI-Prüfungen bei „model not found“ (Englisch) als übertragbare Methode zur Anbieter- und Endpunktprüfung. Zertifikatsfehler gehören zur TLS- und Zertifikatsdiagnose (Englisch), nicht zur Modellzuordnung. Deaktivieren Sie die Zertifikatsprüfung nicht als Abkürzung.
Legen Sie Kontext- und Ausgabelimits bewusst fest
Die aktuelle QwenCloud-Anleitung gibt für Qwen4-Max CLAUDE_CODE_MAX_CONTEXT_TOKENS=983616 vor. Diese Client-Einstellung bezeichnet nicht dieselbe Größe wie der beworbene Kontext von einer Million Tokens. Ihr Setzen beweist auch nicht, dass eine lange Aufgabe erfolgreich abgeschlossen wird.
Die Version der Anleitung vom 17. November empfiehlt bei abgeschnittener Qwen4-Max-Ausgabe CLAUDE_CODE_MAX_OUTPUT_TOKENS=131072. Der Preview-Hinweis auf derselben Seite verwendet 64000. Vermischen Sie die Preview-Empfehlung nicht mit der Konfiguration des veröffentlichten Modells. Für einen ersten Funktionstest müssen Sie nicht das Maximum setzen: Viel erlaubte Ausgabe kann Laufzeit und Verbrauch erhöhen. Prüfen Sie den Abbruchgrund und wählen Sie eine zur Aufgabe passende Grenze.
Wenn Ihr Agent ein großes Referenzdokument wiederholt nutzt, lesen Sie das Qwen4-Tutorial zum expliziten Cache. Ein großes Kontextfenster ist eine Kapazitätsangabe; Caching folgt einem eigenen Anfragevertrag. Ohne passende Nutzungsfelder belegt keines davon einen Cache-Treffer.
Halten Sie eine wiederherstellbare Konfiguration fest
Notieren Sie nach bestandenem Test Clientversion, Anbieter-Basis-URL, Modellzuordnung, Schlüsseltyp und Region, Testergebnis und Zeitpunkt. Speichern Sie den Schlüssel selbst in Ihrer üblichen Geheimnisverwaltung. Wenn Sie dauerhafte Einstellungen ändern, ergänzen Sie die benötigten Felder in der vorhandenen Datei, statt unabhängige Berechtigungen und Einstellungen zu überschreiben.
Ändern Sie bei späteren Fehlern jeweils nur eine Variable und bewahren Sie bereinigte Anfrage-ID, HTTP-Status, Fehlercode und Modell-ID auf. Um den Starter zurückzunehmen, beenden Sie die gestartete Sitzung und öffnen Ihren normalen Client aus dem übergeordneten Terminal. Der Starter hat weder dessen Umgebung noch Ihre Einstellungsdatei verändert. Falls Sie zusätzlich dauerhafte Einstellungen geändert haben, stellen Sie auch deren gesicherte Version wieder her.
Die Einrichtung ist abgeschlossen, wenn gewünschte Route, gelieferte Dateien und vorgesehener Nutzungsnachweis übereinstimmen. Damit können Sie Modelle bei echten Programmieraufgaben vergleichen, statt bei jedem Versuch eine andere Route zu diagnostizieren.
Häufig gestellte Fragen
- Muss der Qwen-Endpunkt für Claude Code eine Modellliste bereitstellen?
- Nein. Laut QwenCloud bietet der Anthropic-kompatible Endpunkt Nachrichten, aber keine Modellerkennung. Eine fehlgeschlagene Modelllistenprüfung in CC Switch ist etwas anderes als eine fehlgeschlagene Nachrichtenanfrage.
- Bedeutet die Auswahl von Opus, dass ein Anthropic-Modell antwortet?
- Nicht unbedingt. Bei einem eigenen Anbieter kann der Alias Opus auf Qwen4-Max zeigen. Prüfen Sie Anbieter, genaue Modellzuordnung und Anfrageprotokoll des Anbieters.


