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

Erfahren Sie, wie Sie Qwen Code CLI, den Open-Source-AI-Coding-Agent für Ihr Terminal, installieren. Schritt-für-Schritt-Anleitungen für npm, Schnellinstallationsskript, Homebrew und Fehlerbehebung auf Windows, macOS und Linux.

Canonical URL: https://a2a-mcp.org/blog/qwen-cli-install-de

Language: de

Published: 2026-04-07

Updated: 2026-04-07

## 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](https://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**:

```bash
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
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"
```

**Windows (Eingabeaufforderung als Administrator ausführen)**:

```cmd
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:

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

Dies installiert den Befehl `qwen` global.

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

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

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

```bash
brew install qwen-code
```

## Schritt 4: Die Installation überprüfen

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

```bash
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:

```bash
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:

```bash
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:

```bash
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!