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.

Eine Telefonvermittlung verbindet einen orangefarbenen Stecker mit der passenden Buchse.

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 RouteBasis-URL für Claude CodeZu prüfen
QwenCloud Token Planhttps://token-plan.maas.qwencloudapi.com/apps/anthropicPlanschlüssel und Zugriff auf das gewählte Modell
QwenCloud nach Nutzung, Singapurhttps://ap-southeast-1.maas.qwencloudapi.com/apps/anthropicIn dieser Region ausgestellter Schlüssel und Modellzugriff
Andere QwenCloud-RegionDokumentierte Anthropic-kompatible URL dieser Region verwendenRegion, 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:

  1. 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.
  2. Ergebnis: Die Datei existiert, " 0017 " wird zu "0017", die leere Zeichenfolge bleibt leer und eine Ganzzahl löst TypeError aus. Führen Sie die erzeugten Tests aus und prüfen Sie den Diff.
  3. 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.

SymptomErste sinnvolle PrüfungGezielter nächster Schritt
401 invalid_api_keySchlüsselroute und Region; tatsächlich verwendete Anbieter-URLPassenden QwenCloud-Schlüssel verwenden und Client neu starten; Schlüssel nicht protokollieren
Claude Code verbindet sich weiter mit Anthropic/status und vom Prozess geladene KonfigurationAnbieterumgebung und Einstellungen korrigieren; Wrapper und konkurrierende Authentifizierung prüfen
CC Switch findet keinen Endpunkt für die ModelllistePrüft die Abfrage Modellerkennung statt Nachrichten?Modellzuordnung manuell setzen und echte Nachricht auf der dokumentierten Route testen
403 AccessDenied nach ModellwechselModellberechtigung und Lebenszyklusstatus in der QwenCloud-GalerieNicht verfügbare oder auslaufende Zuordnungen durch zugängliches aktuelles Modell ersetzen; Fehler und Anfrage-ID aufbewahren
Modellwechsel bleibt auf alter Route wirkungslosEnthält die Basis-URL claude-code-proxy?Auf die dokumentierte Schnittstelle /apps/anthropic wechseln
Lange Antwort endet vorzeitigAngefordertes Client-Ausgabelimit und Abbruchgrund der AntwortModellspezifisches 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.