Qwen Code CLI Installationsleitfaden: Schnelle Einrichtung für Windows, macOS & Linux (2026)

Voraussetzungen

Bevor Sie Qwen Code CLI (den offiziellen terminalbasierten KI-Codierungsagenten, basierend auf Qwen-Modellen) installieren, stellen Sie Folgendes sicher:

Node.js Version 20 oder höher (empfohlen: neueste LTS). Download unter nodejs.org.
Ein Terminal oder eine Eingabeaufforderung mit Administratorrechten unter Windows.
Internetverbindung zum Herunterladen von Paketen und Modellen.
Optional, aber empfohlen: Git (für manuelle Installation aus den Quellen) und Homebrew auf macOS/Linux.

Node.js-Installation überprüfen:

node --version
npm --version

Die erwartete Ausgabe zeigt Versionen wie v20.x.x oder höher an.

Schritt 1: Wählen Sie Ihre Installationsmethode

Qwen Code CLI bietet mehrere Installationspfade. Das schnelle Installationsskript wird für die meisten Benutzer empfohlen, da es Abhängigkeiten automatisch verwaltet.

Schnellinstallation (Empfohlen)

Linux / macOS:

bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"

Windows (Eingabeaufforderung als Administrator ausführen):

curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat

Nach der Ausführung starten Sie Ihr Terminal neu, um die PATH-Variable zu aktualisieren.

Schritt 2: Manuelle Installation über npm

Wenn Sie lieber manuelle Kontrolle haben möchten:

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

Dies installiert den Befehl qwen global.

Unter macOS/Linux mit sudo (falls Berechtigungsprobleme auftreten):

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

Schritt Number 3: Installation über Homebrew (macOS & Linux)

brew install qwen-code

Schritt 4: Die Installation überprüfen

Führen Sie den folgenden Befehl aus, um eine erfolgreiche Installation zu bestätigen:

qwen --version

Sie sollten eine Ausgabe ähnlich wie diese sehen:

Qwen Code CLI v0.x.x

Schritt 5: Erster Start und Authentifizierung

Starten Sie die interaktive CLI:

qwen

Bei der ersten Ausführung fordert die CLI Sie auf, sich mit Ihrem Qwen-Konto zu authentifizieren (öffnet den Browser für eine Klick-Login). Nach dem Anmelden werden die Standardeinstellungen angewendet und die interaktive Terminal-Oberfläche wird betreten.

Für die besten Ergebnisse navigieren Sie zuerst in Ihr Projektverzeichnis:

cd /path/to/your/project
qwen

Innerhalb der Sitzung verwenden Sie Befehle wie /help, /model, um Modelle zu wechseln, oder referenzieren Sie Dateien mit @dateiname.

Schritt 6: Manuelle Installation aus den Quellen (Für Fortgeschrittene)

Für Entwickler, die die neuesten unveröffentlichten Änderungen wünschen:

git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code
npm install
npm install -g .

Überprüfen Sie anschließend mit qwen --version.

Häufige Probleme & Fehlerbehebung

Befehl 'qwen' nicht gefunden: Starten Sie Ihr Terminal neu oder führen Sie hash -r (Linux/macOS) aus. Unter Windows schließen und öffnen Sie die Eingabeaufforderung neu. Stellen Sie sicher, dass das Node.js globale bin-Verzeichnis in Ihrem PATH enthalten ist.
Berechtigungsfehler während npm install: Verwenden Sie sudo unter Linux/macOS oder führen Sie die Eingabeaufforderung als Administrator unter Windows aus.
Node.js Version zu alt: Aktualisieren Sie auf Node 20+ mit nvm oder dem offiziellen Installer.
Netzwerkprobleme mit Aliyun-Assets: Versuchen Sie die npm-Methode als Fallback.
Installation scheitert auf Termux oder bestimmten Linux-Distributionen: Verwenden Sie das Flag --ignore-scripts: npm install -g @qwen-code/qwen-code@latest --ignore-scripts.
Authentifizierung funktioniert nicht: Stellen Sie sicher, dass Ihr Browser Pop-ups erlaubt und Sie ein gültiges Qwen-Konto haben.

Bei anhaltenden Problemen, überprüfen Sie das offizielle GitHub-Repository: https://github.com/QwenLM/qwen-code.

Nächste Schritte

Erkunden Sie die interaktive Benutzeroberfläche: Geben Sie /help für verfügbare Slash-Befehle ein.
Testen Sie agentenbasiertes Programmieren: Bitten Sie die CLI, Code umzustrukturieren, Dateien zu erklären oder Aufgaben mit natürlicher Sprache zu automatisieren.
Modelle konfigurieren: Verwenden Sie /model, um Qwen3-Coder oder andere unterstützte Backends (einschließlich lokales Ollama) auszuwählen.
Mit VS Code integrieren: Installieren Sie die Qwen Code Companion-Erweiterung für nahtlose Editor-Integration.
Einstellungen anpassen: Bearbeiten Sie ~/.qwen/settings.json für Themen, Standardmodelle und erweiterte Optionen.

Jetzt sind Sie bereit, die Qwen Code CLI als leistungsstarken KI-Paarprogrammierer direkt in Ihrem Terminal zu nutzen. Beginnen Sie mit einfachen Aufforderungen wie "Erkläre dieses Codebase" oder "Refaktorisiere diese Funktion für bessere Leistung" in Ihrem Projektordner.

Viel Spaß beim Programmieren!