Authentifizierung

Das /auth-Menü bei der ersten Ausführung von Qwen Code bietet drei Optionen auf oberster Ebene. Wählen Sie diejenige aus, die zu Ihrer gewünschten Nutzung der CLI passt:

• Alibaba ModelStudio: Offizielle empfohlene Einrichtung. Öffnet ein Untermenü mit Coding Plan (für einzelne Entwickler · wöchentliches Kontingent inklusive), Token Plan (für Teams und Unternehmen · nutzungsabhängige Abrechnung mit dediziertem Endpunkt) oder Standard API Key (mit einem vorhandenen ModelStudio-API-Key verbinden).
• Third-party Providers: Wählen Sie einen integrierten Anbieter aus und verbinden Sie sich mit einem API-Key (DeepSeek, MiniMax, Z.AI, Idealab, ModelScope, OpenRouter, Requesty).
• Custom Provider: Stellen Sie manuell eine Verbindung zu einem lokalen Server, Proxy oder nicht unterstützten Anbieter her – unterstützt OpenAI, Anthropic, Gemini und andere kompatible Endpunkte.

Option 1: Qwen OAuth (Eingestellt)

• Funktionsweise: Beim ersten Start öffnet Qwen Code eine Browser-Anmeldeseite. Nach Abschluss werden die Anmeldedaten lokal zwischengespeichert, sodass Sie sich normalerweise nicht erneut anmelden müssen.
• Anforderungen: 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 am 15.04.2026 eingestellt.

Starten Sie die CLI und folgen Sie dem Browser-Ablauf:

qwen

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

💳 Option 2: Alibaba Cloud Coding Plan

Verwenden Sie diese Option, wenn Sie vorhersagbare Kosten mit verschiedenen Modelloptionen und höheren Nutzungskontingenten wünschen.

• Funktionsweise: Abonnieren Sie den Coding Plan zu einem festen monatlichen Preis und konfigurieren Sie dann Qwen Code, um den dedizierten Endpunkt und Ihren Abonnement-API-Key zu verwenden.
• Anforderungen: Besorgen Sie sich ein aktives Coding Plan-Abonnement über Alibaba Cloud ModelStudio (Peking)  oder Alibaba Cloud ModelStudio (intl) , je nach Region Ihres Kontos.
• Vorteile: Verschiedene Modelloptionen, höhere Nutzungskontingente, vorhersagbare 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: Peking  intl .

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

Interaktive Einrichtung

Geben Sie qwen im Terminal ein, um Qwen Code zu starten, führen Sie dann den Befehl /auth aus, wählen Sie Alibaba ModelStudio und dann Coding Plan aus dem Untermenü. Wählen Sie Ihre Region aus und geben Sie Ihren sk-sp-xxxxxxxxx-Key ein.

Verwenden Sie nach der Authentifizierung den Befehl /model, um zwischen allen von 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

Konfigurieren Sie den Coding Plan für CI, Container oder Skripte mit Umgebungsvariablen oder settings.json anstelle des entfernten Befehls qwen auth coding-plan.

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"

Verwenden Sie https://coding.dashscope.aliyuncs.com/v1 für den Endpunkt in China (Peking) oder https://coding-intl.dashscope.aliyuncs.com/v1 für den internationalen Endpunkt.

Alternative: Konfiguration über settings.json

Wenn Sie den interaktiven /auth-Ablauf überspringen möchten, fügen Sie Folgendes zu ~/.qwen/settings.json hinzu:

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "id": "qwen3-coder-plus",
          "name": "qwen3-coder-plus (Coding Plan)",
          "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
          "description": "qwen3-coder-plus von 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)

Verwenden Sie diese Option, wenn Sie eine Verbindung zu Drittanbieter-Providern wie OpenAI, Anthropic, Google, Azure OpenAI, OpenRouter, Requesty, ModelScope oder einem selbst gehosteten Endpunkt herstellen möchten. Unterstützt mehrere Protokolle und Anbieter.

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

Der einfachste Weg, mit der API-Key-Authentifizierung zu beginnen, ist, alles in eine einzige Datei ~/.qwen/settings.json zu packen. Hier ist ein vollständiges, sofort einsatzbereites Beispiel:

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "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"
  }
}

Was jedes Feld bewirkt:

Nachdem Sie die Datei gespeichert haben, führen Sie einfach qwen aus – kein interaktiver /auth-Ablauf erforderlich.

Das Schlüsselkonzept sind die Model Providers (modelProviders): Qwen Code unterstützt mehrere API-Protokolle, nicht nur OpenAI. Sie konfigurieren, welche Anbieter und Modelle verfügbar sind, indem Sie ~/.qwen/settings.json bearbeiten, und wechseln dann zur Laufzeit mit dem Befehl /model zwischen ihnen.

Unterstützte Protokolle

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

Definieren Sie, welche Modelle für jedes Protokoll verfügbar sind. Jeder Modelleintrag benötigt mindestens eine id; envKey (der Name der Umgebungsvariable, die Ihren API-Key enthält) ist optional und empfohlen – wenn er weggelassen wird, wird auf den Standard-Env-Key des Authentifizierungstyps zurückgegriffen (z.B. OPENAI_API_KEY für openai).

Bearbeiten Sie ~/.qwen/settings.json (erstellen Sie sie, falls sie nicht existiert). Sie können mehrere Protokolle in einer einzigen Datei mischen – hier ein Multi-Provider-Beispiel, das nur den modelProviders-Abschnitt zeigt:

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "id": "gpt-4o",
          "name": "GPT-4o",
          "envKey": "OPENAI_API_KEY",
          "baseUrl": "https://api.openai.com/v1"
        }
      ]
    },
    "anthropic": {
      "protocol": "anthropic",
      "models": [
        {
          "id": "claude-sonnet-4-20250514",
          "name": "Claude Sonnet 4",
          "envKey": "ANTHROPIC_API_KEY"
        }
      ]
    },
    "gemini": {
      "protocol": "gemini",
      "models": [
        {
          "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 finden Sie in der Model Providers Referenz.

Schritt 2: Umgebungsvariablen setzen

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

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

Setzen Sie sie direkt in Ihrem 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 nicht bereits in process.env vorhanden sind, werden geladen.

Suchreihenfolge (vom aktuellen Verzeichnis aus aufwärts zum /):

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

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

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

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

Sie können API-Keys auch direkt in ~/.qwen/settings.json unter dem env-Schlüssel definieren. Diese werden als Fallback mit niedrigster Priorität geladen – 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-File-Setup-Beispiel oben verwendet wird. Es ist praktisch, alles an einem Ort zu haben, aber denken Sie daran, dass settings.json möglicherweise geteilt oder synchronisiert wird – bevorzugen Sie .env-Dateien für vertrauliche Geheimnisse.

Prioritätsübersicht:

Schritt 3: Modelle mit /model wechseln

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

/model

Der Auswahldialog zeigt alle Modelle aus Ihrer modelProviders-Konfiguration, gruppiert nach ihrem Protokoll (z.B. openai, anthropic, gemini). Ihre Auswahl wird über Sitzungen hinweg beibehalten.

Sie können Modelle auch direkt mit einem Kommandozeilenargument wechseln, was praktisch ist, wenn Sie mit mehreren Terminals arbeiten.

# 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 CLI-Befehl qwen auth wurde entfernt. Verwenden Sie stattdessen diese Ersatzlösungen:

Legacy-Aufrufe wie qwen auth status geben nun einen Entfernungs-Hinweis mit diesen Migrationspfaden aus.

Sicherheitshinweise

• Keys nicht in die Versionskontrolle einchecken.
• Bevorzugen Sie .qwen/.env für projektspezifische Geheimnisse (und halten Sie diese aus Git heraus).
• Behandeln Sie Ihre Terminalausgabe als sensibel, wenn sie Anmeldedaten zur Überprüfung ausgibt.