Authentifizierung

Das /auth-Menü von Qwen Code beim ersten Start bietet drei Hauptoptionen. Wähle diejenige aus, die deiner gewünschten CLI-Nutzung entspricht:

• Alibaba ModelStudio: offiziell empfohlene Einrichtung. Öffnet ein Untermenü mit Coding Plan (für einzelne Entwickler · wöchentliches Kontingent inklusive), Token Plan (für Teams und Unternehmen · nutzungsbasierte Abrechnung mit dediziertem Endpunkt) oder Standard API Key (Verbindung mit einem bestehenden ModelStudio API Key). Token Plan und Standard API Key aktivieren außerdem das integrierte web_search-Tool ohne zusätzliche Einrichtung.
• Third-party Providers: Wähle einen integrierten Provider und verbinde dich mit einem API Key (DeepSeek, Grok, MiniMax, Z.AI, Kimi, Idealab, ModelScope, OpenRouter, Requesty).
• Custom Provider: Verbinde manuell einen lokalen Server, Proxy oder nicht unterstützten Provider – 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 normalerweise nicht erneut anmelden musst.
• Voraussetzungen: Ein qwen.ai-Konto + Internetzugang (zumindest für die erste Anmeldung).
• Vorteile: Kein API-Key-Management, automatische Aktualisierung der Anmeldedaten.
• Kosten & Kontingent: Der kostenlose Tarif wurde zum 2026-04-15 eingestellt.

Starte die CLI und folge dem Browser-Flow:

qwen

Qwen OAuth wird nicht mehr als auswählbarer Eintrag im /auth-Dialog angeboten; führe stattdessen /auth aus und wähle eine der aktuellen Optionen (Alibaba ModelStudio, Third-party Providers oder Custom Provider).

💳 Option 2: Alibaba Cloud Coding Plan

Verwende diese Option, wenn du vorhersehbare Kosten bei einer Vielzahl von Modelloptionen und höheren Nutzungskontingenten möchtest.

• Funktionsweise: Abonniere den Coding Plan mit einer festen monatlichen Gebühr und konfiguriere dann Qwen Code so, dass es den dedizierten Endpunkt und deinen Abonnement-API-Key verwendet.
• 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 Modelloptionen, höhere Nutzungskontingente, vorhersehbare monatliche Kosten, Zugriff auf eine breite Palette von Modellen (Qwen, GLM, Kimi, Minimax und mehr).
• Kosten & Kontingent: Siehe Aliyun ModelStudio Coding Plan DokumentationBeijing intl .

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

Interaktive Einrichtung

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

Verwende nach der Authentifizierung den Befehl /model, um zwischen allen vom Alibaba Cloud Coding Plan unterstützten Modellen zu wechseln (einschließlich qwen3.5-plus, qwen3.6-plus, qwen3.7-plus, qwen3-coder-plus, qwen3-coder-next, qwen3-max-2026-01-23, glm-5, glm-4.7, kimi-k2.5 und MiniMax-M2.5).

Headless- oder Skript-Einrichtung

Konfiguriere für CI, Container oder Skripte den Coding Plan mit Umgebungsvariablen oder settings.json, anstatt den entfernten Befehl qwen auth coding-plan zu verwenden.

export BAILIAN_CODING_PLAN_API_KEY="sk-sp-xxxxxxxxx"
export OPENAI_BASE_URL="https://coding.dashscope.aliyuncs.com/v1"
export OPENAI_MODEL="qwen3-coder-plus"

Verwende https://coding.dashscope.aliyuncs.com/v1 für den China (Beijing) Endpunkt oder https://coding-intl.dashscope.aliyuncs.com/v1 für den internationalen Endpunkt.

Alternative: Konfiguration über settings.json

Wenn du den interaktiven /auth-Flow überspringen 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: Alibaba Cloud Token Plan

Verwende diese Option, wenn dein Team oder Unternehmen nutzungsbasierte Abrechnung über einen dedizierten ModelStudio-Endpunkt bevorzugt.

• Funktionsweise: Abonniere den Token Plan in Alibaba Cloud ModelStudio und konfiguriere dann Qwen Code so, dass es den regionsspezifischen Token-Plan-Endpunkt und deinen API Key verwendet. Du wirst für die tatsächliche Token-Nutzung abgerechnet, nicht für eine feste monatliche Gebühr.
• Voraussetzungen: Hole dir einen Token-Plan-API-Key von Alibaba Cloud ModelStudio(Beijing)  oder Alibaba Cloud ModelStudio(intl) , abhängig von der Region deines Kontos.
• Vorteile: Nutzungsbasierte Abrechnung für Teams und Unternehmen, dedizierte regionsspezifische Endpunkte, Zugriff auf eine breite Palette von Modellen (Qwen, DeepSeek, GLM, Kimi, Minimax und mehr).
• Kosten & Kontingent: Siehe Alibaba Cloud ModelStudio Token Plan Dokumentation Beijing  intl .

Der Token Plan ist in zwei Regionen verfügbar, jeweils mit einem eigenen dedizierten Endpunkt:

Interaktive Einrichtung

Gib qwen im Terminal ein, um Qwen Code zu starten, führe dann den Befehl /auth aus, wähle Alibaba ModelStudio und wähle Token Plan aus dem Untermenü. Wähle deine Region (China (Beijing) oder Singapore (International)) und gib dann deinen API Key ein. Der Assistent zeigt dann seinen letzten Schritt (Schritt 3/3 · Modell-IDs), wo du die zu konfigurierenden Modell-IDs auswählst: die von deinem Endpunkt bereitgestellten Modelle werden dort angeboten und nur angewendet, wenn du sie explizit auswählst. Token-Plan-API-Keys haben keine Prefix-Anforderung (im Gegensatz zu Coding-Plan-Keys, die mit sk-sp- beginnen).

Verwende nach der Authentifizierung den Befehl /model, um zwischen den für deinen Token Plan konfigurierten Modellen zu blättern und zu wechseln. Die Modellpalette entwickelt sich laufend, daher wird sie hier absichtlich nicht aufgelistet; die Modellerkennung vom Endpunkt erfolgt während des obigen /auth-Einrichtungsschritts (die eigene Liste des Endpunkts wird dort angeboten und muss explizit ausgewählt werden), und /model zeigt dann die für deinen Plan konfigurierten Modelle an.

Headless- oder Skript-Einrichtung

Konfiguriere für CI, Container oder Skripte den Token Plan mit Umgebungsvariablen oder settings.json, anstatt den interaktiven /auth-Flow zu verwenden.

export BAILIAN_TOKEN_PLAN_API_KEY="your-api-key"
export OPENAI_BASE_URL="https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3.7-plus"

Verwende https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 für den China (Beijing) Endpunkt oder https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 für den internationalen (Singapore) Endpunkt. Ersetze qwen3.7-plus durch ein beliebiges in deinem Plan enthaltenes Modell.

Beachte, dass BAILIAN_TOKEN_PLAN_API_KEY ein providerspezifischer Key ist: er wird wirksam, sobald der settings.json-Provider-Eintrag im nächsten Abschnitt existiert, da dieser Eintrag ihn als envKey deklariert. Um die OpenAI-kompatible Authentifizierung nur mit Umgebungsvariablen auszuwählen, exportiere stattdessen OPENAI_API_KEY – providerspezifische Keys wählen nicht von sich aus den Authentifizierungstyp aus.

Alternative: Konfiguration über settings.json

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

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.7-plus",
        "name": "qwen3.7-plus (Token Plan)",
        "baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
        "description": "qwen3.7-plus from Alibaba Cloud Token Plan",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      }
    ]
  },
  "env": {
    "BAILIAN_TOKEN_PLAN_API_KEY": "your-api-key"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.7-plus"
  }
}

🚀 Option 4: API Key (flexibel)

Verwende diese Option, wenn du dich mit Third-party Providern wie OpenAI, Anthropic, Google, Azure OpenAI, OpenRouter, Requesty, ModelScope oder einem selbst gehosteten Endpunkt verbinden möchtest. Unterstützt mehrere Protokolle und Provider.

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

Der einfachste Weg, um mit der API-Key-Authentifizierung zu beginnen, besteht darin, alles in einer einzigen ~/.qwen/settings.json-Datei abzulegen. Hier ist ein vollständiges, 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"
  }
}

Funktion der einzelnen Felder:

Nach dem Speichern der Datei starte einfach qwen – kein interaktives /auth-Setup erforderlich.

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

Unterstützte Protokolle

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

Definiere, welche Modelle für jedes Protokoll verfügbar sind. Jeder Modelleintrag erfordert mindestens eine id; envKey (der Name der Umgebungsvariable, die deinen API Key enthält) ist optional und empfohlen – wenn weggelassen, wird auf den Standard-Umgebungs-Key des Auth-Typs zurückgegriffen (z. B. OPENAI_API_KEY für openai).

Bearbeite ~/.qwen/settings.json (erstelle sie, falls sie nicht existiert). Du kannst mehrere Protokolle in einer einzigen Datei mischen – 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):

Das vollständige modelProviders-Schema und erweiterte Optionen wie generationConfig, customHeaders und extra_body findest du in der Model Providers Reference.

Schritt 2: Umgebungsvariablen festlegen

Qwen Code liest API Keys aus Umgebungsvariablen (angegeben durch envKey in deiner Modellkonfiguration). Es gibt mehrere Möglichkeiten, diese bereitzustellen, unten aufgelistet von der höchsten zur niedrigsten Priorität:

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

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

 
# 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 über mehrere Dateien hinweg nicht zusammengeführt). Es werden nur Variablen geladen, die noch nicht in process.env vorhanden sind.

Suchreihenfolge (ausgehend vom aktuellen Verzeichnis, nach oben zu /):

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 der niedrigsten 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 obigen Ein-Datei-Setup-Beispiel verwendet wird. Es ist praktisch, um alles an einem Ort zu behalten, aber beachte, dass settings.json möglicherweise geteilt oder synchronisiert wird – bevorzuge .env-Dateien für sensible Secrets.

Prioritätsübersicht:

Schritt 3: Modelle mit /model wechseln

Verwende nach dem Start von Qwen Code den Befehl /model, um zwischen allen konfigurierten Modellen zu wechseln. Modelle werden nach Protokoll gruppiert:

/model

Die Auswahl zeigt alle Modelle aus deiner modelProviders-Konfiguration an, gruppiert nach ihrem Protokoll (z. B. openai, anthropic, gemini). Deine Auswahl wird über Sitzungen hinweg beibehalten.

Du kannst Modelle auch direkt mit einem Befehlszeilenargument wechseln, was praktisch ist, wenn du über mehrere Terminals hinweg arbeitest.

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

Entfernter qwen auth CLI-Befehl

Der eigenständige qwen auth CLI-Befehl wurde entfernt. Verwende stattdessen diese Ersetzungen:

Legacy-Aufrufe wie qwen auth status geben einen Entfernungshinweis aus, der diese Migrationspfade zusammenfasst, einschließlich eines Token-Plan-Eintrags mit den Base-URLs für beide Regionen.

Security-Hinweise

• Commite keine API Keys in die Versionskontrolle.
• Bevorzuge .qwen/.env für projektlokale Secrets (und halte sie aus Git heraus).
• Behandle deine Terminalausgabe als sensibel, wenn sie Anmeldedaten zur Überprüfung ausgibt.