Skip to Content
BenutzerhandbuchFunktionenBefehle

Befehle

Dieses Dokument beschreibt alle von Qwen Code unterstützten Befehle und hilft dir, Sitzungen effizient zu verwalten, die Oberfläche anzupassen und das Verhalten zu steuern.

Qwen Code-Befehle werden durch bestimmte Präfixe ausgelöst und fallen in drei Kategorien:

Präfix-TypFunktionsbeschreibungTypischer Anwendungsfall
Slash-Befehle (/)Steuerung von Qwen Code auf Meta-EbeneSitzungen verwalten, Einstellungen ändern, Hilfe erhalten
At-Befehle (@)Lokalen Dateiinhalt schnell in die Konversation einfügenErmöglicht der KI, angegebene Dateien oder Code in Verzeichnissen zu analysieren
Ausrufezeichen-Befehle (!)Direkte Interaktion mit der System-ShellAusführen von Systembefehlen wie git status, ls usw.

1. Slash-Befehle (/)

Slash-Befehle dienen zur Verwaltung von Qwen Code-Sitzungen, der Oberfläche und des Grundverhaltens.

1.1 Sitzungs- und Projektverwaltung

Diese Befehle helfen dir, Arbeitsfortschritte zu speichern, wiederherzustellen und zusammenzufassen.

BefehlBeschreibungAnwendungsbeispiele
/initAktuelles Verzeichnis analysieren und initiale Kontextdatei erstellen/init
/summaryProjektzusammenfassung basierend auf dem Konversationsverlauf generieren/summary
/compressChatverlauf durch Zusammenfassung ersetzen, um Tokens zu sparen/compress
/resumeVorherige Konversationssitzung fortsetzen/resume
/recapJetzt eine einzeilige Sitzungszusammenfassung generieren/recap
/restoreDateien auf den Zustand vor der Tool-Ausführung zurücksetzen/restore (Liste) oder /restore <ID>

1.2 Oberflächen- und Workspace-Steuerung

Befehle zum Anpassen der Oberflächendarstellung und der Arbeitsumgebung.

BefehlBeschreibungAnwendungsbeispiele
/clearTerminalbildschirm leeren/clear (Shortcut: Strg+L)
/contextAufschlüsselung der Kontextfensternutzung anzeigen/context
detailAufschlüsselung der Kontextnutzung pro Element anzeigen/context detail
/themeVisuelles Qwen Code-Theme ändern/theme
/vimVim-Bearbeitungsmodus im Eingabebereich ein-/ausschalten/vim
/directoryWorkspace für Multi-Directory-Unterstützung verwalten/dir add ./src,./tests
/editorDialog zur Auswahl eines unterstützten Editors öffnen/editor

1.3 Spracheinstellungen

Befehle speziell zur Steuerung der Oberflächen- und Ausgabesprache.

BefehlBeschreibungAnwendungsbeispiele
/languageSpracheinstellungen anzeigen oder ändern/language
ui [Sprache]Sprache der UI-Oberfläche festlegen/language ui zh-CN
output [Sprache]Ausgabesprache des LLM festlegen/language output Chinese
  • Verfügbare integrierte UI-Sprachen: zh-CN (Vereinfachtes Chinesisch), en-US (Englisch), ru-RU (Russisch), de-DE (Deutsch)
  • Beispiele für Ausgabesprachen: Chinese, English, Japanese usw.

1.4 Tool- und Modellverwaltung

Befehle zur Verwaltung von KI-Tools und Modellen.

BefehlBeschreibungAnwendungsbeispiele
/mcpKonfigurierte MCP-Server und Tools auflisten/mcp, /mcp desc
/toolsAktuell verfügbare Tool-Liste anzeigen/tools, /tools desc
/skillsVerfügbare Skills auflisten und ausführen/skills, /skills <name>
/planIn den Plan-Modus wechseln oder diesen beenden/plan, /plan <task>, /plan exit
/approval-modeGenehmigungsmodus für die Tool-Nutzung ändern/approval-mode <mode (auto-edit)> --project
planNur Analyse, keine AusführungSichere Überprüfung
defaultGenehmigung für Änderungen erforderlichTägliche Nutzung
auto-editÄnderungen automatisch genehmigenVertrauenswürdige Umgebung
yoloAlles automatisch genehmigenSchnelles Prototyping
/modelIn der aktuellen Sitzung verwendetes Modell wechseln/model
/model --fastEin leichteres Modell für Prompt-Vorschläge festlegen/model --fast qwen3-coder-flash
/extensionsAlle aktiven Erweiterungen in der aktuellen Sitzung auflisten/extensions
/memoryMemory-Manager-Dialog öffnen/memory
/rememberEin dauerhaftes Memory speichern/remember Prefer terse responses
/forgetPassende Einträge aus dem Auto-Memory entfernen/forget <query>
/dreamAuto-Memory-Konsolidierung manuell ausführen/dream

1.5 Integrierte Skills

Diese Befehle rufen gebündelte Skills auf, die spezialisierte Workflows bereitstellen.

BefehlBeschreibungAnwendungsbeispiele
/reviewCode-Änderungen mit 5 parallelen Agents + deterministischer Analyse prüfen/review, /review 123, /review 123 --comment
/loopEinen Prompt nach einem wiederkehrenden Zeitplan ausführen/loop 5m check the build
/qc-helperFragen zur Nutzung und Konfiguration von Qwen Code beantworten/qc-helper how do I configure MCP?

Die vollständige Dokumentation zu /review findest du unter Code Review.

1.6 Nebenfrage (/btw)

Der Befehl /btw ermöglicht es dir, schnelle Nebenfragen zu stellen, ohne den Hauptkonversationsfluss zu unterbrechen oder zu beeinflussen.

BefehlBeschreibung
/btw <deine Frage>Eine schnelle Nebenfrage stellen
?btw <deine Frage>Alternative Syntax für Nebenfragen

Funktionsweise:

  • Die Nebenfrage wird als separater API-Aufruf mit dem aktuellen Konversationskontext (bis zu den letzten 20 Nachrichten) gesendet
  • Die Antwort wird oberhalb des Composers angezeigt – du kannst während des Wartens weiter tippen
  • Die Hauptkonversation wird nicht blockiert – sie läuft unabhängig weiter
  • Die Antwort auf die Nebenfrage wird nicht Teil des Hauptkonversationsverlaufs
  • Antworten werden mit voller Markdown-Unterstützung gerendert (Code-Blöcke, Listen, Tabellen usw.)

Tastenkürzel (Interaktiver Modus):

TastenkürzelAktion
EscapeAbbrechen (während des Ladens) oder schließen (nach Abschluss)
Leertaste oder EnterAntwort schließen (wenn die Eingabe leer ist)
Strg+C oder Strg+DEine laufende Nebenfrage abbrechen

Beispiel:

(While the main conversation is about refactoring code) > /btw What's the difference between let and var in JavaScript? ╭──────────────────────────────────────────╮ │ /btw What's the difference between let │ │ and var in JavaScript? │ │ │ │ + Answering... │ │ Press Escape, Ctrl+C, or Ctrl+D to cancel│ ╰──────────────────────────────────────────╯ > (Composer remains active — keep typing) (After the answer arrives) ╭──────────────────────────────────────────╮ │ /btw What's the difference between let │ │ and var in JavaScript? │ │ │ │ `let` is block-scoped, while `var` is │ │ function-scoped. `let` was introduced │ │ in ES6 and doesn't hoist the same way. │ │ │ │ Press Space, Enter, or Escape to dismiss │ ╰──────────────────────────────────────────╯ > (Composer still active)

Unterstützte Ausführungsmodi:

ModusVerhalten
InteraktivZeigt oberhalb des Composers mit Markdown-Rendering
Nicht-interaktivGibt Textergebnis zurück: btw> question\nanswer
ACP (Agent Protocol)Gibt stream_messages async generator zurück
Tip

Verwende /btw, wenn du eine schnelle Antwort benötigst, ohne von deiner Hauptaufgabe abzukommen. Es ist besonders nützlich, um Konzepte zu klären, Fakten zu prüfen oder schnelle Erklärungen zu erhalten, während du dich auf deinen primären Workflow konzentrierst.

1.7 Sitzungszusammenfassung (/recap)

Der Befehl /recap generiert eine kurze Zusammenfassung des aktuellen Stands („wo du aufgehört hast“) der aktuellen Sitzung, sodass du eine alte Konversation fortsetzen kannst, ohne seitenweise im Verlauf zurückscrollen zu müssen.

BefehlBeschreibung
/recapEinzeilige Sitzungszusammenfassung generieren und anzeigen

Funktionsweise:

  • Verwendet das konfigurierte schnelle Modell (fastModel-Einstellung), falls verfügbar, und fällt andernfalls auf das Hauptsitzungsmodell zurück. Ein kleines, günstiges Modell reicht für eine Zusammenfassung aus.
  • Die aktuelle Konversation (bis zu 30 Nachrichten, nur Text – Tool-Aufrufe und Tool-Antworten werden herausgefiltert) wird mit einem strengen System-Prompt an das Modell gesendet.
  • Die Zusammenfassung wird in abgedunkelter Farbe mit einem -Präfix gerendert, um sie von echten Assistant-Antworten abzugrenzen.
  • Verweigert die Ausführung mit einem Inline-Fehler, wenn ein Modell-Turn läuft oder ein anderer Befehl verarbeitet wird. Wenn es keine nutzbare Konversation gibt oder die zugrunde liegende Generierung fehlschlägt, zeigt /recap stattdessen eine kurze Info-Meldung an – der manuelle Befehl antwortet immer mit etwas.

Automatischer Trigger bei Rückkehr nach Abwesenheit:

Wenn das Terminal für 5+ Minuten unscharf ist und wieder fokussiert wird, wird automatisch eine Zusammenfassung generiert und angezeigt (nur wenn keine Modellantwort läuft; andernfalls wartet es, bis der aktuelle Turn abgeschlossen ist, und feuert dann). Im Gegensatz zum manuellen Befehl ist der Auto-Trigger bei Fehlern vollständig stumm: Wenn Generierungsfehler auftreten oder nichts zusammenzufassen ist, wird keine Nachricht zum Verlauf hinzugefügt. Gesteuert durch die general.showSessionRecap-Einstellung (Standard: true); der manuelle /recap-Befehl funktioniert unabhängig von dieser Einstellung immer.

Beispiel:

> /recap ❯ Refactoring loopDetectionService.ts to address long-session OOM caused by unbounded streamContentHistory and contentStats. The next step is to implement option B (LRU sliding window with FNV-1a) pending confirmation.
Tip

Konfiguriere ein schnelles Modell über /model --fast <Modell> (z. B. qwen3-coder-flash), um /recap schnell und kostengünstig zu machen. Setze general.showSessionRecap auf false, um den Auto-Trigger zu deaktivieren, während der manuelle Befehl verfügbar bleibt.

1.8 Informationen, Einstellungen und Hilfe

Befehle zum Abrufen von Informationen und Durchführen von Systemeinstellungen.

BefehlBeschreibungAnwendungsbeispiele
/helpHilfeinformationen für verfügbare Befehle anzeigen/help oder /?
/aboutVersionsinformationen anzeigen/about
/statsDetaillierte Statistiken für die aktuelle Sitzung anzeigen/stats
/settingsEinstellungseditor öffnen/settings
/authAuthentifizierungsmethode ändern/auth
/bugProblem bezüglich Qwen Code melden/bug Button click unresponsive
/copyInhalt der letzten Ausgabe in die Zwischenablage kopieren/copy
/quitQwen Code sofort beenden/quit oder /exit

1.9 Häufige Tastenkürzel

TastenkürzelFunktionHinweis
Strg/Cmd+LBildschirm leerenEntspricht /clear
Strg/Cmd+TTool-Beschreibung ein-/ausblendenMCP-Tool-Verwaltung
Strg/Cmd+C×2Beenden bestätigenSicherer Beendigungsmechanismus
Strg/Cmd+ZEingabe rückgängig machenTextbearbeitung
Strg/Cmd+Shift+ZEingabe wiederherstellenTextbearbeitung

1.10 CLI-Auth-Subcommands

Zusätzlich zum /auth-Slash-Befehl innerhalb der Sitzung bietet Qwen Code eigenständige CLI-Subcommands zur Verwaltung der Authentifizierung direkt über das Terminal:

BefehlBeschreibung
qwen authInteraktives Authentifizierungs-Setup
qwen auth coding-planAuthentifizierung mit Alibaba Cloud Coding Plan
qwen auth coding-plan --region china --key sk-sp-…Nicht-interaktives Coding-Plan-Setup (für Skripte)
qwen auth api-keyAuthentifizierung mit einem API-Key
qwen auth qwen-oauthAuthentifizierung mit Qwen OAuth (eingestellt am 2026-04-15)
qwen auth statusAktuellen Authentifizierungsstatus anzeigen
Tip

Diese Befehle werden außerhalb einer Qwen Code-Sitzung ausgeführt. Verwende sie, um die Authentifizierung vor dem Start einer Sitzung oder in Skripten und CI-Umgebungen zu konfigurieren. Vollständige Details findest du auf der Seite Authentication.

2. @-Befehle (Dateien einfügen)

@-Befehle werden verwendet, um schnell lokalen Datei- oder Verzeichnisinhalt zur Konversation hinzuzufügen.

BefehlsformatBeschreibungBeispiele
@<Dateipfad>Inhalt der angegebenen Datei einfügen@src/main.py Please explain this code
@<Verzeichnispfad>Alle Textdateien im Verzeichnis rekursiv lesen@docs/ Summarize content of this document
Eigenständiges @Wird verwendet, wenn das @-Symbol selbst diskutiert wird@ What is this symbol used for in programming?

Hinweis: Leerzeichen in Pfaden müssen mit einem Backslash escaped werden (z. B. @My\ Documents/file.txt)

3. Ausrufezeichen-Befehle (!) - Shell-Befehlsausführung

Ausrufezeichen-Befehle ermöglichen es dir, Systembefehle direkt innerhalb von Qwen Code auszuführen.

BefehlsformatBeschreibungBeispiele
!<Shell-Befehl>Befehl in einer Sub-Shell ausführen!ls -la, !git status
Eigenständiges !Shell-Modus wechseln, jede Eingabe wird direkt als Shell-Befehl ausgeführt!(Enter) → Befehl eingeben → !(Beenden)

Umgebungsvariablen: Über ! ausgeführte Befehle setzen die Umgebungsvariable QWEN_CODE=1.

4. Benutzerdefinierte Befehle

Speichere häufig verwendete Prompts als Shortcut-Befehle, um die Arbeitseffizienz zu steigern und Konsistenz zu gewährleisten.

Note

Benutzerdefinierte Befehle verwenden jetzt das Markdown-Format mit optionalem YAML-Frontmatter. Das TOML-Format ist veraltet, wird aber aus Gründen der Abwärtskompatibilität weiterhin unterstützt. Wenn TOML-Dateien erkannt werden, wird ein automatischer Migrationshinweis angezeigt.

Schneller Überblick

FunktionBeschreibungVorteilePrioritätAnwendungsszenarien
NamespaceUnterverzeichnis erstellt Befehle mit Doppelpunkt-NamenBessere Befehlsorganisation
Globale Befehle~/.qwen/commands/In allen Projekten verfügbarNiedrigPersönliche, häufig genutzte Befehle, projektübergreifende Nutzung
Projektbefehle<Projekt-Root-Verzeichnis>/.qwen/commands/Projektspezifisch, versionierbarHochTeam-Sharing, projektspezifische Befehle

Prioritätsregeln: Projektbefehle > Benutzerbefehle (bei gleichen Namen wird der Projektbefehl verwendet)

Befehlsbenennungsregeln

Zuordnungstabelle: Dateipfad zu Befehlsname

DateispeicherortGenerierter BefehlBeispielaufruf
~/.qwen/commands/test.md/test/test Parameter
<project>/.qwen/commands/git/commit.md/git:commit/git:commit Message

Benennungsregeln: Pfadtrennzeichen (/ oder \) wird in einen Doppelpunkt (:) umgewandelt

Markdown-Dateiformat-Spezifikation (Empfohlen)

Benutzerdefinierte Befehle verwenden Markdown-Dateien mit optionalem YAML-Frontmatter:

--- description: Optional description (displayed in /help) --- Your prompt content here. Use {{args}} for parameter injection.
FeldErforderlichBeschreibungBeispiel
descriptionOptionalBefehlsbeschreibung (wird in /help angezeigt)description: Code analysis tool
Prompt-BodyErforderlichAn das Modell gesendeter Prompt-InhaltBeliebiger Markdown-Inhalt nach dem Frontmatter

TOML-Dateiformat (Veraltet)

Warning

Veraltet: Das TOML-Format wird weiterhin unterstützt, aber in einer zukünftigen Version entfernt. Bitte migriere zum Markdown-Format.

FeldErforderlichBeschreibungBeispiel
promptErforderlichAn das Modell gesendeter Prompt-Inhaltprompt = "Please analyze code: {{args}}"
descriptionOptionalBefehlsbeschreibung (wird in /help angezeigt)description = "Code analysis tool"

Parameterverarbeitungsmechanismus

VerarbeitungsmethodeSyntaxAnwendbare SzenarienSicherheitsmerkmale
Kontextbewusste Injektion{{args}}Präzise Parametersteuerung erforderlichAutomatisches Shell-Escaping
Standard-ParameterverarbeitungKeine spezielle MarkierungEinfache Befehle, Parameter-AnhängenWird unverändert angehängt
Shell-Befehlsinjektion!{command}Dynamischer Inhalt erforderlichErfordert Bestätigung vor Ausführung

1. Kontextbewusste Injektion ({{args}})

SzenarioTOML-KonfigurationAufrufmethodeTatsächlicher Effekt
Roh-Injektionprompt = "Fix: {{args}}"/fix "Button issue"Fix: "Button issue"
In Shell-Befehlprompt = "Search: !{grep {{args}} .}"/search "hello"Führt grep "hello" . aus

2. Standard-Parameterverarbeitung

EingabesituationVerarbeitungsmethodeBeispiel
Hat ParameterAn das Ende des Prompts anhängen (getrennt durch zwei Zeilenumbrüche)/cmd parameter → Originaler Prompt + Parameter
Keine ParameterPrompt unverändert senden/cmd → Originaler Prompt

🚀 Dynamische Inhaltsinjektion

InjektionstypSyntaxVerarbeitungsreihenfolgeZweck
Dateiinhalt@{Dateipfad}Wird zuerst verarbeitetStatische Referenzdateien injizieren
Shell-Befehle!{command}Wird in der Mitte verarbeitetDynamische Ausführungsergebnisse injizieren
Parameterersetzung{{args}}Wird zuletzt verarbeitetBenutzerparameter injizieren

3. Shell-Befehlsausführung (!{...})

VorgangBenutzerinteraktion
1. Befehl und Parameter parsen-
2. Automatisches Shell-Escaping-
3. Bestätigungsdialog anzeigen✅ Benutzerbestätigung
4. Befehl ausführen-
5. Ausgabe in Prompt injizieren-

Beispiel: Git-Commit-Message-Generierung

--- description: Generate Commit message based on staged changes --- Please generate a Commit message based on the following diff: ```diff !{git diff --staged} ```

4. Dateiinhalt-Injektion (@{...})

DateitypSupport-StatusVerarbeitungsmethode
Textdateien✅ Voll unterstütztInhalt direkt injizieren
Bilder/PDF✅ Multi-Modal unterstütztKodieren und injizieren
Binärdateien⚠️ Eingeschränkt unterstütztKann übersprungen oder gekürzt werden
Verzeichnis✅ Rekursive InjektionFolgt .gitignore-Regeln

Beispiel: Code-Review-Befehl

--- description: Code review based on best practices --- Review {{args}}, reference standards: @{docs/code-standards.md}

Praktisches Erstellungbeispiel

Tabelle: Erstellungsschritte für den Befehl „Pure Function Refactoring“

VorgangBefehl/Code
1. Verzeichnisstruktur erstellenmkdir -p ~/.qwen/commands/refactor
2. Befehlsdatei erstellentouch ~/.qwen/commands/refactor/pure.md
3. Befehlsinhalt bearbeitenSiehe vollständigen Code unten.
4. Befehl testen@file.js/refactor:pure
--- description: Refactor code to pure function --- Please analyze code in current context, refactor to pure function. Requirements: 1. Provide refactored code 2. Explain key changes and pure function characteristic implementation 3. Maintain function unchanged

Zusammenfassung der Best Practices für benutzerdefinierte Befehle

Tabelle: Empfehlungen zum Befehlsdesign

PraxispunkteEmpfohlener AnsatzVermeiden
BefehlsbenennungNamespaces zur Organisation verwendenZu generische Namen vermeiden
ParameterverarbeitungExplizit {{args}} verwendenAuf Standard-Anhängen verlassen (verwirrend)
FehlerbehandlungShell-Fehlerausgabe nutzenAusführungsfehler ignorieren
DateiorganisationNach Funktion in Verzeichnissen organisierenAlle Befehle im Root-Verzeichnis
BeschreibungsfeldImmer eine klare Beschreibung angebenAuf automatisch generierte Beschreibung verlassen

Tabelle: Erinnerung an Sicherheitsmerkmale

SicherheitsmechanismusSchutzwirkungBenutzeraktion
Shell-EscapingVerhindert Command InjectionAutomatische Verarbeitung
AusführungsbestätigungVermeidet unbeabsichtigte AusführungDialogbestätigung
FehlerberichterstattungHilft bei der Diagnose von ProblemenFehlerinformationen anzeigen
Last updated on