Authentifizierung

Qwen Code unterstützt drei Authentifizierungsmethoden. Wähle diejenige, die zu deinem gewünschten CLI-Workflow passt:

• Qwen OAuth: Melde dich im Browser mit deinem qwen.ai-Konto an. Kostenloser Tarif am 2026-04-15 eingestellt — wechsle zu einer anderen Methode.
• Alibaba Cloud Coding Plan: Verwende einen API-Key von Alibaba Cloud. Kostenpflichtiges Abonnement mit vielfältigen Modell-Optionen und höheren Kontingenten.
• API Key: Verwende deinen eigenen API-Key. Flexibel anpassbar an deine Anforderungen — unterstützt OpenAI, Anthropic, Gemini und andere kompatible Endpunkte.

Option 1: Qwen OAuth (Eingestellt)

• Funktionsweise: Beim ersten Start öffnet Qwen Code eine Browser-Login-Seite. Nach Abschluss werden die Anmeldedaten lokal zwischengespeichert, sodass du dich in der Regel nicht erneut anmelden musst.
• Voraussetzungen: Ein qwen.ai-Konto + Internetzugang (zumindest für die erste Anmeldung).
• Vorteile: Keine Verwaltung von API-Keys, automatische Aktualisierung der Anmeldedaten.
• Kosten & Kontingent: Der kostenlose Tarif wurde zum 2026-04-15 eingestellt.

Starte die CLI und folge dem Browser-Flow:

qwen

Oder authentifiziere dich direkt, ohne eine Sitzung zu starten:

qwen auth qwen-oauth

💳 Option 2: Alibaba Cloud Coding Plan

Verwende diese Option, wenn du planbare Kosten mit vielfältigen Modell-Optionen und höheren Nutzungskontingenten möchtest.

• Funktionsweise: Abonniere den Coding Plan mit einer festen monatlichen Gebühr und konfiguriere dann Qwen Code so, dass der dedizierte Endpunkt und dein Abonnement-API-Key verwendet werden.
• Voraussetzungen: Hole dir ein aktives Coding-Plan-Abonnement von Alibaba Cloud ModelStudio(Beijing)  oder Alibaba Cloud ModelStudio(intl) , abhängig von der Region deines Kontos.
• Vorteile: Vielfältige Modell-Optionen, höhere Nutzungskontingente, planbare monatliche Kosten, Zugriff auf eine breite Palette von Modellen (Qwen, GLM, Kimi, Minimax und mehr).
• Kosten & Kontingent: Siehe die Dokumentation zum Aliyun ModelStudio Coding Plan Beijing  intl .

Der Alibaba Cloud Coding Plan ist in zwei Regionen verfügbar:

Interaktive Einrichtung

Du kannst die Coding-Plan-Authentifizierung auf zwei Arten einrichten:

Option A: Über das Terminal (empfohlen für die Ersteinrichtung)

# Interaktiv — fragt nach Region und API-Key
qwen auth coding-plan
 
# Oder nicht-interaktiv — Region und Key direkt übergeben
qwen auth coding-plan --region china --key sk-sp-xxxxxxxxx

Option B: Innerhalb einer Qwen Code-Sitzung

Gib qwen im Terminal ein, um Qwen Code zu starten, führe dann den /auth-Befehl aus und wähle Alibaba Cloud Coding Plan. Wähle deine Region und gib dann deinen sk-sp-xxxxxxxxx-Key ein.

Nach der Authentifizierung verwende den /model-Befehl, um zwischen allen vom Alibaba Cloud Coding Plan unterstützten Modellen zu wechseln (einschließlich qwen3.5-plus, qwen3-coder-plus, qwen3-coder-next, qwen3-max, glm-4.7 und kimi-k2.5).

Alternative: Konfiguration über settings.json

Wenn du den interaktiven /auth-Flow umgehen möchtest, füge Folgendes zu ~/.qwen/settings.json hinzu:

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus (Coding Plan)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "qwen3-coder-plus from Alibaba Cloud Coding Plan",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      }
    ]
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

🚀 Option 3: API Key (flexibel)

Verwende diese Option, wenn du dich mit Drittanbietern wie OpenAI, Anthropic, Google, Azure OpenAI, OpenRouter, ModelScope oder einem selbst gehosteten Endpunkt verbinden möchtest. Unterstützt mehrere Protokolle und Anbieter.

Empfohlen: Ein-Datei-Setup über settings.json

Der einfachste Weg, um mit der API-Key-Authentifizierung zu starten, ist, alles in einer einzigen ~/.qwen/settings.json-Datei zu speichern. Hier ist ein vollständiges, sofort einsatzbereites Beispiel:

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "description": "Qwen3-Coder via Dashscope",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-xxxxxxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

Bedeutung der einzelnen Felder:

Nach dem Speichern der Datei führe einfach qwen aus — kein interaktives /auth-Setup erforderlich.

Das zentrale Konzept sind Model Providers (modelProviders): Qwen Code unterstützt mehrere API-Protokolle, nicht nur OpenAI. Du konfigurierst, welche Anbieter und Modelle verfügbar sind, indem du ~/.qwen/settings.json bearbeitest, und wechselst zur Laufzeit mit dem /model-Befehl zwischen ihnen.

Unterstützte Protokolle

Schritt 1: Modelle und Anbieter in ~/.qwen/settings.json konfigurieren

Definiere, welche Modelle für jedes Protokoll verfügbar sind. Jeder Modell-Eintrag benötigt mindestens eine id und einen envKey (den Namen der Umgebungsvariable, die deinen API-Key enthält).

Bearbeite ~/.qwen/settings.json (erstelle die Datei, falls sie nicht existiert). Du kannst mehrere Protokolle in einer einzigen Datei kombinieren – hier ist ein Multi-Provider-Beispiel, das nur den modelProviders-Abschnitt zeigt:

{
  "modelProviders": {
    "openai": [
      {
        "id": "gpt-4o",
        "name": "GPT-4o",
        "envKey": "OPENAI_API_KEY",
        "baseUrl": "https://api.openai.com/v1"
      }
    ],
    "anthropic": [
      {
        "id": "claude-sonnet-4-20250514",
        "name": "Claude Sonnet 4",
        "envKey": "ANTHROPIC_API_KEY"
      }
    ],
    "gemini": [
      {
        "id": "gemini-2.5-pro",
        "name": "Gemini 2.5 Pro",
        "envKey": "GEMINI_API_KEY"
      }
    ]
  }
}

ModelConfig-Felder (jeder Eintrag innerhalb von modelProviders):

Für das vollständige modelProviders-Schema und erweiterte Optionen wie generationConfig, customHeaders und extra_body siehe Model Providers Reference.

Schritt 2: Umgebungsvariablen setzen

Qwen Code liest API-Keys aus Umgebungsvariablen (angegeben durch envKey in deiner Modell-Konfiguration). Es gibt mehrere Möglichkeiten, sie bereitzustellen, unten aufgelistet von höchster zu niedrigster Priorität:

1. Shell-Umgebung / export (höchste Priorität)

Setze sie direkt in deinem Shell-Profil (~/.zshrc, ~/.bashrc usw.) oder inline vor dem Start:

 
# Alibaba Dashscope
export DASHSCOPE_API_KEY="sk-..."
 
# OpenAI / OpenAI-kompatibel
export OPENAI_API_KEY="sk-..."
 
# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
 
# Google GenAI
export GEMINI_API_KEY="AIza..."

2. .env-Dateien

Qwen Code lädt automatisch die erste .env-Datei, die es findet (Variablen werden nicht über mehrere Dateien hinweg zusammengeführt). Nur Variablen, die noch nicht in process.env vorhanden sind, werden geladen.

Suchreihenfolge (vom aktuellen Verzeichnis aus nach oben bis /):

1. .qwen/.env (bevorzugt – hält Qwen-Code-Variablen isoliert von anderen Tools)
2. .env

Wenn nichts gefunden wird, wird auf dein Home-Verzeichnis zurückgegriffen:

3. ~/.qwen/.env
4. ~/.env

3. settings.json → env-Feld (niedrigste Priorität)

Du kannst API-Keys auch direkt in ~/.qwen/settings.json unter dem env-Key definieren. Diese werden als Fallback mit niedrigster Priorität geladen – sie werden nur angewendet, wenn eine Variable nicht bereits durch die Systemumgebung oder .env-Dateien gesetzt ist.

{
  "env": {
    "DASHSCOPE_API_KEY": "sk-...",
    "OPENAI_API_KEY": "sk-...",
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

Dies ist der Ansatz, der im Ein-Datei-Setup-Beispiel oben verwendet wird. Es ist praktisch, um alles an einem Ort zu halten, aber beachte, dass settings.json geteilt oder synchronisiert werden kann – bevorzuge .env-Dateien für sensible Secrets.

Prioritätsübersicht:

Schritt 3: Modelle mit /model wechseln

Nach dem Start von Qwen Code verwende den /model-Befehl, um zwischen allen konfigurierten Modellen zu wechseln. Modelle sind nach Protokoll gruppiert:

/model

Das Auswahlmenü zeigt alle Modelle aus deiner modelProviders-Konfiguration, gruppiert nach ihrem Protokoll (z. B. openai, anthropic, gemini). Deine Auswahl wird sitzungsübergreifend gespeichert.

Du kannst Modelle auch direkt über ein Kommandozeilen-Argument wechseln, was praktisch ist, wenn du mit mehreren Terminals arbeitest.

# In einem Terminal
 
qwen --model "qwen3-coder-plus"
 
# In einem anderen Terminal
 
qwen --model "qwen3.5-plus"

qwen auth CLI-Befehl

Zusätzlich zum /auth-Slash-Befehl innerhalb der Sitzung bietet Qwen Code einen eigenständigen qwen auth CLI-Befehl, um die Authentifizierung direkt über das Terminal zu verwalten – ohne vorher eine interaktive Sitzung zu starten.

Interaktiver Modus

Führe qwen auth ohne Argumente aus, um ein interaktives Menü zu erhalten:

qwen auth

Du siehst einen Auswahldialog mit Pfeiltasten-Navigation:

Select authentication method:

  Alibaba Cloud Coding Plan - Paid · Up to 6,000 requests/5 hrs · All Alibaba Cloud Coding Plan Models
  API Key - Bring your own API key
  Qwen OAuth - Discontinued — switch to Coding Plan or API Key

(Use ↑ ↓ arrows to navigate, Enter to select, Ctrl+C to exit)

Unterbefehle

Beispiele:

# Direkt mit Qwen OAuth authentifizieren
qwen auth qwen-oauth
 
# Coding Plan interaktiv einrichten (fragt nach Region und Key)
qwen auth coding-plan
 
# Coding Plan nicht-interaktiv einrichten (nützlich für CI/Skripte)
qwen auth coding-plan --region china --key sk-sp-xxxxxxxxx
 
# API-Key einrichten (ModelStudio Standard oder benutzerdefinierter Anbieter)
qwen auth api-key
 
# Aktuelle Auth-Konfiguration prüfen
qwen auth status

Sicherheitshinweise

• Committe keine API-Keys in die Versionskontrolle.
• Verwende .qwen/.env für projektlokale Secrets (und halte sie aus Git heraus).
• Behandle deine Terminal-Ausgabe als vertraulich, wenn sie Anmeldedaten zur Verifikation ausgibt.