Qwen Code: So installierst und nutzt du den Open-Source-Coding-Agenten fürs Terminal

Eine Schritt-für-Schritt-Anleitung: Qwen Code installieren, ein Modell verbinden (auch ein lokales) und Plan Mode sowie Freigaben sicher nutzen, direkt aus der Dokumentation des Projekts.

Graphic of a code card showing a terminal command to install Qwen Code, the open-source terminal coding agent.

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
Übersicht der fünf Anmeldeoptionen von Qwen Code, vom Qwen Account bis zum eigenen lokalen Modellanbieter

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:

Terminal
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:

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

Oder unter macOS und Linux mit Homebrew:

Terminal
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

Terminal
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:

  1. Qwen Account with Subscription: Anmeldung im Browser mit einem Plus- oder Pro-Abo.
  2. QwenCloud: ein Token Plan oder ein nutzungsbasierter Standard API Key.
  3. Alibaba ModelStudio: Coding Plan, Token Plan oder Standard API Key.
  4. Third-party Providers: eine eingebaute Liste mit unter anderem DeepSeek, Kimi und OpenRouter, über einen API-Schlüssel.
  5. 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:

Code
{
  "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:

Code
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:

Code
/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:

Terminal
qwen -p "Summarize the repository layout."
Ablaufdiagramm: Qwen Code installieren, ein Modell verbinden, im schreibgeschützten Modus planen und Änderungen prüfen

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 auth bringt nichts. Dieser Befehl wurde entfernt. Führe qwen aus und dann /auth. Mit /doctor prüfst du deine aktuelle Authentifizierung.
  • Das lokale Modell läuft in einen Timeout. Prüfe, ob die baseUrl auf /v1 endet und der Server läuft. Für langsame Server beschreibt die Dokumentation die Einstellung streamIdleTimeoutMs.
  • Unsicher, ob der Daemon sicher ist. Wenn du qwen serve oder qwen daemon start nutzt: 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 du QWEN_SERVER_TOKEN und 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.

Von Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

Über Mindloop Experience

Kommentare

Kommentar schreiben

Mehr von Mindloop Experience

Alle Artikel von Mindloop Experience

Du kannst bis zu 50-mal applaudieren.