Wie man Qwen Code CLI installiert: Schritt-für-Schritt-Anleitung für den Terminal-AI-Coding-Agent

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!