Qwen CLI: So installieren und verwenden Sie Qwen Code (2026)

TL;DR

• Qwen CLI (offiziell Qwen Code) ist Alibabas Open-Source-Terminal-Coding-Agent — ein Fork von Gemini CLI, der auf Qwen-Modelle abgestimmt ist. Installiere ihn mit npm install -g @qwen-code/qwen-code@latest unter Node.js 22+.
• Die große Änderung, die die meisten Anleitungen übersehen: Die kostenlose Qwen-OAuth-Stufe wurde am 2026-04-15 eingestellt. Die alten „2,000 kostenlosen Anfragen pro Tag“ funktionieren nicht mehr — du brauchst jetzt einen API-Anbieter.
• Richte es ein, indem du es mit drei Umgebungsvariablen auf einen beliebigen OpenAI-kompatiblen Endpunkt verweist: OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MODEL. Das ist die gesamte Konfiguration.
• Ein Endpunkt kann Qwen *und* andere Modelle ausführen. Setze OPENAI_BASE_URL auf [Velokey](https://api.velokey.ai), und du kannst Qwen Code mit qwen3.7-max, GPT, Claude oder GLM über einen einzigen Schlüssel steuern.

Was ist Qwen CLI (Qwen Code)?

Qwen CLI ist der gebräuchliche Name für Qwen Code, einen Open-Source-KI-Coding-Agent, der in deinem Terminal läuft und vom Qwen-Team bei Alibaba entwickelt wurde. Er liest und bearbeitet deine Codebasis, führt Befehle aus und arbeitet agentisch an Aufgaben — in derselben Form wie Claude Code oder Gemini CLI. Tatsächlich begann er als Fork von Gemini CLI, angepasst mit Prompts und Parsern, die auf Qwens Modelle abgestimmt sind.

Zwei Dinge solltest du wissen, bevor du installierst. Erstens heißt das Paket @qwen-code/qwen-code, daher verweisen „qwen cli“, „qwen-cli“ und „qwen code cli“ alle auf dasselbe Tool. Zweitens — und das bringt viele durcheinander — ist es nicht an Qwens Server gebunden. Es spricht das OpenAI-kompatible Protokoll, sodass du es gegen Qwens API, OpenRouter, ein lokales Modell oder ein Gateway laufen lassen kannst. Das ist jetzt wichtiger denn je, weil sich der kostenlose Weg geändert hat.

Wie installiere ich Qwen Code CLI?

Installiere Qwen Code global mit npm, unter Node.js 22 oder neuer:

npm install -g @qwen-code/qwen-code@latest
qwen --version

Wenn du macOS nutzt, funktioniert auch Homebrew (brew install qwen-code), und es gibt eigenständige Installer für Linux und Windows. Darauf kommt es bei der Installation wirklich an:

Wenn nach der Installation qwen: command not found erscheint, befindet sich dein globales npm-Bin-Verzeichnis nicht in deinem PATH — führe npm config get prefix aus und füge dessen /bin zu PATH hinzu. Unter Linux bedeutet ein Berechtigungsfehler während der globalen Installation normalerweise, dass du sudo brauchst oder, besser, ein nvm-verwaltetes Node, damit globale Installationen keine Systemverzeichnisse berühren.

Wie richte ich Qwen CLI ein, nachdem die kostenlose Stufe weggefallen ist?

Du konfigurierst Qwen Code mit einem OpenAI-kompatiblen API-Schlüssel, weil die kostenlose Qwen-OAuth-Stufe am [2026-04-15 eingestellt wurde](https://github.com/QwenLM/qwen-code/issues/3203) — zwischengespeicherte Tokens können noch eine Weile bestehen bleiben, aber neue Anmeldungen werden abgelehnt. Diese kostenlose Stufe bot früher 2,000 Anfragen pro Tag und 60 pro Minute; viele Tutorials zu „Qwen Code kostenlos nutzen“ beschreiben sie noch immer, und sie sind jetzt falsch.

Die aktuelle Einrichtung besteht aus drei Umgebungsvariablen. Setze sie, führe qwen aus und wähle im Authentifizierungsmenü „OpenAI“:

export OPENAI_API_KEY="your_api_key"
export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"
qwen

Bevorzugst du eine Konfigurationsdatei? Qwen Code liest ~/.qwen/settings.json (oder eine projektlokale .qwen/settings.json), in der du einen Modellanbieter einmal definierst:

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [{
        "id": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      }]
    }
  },
  "security": { "auth": { "selectedType": "openai" } }
}

Deine Anbieteroptionen sind heute Alibabas ModelStudio Coding Plan (ein festes Monatsabonnement), die DashScope-Pay-per-Token-API, OpenRouter, Fireworks oder jeder andere OpenAI-kompatible Endpunkt. Die offiziellen Authentifizierungsdokumente listen den aktuellen Stand auf — prüfe sie statt eines alten Blogs, denn genau dieser Teil ist veraltet.

Wie führe ich Qwen CLI mit jedem Modell über einen Endpunkt aus?

Setze OPENAI_BASE_URL auf ein Gateway, und ein Schlüssel lässt Qwen Code gegen viele Modelle laufen — ohne Konten bei einzelnen Anbietern jonglieren zu müssen. Da Qwen Code nur einen OpenAI-kompatiblen Endpunkt benötigt, funktioniert Velokey als Drop-in: Ein Schlüssel erreicht Qwen, GPT, Claude und GLM über dieselbe Basis-URL.

export OPENAI_API_KEY="sk-your-velokey-key"
export OPENAI_BASE_URL="https://api.velokey.ai/v1"
export OPENAI_MODEL="qwen3.7-max"
qwen

Der praktische Vorteil ist das Wechseln von Backends ohne erneute Authentifizierung. Qwen Code ist auf Qwen-Modelle abgestimmt, daher ist [qwen3.7-max](/model/qwen3.7-max) die natürliche Standardeinstellung — aber wenn eine Aufgabe ein anderes Modell braucht, ändere eine Variable:

Da die Abrechnung pro Token über Credits erfolgt, gibt es kein separates Abonnement und keine tägliche Anfragegrenze — du zahlst für das, was der Agent tatsächlich nutzt. Wie diese Rechnung aufgeht, erklären wir in unserem Claude-API-Preisleitfaden; dasselbe Pro-Token-Modell gilt für Qwen und den Rest.

Warum funktioniert Qwen CLI nicht? Häufige Fehler

Die meisten Qwen-CLI-Fehler sind Umgebungs- oder Authentifizierungsprobleme, keine Bugs — und sie lassen sich auf eine Handvoll Ursachen eingrenzen. Starte qwen --safe-mode, um deine Anpassungen zu deaktivieren; wenn das Problem verschwindet, aktiviere die Einstellungen nacheinander wieder, um den Verursacher zu finden.

Wenn dein Schlüssel in einem browserbasierten Tool statt in einer Umgebungsvariable gespeichert ist, kann eine fehlende Sitzung eine separate Fehlerklasse auslösen — siehe unseren Leitfaden zum Beheben von „API key not found in cookies“. Für eine vollständige End-to-End-Anleitung zum Einbinden eines API-Schlüssels in einen Client behandelt wie man ein Modell mit einem API-Schlüssel aufruft das Einrichtungsmuster.

Häufig gestellte Fragen

Wie installiere ich Qwen CLI?

Führe npm install -g @qwen-code/qwen-code@latest unter Node.js 22 oder neuer aus, dann qwen --version zur Bestätigung. Unter macOS kannst du auch brew install qwen-code verwenden. Wenn du command not found erhältst, füge dein globales npm-Bin-Verzeichnis (npm config get prefix + /bin) zu deinem PATH hinzu.

Ist Qwen CLI kostenlos nutzbar?

Nicht mehr über den eingebauten Weg — die kostenlose Qwen-OAuth-Stufe wurde am 2026-04-15 eingestellt. Die CLI selbst ist Open Source und kostenlos, aber du brauchst jetzt einen API-Anbieter: Alibabas ModelStudio Coding Plan, DashScope Pay-per-Token, OpenRouter oder einen beliebigen OpenAI-kompatiblen Endpunkt, der mit deinem eigenen Schlüssel konfiguriert ist.

Wie verwende ich Qwen CLI mit meinem eigenen API-Schlüssel?

Setze drei Umgebungsvariablen — OPENAI_API_KEY, OPENAI_BASE_URL und OPENAI_MODEL — führe dann qwen aus und wähle im Authentifizierungsmenü „OpenAI“. Du kannst auch einen Anbieter in ~/.qwen/settings.json definieren. Die Basis-URL verweist auf den OpenAI-kompatiblen Anbieter, den du verwendest.

Welche Modelle unterstützt Qwen Code CLI?

Qwen Code ist auf Qwen-Modelle wie Qwen3-Coder abgestimmt, aber da es das OpenAI-kompatible Protokoll spricht, läuft es gegen OpenAI, Anthropic, Gemini, OpenRouter, lokale Modelle über Ollama oder vLLM und Gateways. Setze OPENAI_MODEL auf die Modell-ID, die dein Anbieter bereitstellt.

Warum sagt Qwen CLI „command not found“?

Dein globales npm-Bin-Verzeichnis befindet sich nicht in deinem PATH. Führe npm config get prefix aus, um das Installationspräfix zu finden, füge dann dessen Unterordner /bin zu deinem PATH hinzu und starte deine Shell neu. Das ist der häufigste Fehler nach der Installation und hat nichts mit dem Tool selbst zu tun.

Kann ich Qwen CLI gegen ein Gateway statt gegen Qwens API laufen lassen?

Ja. Qwen Code akzeptiert jeden OpenAI-kompatiblen Endpunkt, sodass du OPENAI_BASE_URL auf ein Gateway setzen und mehrere Modelle mit einem Schlüssel erreichen kannst. Setze OPENAI_MODEL auf das gewünschte Modell — ein Qwen-Modell für die beste Tool-Calling-Treue oder ein anderes Modell je nach Aufgabe.