Authentifizierung

Qwen Code unterstützt drei Authentifizierungsmethoden. Wählen Sie diejenige aus, die am besten zu Ihrer gewünschten CLI-Nutzung passt:

• Qwen OAuth: Melden Sie sich mit Ihrem qwen.ai-Konto in einem Browser an. Kostenlos mit täglichem Kontingent.
• Alibaba Cloud Coding-Plan: Verwenden Sie einen API-Schlüssel von Alibaba Cloud. Bezahltes Abonnement mit vielfältigen Modell-Optionen und höheren Kontingenten.
• API-Schlüssel: Verwenden Sie Ihren eigenen API-Schlüssel. Flexibel nach Ihren individuellen Anforderungen – unterstützt OpenAI, Anthropic, Gemini und andere kompatible Endpunkte.

Option 1: Qwen-OAuth (kostenlos)

Verwenden Sie diese Methode, wenn Sie die einfachste Einrichtung wünschen und Qwen-Modelle nutzen.

• Funktionsweise: Beim ersten Start öffnet Qwen Code eine Browser-Anmeldeseite. Nach Abschluss des Anmeldevorgangs werden Ihre Anmeldedaten lokal zwischengespeichert, sodass Sie sich in der Regel nicht erneut anmelden müssen.
• Voraussetzungen: Ein qwen.ai-Konto sowie Internetzugang (mindestens für die erste Anmeldung).
• Vorteile: Kein manuelles Management von API-Schlüsseln, automatische Aktualisierung der Anmeldedaten.
• Kosten & Kontingent: Kostenlos mit einem Kontingent von 60 Anfragen/Minute und 1.000 Anfragen/Tag.

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

qwen

💳 Option 2: Alibaba Cloud-Coding-Plan

Wählen Sie diese Option, wenn Sie vorhersehbare Kosten, eine breite Auswahl an Modellen und höhere Nutzungsquoten wünschen.

• Funktionsweise: Abonnieren Sie das Coding-Plan mit einer festen monatlichen Gebühr und konfigurieren Sie anschließend Qwen Code für die Nutzung des dedizierten Endpunkts sowie Ihres Abonnement-API-Schlüssels.
• Voraussetzungen: Erwerben Sie ein aktives Coding-Plan-Abonnement über Aliyun Bailian  oder Alibaba Cloud , je nach Region Ihres Kontos.
• Vorteile: Breite Modellauswahl, höhere Nutzungsquoten, vorhersehbare monatliche Kosten sowie Zugriff auf eine große Bandbreite an Modellen (Qwen, GLM, Kimi, Minimax u. a.).
• Kosten & Quoten: Siehe Dokumentation zum Aliyun Bailian-Coding-Plan .

Das 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 und wählen Sie Alibaba Cloud Coding Plan. Wählen Sie Ihre Region aus und geben Sie Ihren Schlüssel sk-sp-xxxxxxxxx ein.

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

Alternative: Konfiguration über settings.json

Falls Sie den interaktiven /auth-Ablauf überspringen möchten, fügen Sie 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 aus dem 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-Schlüssel (flexibel)

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

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

Der einfachste Einstieg in die API-Schlüssel-Authentifizierung besteht darin, alle Einstellungen in einer einzigen Datei ~/.qwen/settings.json 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 über Dashscope",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-xxxxxxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

Funktion der einzelnen Felder:

Nachdem Sie die Datei gespeichert haben, führen Sie einfach qwen aus – eine interaktive /auth-Einrichtung ist nicht erforderlich.

Das zentrale Konzept sind Modellanbieter (modelProviders): Qwen Code unterstützt mehrere API-Protokolle, nicht nur OpenAI. Sie konfigurieren verfügbare Anbieter und Modelle durch Bearbeitung von ~/.qwen/settings.json und wechseln zur Laufzeit mit dem Befehl /model zwischen ihnen.

Unterstützte Protokolle

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

Definieren Sie, welche Modelle für jedes Protokoll verfügbar sind. Jeder Modelleintrag erfordert mindestens eine id und eine envKey (der Name der Umgebungsvariablen, die Ihren API-Schlüssel enthält).

Bearbeiten Sie ~/.qwen/settings.json (erstellen Sie die Datei ggf. neu). Sie können mehrere Protokolle in einer einzigen Datei kombinieren – hier ist ein Beispiel mit mehreren Anbietern, das ausschließlich den Abschnitt modelProviders 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"
      }
    ]
  }
}

Felder von ModelConfig (jeder Eintrag innerhalb von modelProviders):

Für das vollständige Schema von modelProviders sowie erweiterte Optionen wie generationConfig, customHeaders und extra_body siehe Referenz zu Modellanbietern.

Schritt 2: Umgebungsvariablen festlegen

Qwen Code liest API-Schlüssel aus Umgebungsvariablen (angegeben durch envKey in Ihrer Modellkonfiguration) ein. Es gibt mehrere Möglichkeiten, diese bereitzustellen – im Folgenden aufgelistet von höchster bis niedrigster Priorität:

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

Festlegen direkt in Ihrer Shell-Profil-Datei (~/.zshrc, ~/.bashrc, etc.) 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 aus mehreren Dateien zusammengeführt). Es werden nur Variablen geladen, die noch nicht in process.env vorhanden sind.

Suchreihenfolge (ausgehend vom aktuellen Verzeichnis, aufwärts bis /):

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

Wird keine Datei gefunden, wird als Fallback das Home-Verzeichnis verwendet:

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

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

Sie können API-Schlüssel auch direkt in ~/.qwen/settings.json unter dem Schlüssel env definieren. Diese werden als Fallback mit niedrigster Priorität geladen – sie greifen nur, wenn eine Variable weder durch die Systemumgebung noch durch .env-Dateien bereits gesetzt wurde.

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

Dies ist der Ansatz, der im obigen Beispiel für die Ein-Datei-Einrichtung verwendet wird. Er bietet den Vorteil, alle Einstellungen an einem Ort zu halten; beachten Sie jedoch, dass settings.json möglicherweise gemeinsam genutzt oder synchronisiert wird – für sensible Geheimnisse bevorzugen Sie .env-Dateien.

Zusammenfassung der Prioritäten:

Schritt 3: Modelle mit /model wechseln

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

/model

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

Sie können Modelle auch direkt über ein Kommandozeilenargument wechseln – praktisch, wenn Sie mit mehreren Terminals arbeiten.

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

Sicherheitshinweise

• Übertragen Sie keine API-Schlüssel in Versionskontrollsysteme.
• Verwenden Sie vorzugsweise .qwen/.env für projektspezifische Geheimnisse (und stellen Sie sicher, dass diese Datei nicht in Git landet).
• Behandeln Sie die Ausgabe Ihres Terminals als vertraulich, falls darin Anmeldeinformationen zur Überprüfung angezeigt werden.