Qwen Code begann als Projekt auf Basis von Googles Gemini CLI, und heute hat es auf GitHub selbst mehr als 30.000 Sterne. Laut README basierte das Projekt ursprünglich auf Gemini CLI v0.8.2, hörte ab v0.1 auf, sich mit dem Upstream zu synchronisieren, und wurde zu einem eigenständigen Coding-Agenten mit mehreren Protokollen.
Das Wichtigste in Kürze
- Qwen Code ist ein Open-Source-Coding-Agent unter Apache-2.0 für das Terminal, der als Fork von Gemini CLI begann.
- Installiere ihn mit dem eigenständigen Skript, über npm mit Node.js 22 oder neuer oder über Homebrew und führe dann /auth aus, um ein Modell zu verbinden.
- Keine Anmeldeoption wird als kostenlos beschrieben. Für null Kosten nutzt du einen lokalen Ollama-, vLLM- oder LM-Studio-Server.
- Starte bei neuen Codebasen im schreibgeschützten Plan Mode, prüfe Änderungen mit /diff und mach sie mit /restore rückgängig.
Diese Anleitung zeigt, wie du Qwen Code installierst, dich anmeldest (oder es auf ein kostenloses lokales Modell richtest) und es sicher in einem echten Projekt einsetzt. Alles hier stammt aus dem README und der Dokumentation des Projekts auf GitHub, geprüft am 15. November 2026. Keiner der Befehle wurde für diesen Artikel ausgeführt, probier sie also zuerst in einem Wegwerf-Ordner aus.
Was du brauchst
- Ein Terminal unter macOS, Linux oder Windows
- Node.js 22 oder neuer, wenn du den Weg über npm wählst
- Ein Code-Projekt, auf das du es loslässt (ideal ist ein Ersatz-Repo)
- Eine Möglichkeit, ein Modell zu bezahlen oder selbst zu hosten: ein Qwen-Abo, ein API-Schlüssel oder ein lokaler Modellserver

Was Qwen Code ist
Es ist ein Open-Source-Coding-Agent, der in deinem Terminal läuft, dein Repo liest, Dateien bearbeitet und Befehle ausführt. GitHub nennt Apache-2.0 als Lizenz, und laut README funktioniert er mit den APIs von OpenAI, Anthropic, Gemini und Qwen sowie mit jedem Drittanbieter oder lokalen Modell wie Ollama oder vLLM. Stand 15. November 2026 ist das neueste Release-Tag v0.27.4.
Das Projekt veröffentlicht auch einen eigenen Benchmark: Auf SWE-bench Verified erreichten sieben Qwen-Code-Versionen mit demselben Modell Qwen 3.7 Max Durchschnittswerte zwischen 76,40 % und 77,80 %. Das ist die Auswertung der Maintainer, kein unabhängiger Test.
In Zahlen
30.000GitHub-Sterne, mehr als
77,80 %bester selbst gemeldeter SWE-bench-Schnitt
v0.27.4neuestes Release-Tag
Schritt für Schritt
1. Installieren
Das README nennt drei Wege. Der erste ist ein Einzeiler-Installer für Linux und macOS:
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
Ein Skript direkt in deine Shell zu leiten, ist eine Vertrauensfrage. Der Installer liegt auf einer Speicheradresse von Alibaba Cloud. Wenn dir das lieber ist, nimm stattdessen npm oder Homebrew:
npm install -g @qwen-code/qwen-code@latest
Oder unter macOS und Linux mit Homebrew:
brew install qwen-code
Für Windows gibt es im README einen PowerShell-Installer. Starte nach einer eigenständigen Installation dein Terminal neu, damit die Umgebungsvariablen wirksam werden.
2. In einem Projekt starten
cd ~/projects/my-app
qwen
Du solltest eine interaktive Terminal-Sitzung sehen. Das README erwähnt auch einen Branch „1.0 Preview“, die Anleitung hier gilt aber für die Hauptversion.
3. Anmelden oder ein Modell verbinden
Tippe /auth. Die Dokumentation nennt fünf Hauptoptionen:
- Qwen Account with Subscription: Anmeldung im Browser mit einem Plus- oder Pro-Abo.
- QwenCloud: ein Token Plan oder ein nutzungsbasierter Standard API Key.
- Alibaba ModelStudio: Coding Plan, Token Plan oder Standard API Key.
- Third-party Providers: eine eingebaute Liste mit unter anderem DeepSeek, Kimi und OpenRouter, über einen API-Schlüssel.
- Custom Provider: ein lokaler Server, ein Proxy oder ein nicht unterstützter Anbieter.
Keine dieser Optionen wird in der aktuellen Dokumentation als kostenlos beschrieben. Um bei null Kosten zu bleiben, nutze ein lokales Modell. Laut Dokumentation funktionieren Ollama, vLLM und LM Studio über eine OpenAI-kompatible Adresse. Unsere Anleitung zum Ausführen eines KI-Modells mit Ollama deckt die Serverseite ab. Speichere dann eine Konfiguration unter ~/.qwen/settings.json, angelehnt an das Beispiel aus der Dokumentation:
{
"env": { "OLLAMA_API_KEY": "ollama" },
"modelProviders": {
"openai": [
{
"id": "your-model-name",
"name": "My local model",
"envKey": "OLLAMA_API_KEY",
"baseUrl": "http://localhost:11434/v1"
}
]
},
"security": { "auth": { "selectedType": "openai" } },
"model": { "name": "your-model-name" }
}
Ersetze your-model-name durch den genauen Modellnamen, den dein Server meldet. Laut Dokumentation muss model.name mit einem der id-Werte übereinstimmen. Führe nach dem Speichern qwen aus.
4. Die erste Frage stellen
Das README empfiehlt, mit einem sicheren, rein lesenden Prompt zu beginnen:
Explain this repository and show me where to start.
Führe dann /init aus. Laut Dokumentation analysiert der Befehl das aktuelle Verzeichnis und erstellt eine erste Kontextdatei. Qwen Code lädt deine Briefings QWEN.md und AGENTS.md automatisch. Wenn du schon Skill-Dateien nutzt, erklärt unsere Anleitung zu Agent Skills in Claude Code das Prinzip, und Qwen Code führt in der Dokumentation ein eigenes /skills-Panel auf.
5. Festlegen, wie viel Freiheit er bekommt
Qwen Code hat fünf Berechtigungsmodi: Plan, Ask Permissions, Auto-Edit, Auto und YOLO. Mit Shift+Tab (unter Windows Tab) wechselst du durch sie. Die Dokumentation nennt Auto, bei dem ein Klassifikator sichere Aktionen freigibt und riskante blockiert, den Standard ab Werk, dieselbe Seite nennt aber auch Ask Permissions als Anfangsmodus. Schau also in die Statusleiste. Für eine neue Codebasis startest du im Plan Mode:
/plan refactor the settings page
Plan Mode ist schreibgeschützt, es wird also nichts bearbeitet oder ausgeführt. Tippe /plan exit, um zu deinem vorherigen Modus zurückzukehren. Heb dir YOLO für vertrauenswürdige Projekte auf, wie es die Dokumentation rät.
6. Prüfen und rückgängig machen
Mit /diff öffnest du eine interaktive Ansicht der nicht committeten Änderungen. Ist ein Schritt schiefgegangen, listet /restore Checkpoints auf und setzt die Projektdateien auf den Stand vor dem Aufruf eines Tools zurück.
7. In Skripten nutzen
Laut README läuft der Headless-Modus aus Skripten und CI heraus:
qwen -p "Summarize the repository layout."

Häufige Fehler und Lösungen
qwen: command not found. Starte dein Terminal nach der Installation neu, wie es das README vorgibt. Bei npm prüfst du, ob Node.js Version 22 oder neuer ist.- Die Anmeldung im Browser klappt nicht. In CI oder unbeaufsichtigten Containern empfiehlt die Auth-Dokumentation stattdessen eine Methode mit API-Schlüssel über Umgebungsvariablen.
qwen authbringt nichts. Dieser Befehl wurde entfernt. Führeqwenaus und dann/auth. Mit/doctorprüfst du deine aktuelle Authentifizierung.- Das lokale Modell läuft in einen Timeout. Prüfe, ob die
baseUrlauf/v1endet und der Server läuft. Für langsame Server beschreibt die Dokumentation die EinstellungstreamIdleTimeoutMs. - Unsicher, ob der Daemon sicher ist. Wenn du
qwen serveoderqwen daemon startnutzt: Laut README lauscht er standardmäßig auf Loopback ohne Bearer-Authentifizierung, sodass jeder lokale Prozess, der ihn erreicht, die volle API nutzen kann, einschließlich Code-Ausführung. Auf geteilten Hosts setzt duQWEN_SERVER_TOKENund nutzt--require-auth.
Schon gewusst?
Standardmäßig lauscht der Daemon qwen serve auf Loopback ohne Bearer-Authentifizierung, sodass jeder lokale Prozess, der ihn erreicht, die volle API nutzen kann, einschließlich Code-Ausführung. Setze auf geteilten Hosts QWEN_SERVER_TOKEN und nutze –require-auth.
Lohnt sich ein Test?
Wenn dir der Workflow von Claude Code oder Gemini CLI gefällt und du etwas willst, das du auf dein eigenes Modell richten kannst, ist Qwen Code nur eine kurze Installation entfernt. Starte im Plan Mode, halte einen Git-Commit bereit und betrachte die Benchmark-Werte als Angaben der Maintainer, bis du es selbst ausprobiert hast.
Häufige Fragen
Ist Qwen Code kostenlos?
Das Tool selbst ist Open Source unter Apache-2.0, aber keine der Anmeldeoptionen von /auth wird in der aktuellen Dokumentation als kostenlos beschrieben. Um bei null Kosten zu bleiben, verbinde es über Ollama, vLLM oder LM Studio mit einem lokalen Modell.
Wie installiere ich Qwen Code?
Das README nennt drei Wege: einen eigenständigen Einzeiler-Installer für Linux und macOS, npm install -g @qwen-code/qwen-code@latest mit Node.js 22 oder neuer oder brew install qwen-code. Für Windows gibt es einen PowerShell-Installer. Starte danach dein Terminal neu.
Kann Qwen Code ein lokales Modell mit Ollama nutzen?
Ja. Speichere eine ~/.qwen/settings.json, die einen OpenAI-kompatiblen Anbieter auf http://localhost:11434/v1 richtet, und achte darauf, dass model.name mit einem der id-Werte des Anbieters übereinstimmt. Führe dann qwen aus.
Was ist der Plan Mode in Qwen Code?
Plan Mode ist einer von fünf Berechtigungsmodi und schreibgeschützt, es wird also nichts bearbeitet oder ausgeführt. Starte ihn mit /plan gefolgt von deiner Aufgabe und tippe /plan exit, um zu deinem vorherigen Modus zurückzukehren.
Kurzes Quiz
Auf welchem Projekt basierte Qwen Code ursprünglich?
- Claude Code
- Gemini CLI
- Ollama
Laut README basierte es ursprünglich auf Gemini CLI v0.8.2.
Welcher Modus ist schreibgeschützt?
- Plan
- YOLO
- Auto-Edit
Laut Dokumentation bearbeitet und führt der Plan Mode nichts aus.
Welcher Befehl setzt Projektdateien auf einen Checkpoint zurück?
- /diff
- /init
- /restore
/restore listet Checkpoints auf und setzt Dateien auf den Stand vor dem Aufruf eines Tools zurück.
Quellen
Links zuletzt geprüft am 15. November 2026.





Kommentar schreiben