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.

Die Befehle von Qwen Code werden über bestimmte Präfixe ausgelöst und lassen sich in drei Kategorien einteilen:

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.

BefehlBeschreibungVerwendungsbeispiele
/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
/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 des Erscheinungsbilds der Oberfläche und der Arbeitsumgebung.

BefehlBeschreibungVerwendungsbeispiele
/clearTerminalbildschirm leeren/clear (Shortcut: Ctrl+L)
/contextAufschlüsselung der Kontextfensternutzung anzeigen/context
detailAufschlüsselung der Kontextnutzung pro Element anzeigen/context detail
/themeVisuelles Theme von Qwen Code ändern/theme
/vimVim-Bearbeitungsmodus im Eingabebereich ein-/ausschalten/vim
/directoryWorkspace mit Unterstützung für mehrere Verzeichnisse 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.

BefehlBeschreibungVerwendungsbeispiele
/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.

BefehlBeschreibungVerwendungsbeispiele
/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 verlassen/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
/modelIm 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
/memoryInstruktionskontext der KI verwalten/memory add Wichtige Info

1.5 Integrierte Skills

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

BefehlBeschreibungVerwendungsbeispiele
/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>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 vollständiger Markdown-Unterstützung gerendert (Codeblöcke, Listen, Tabellen usw.)

Tastenkürzel (Interaktiver Modus):

TastenkürzelAktion
EscapeAbbrechen (während des Ladens) oder schließen (nach Abschluss)
Space oder EnterAntwort schließen (wenn die Eingabe leer ist)
Ctrl+C oder Ctrl+DLaufende Nebenfrage abbrechen

Beispiel:

(Während die Hauptkonversation das Refactoring von Code behandelt) > /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) (Nachdem die Antwort eingetroffen ist) ╭──────────────────────────────────────────╮ │ /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
InteraktivWird oberhalb des Composers mit Markdown-Rendering angezeigt
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 Informationen, Einstellungen und Hilfe

Befehle zum Abrufen von Informationen und zum Vornehmen von Systemeinstellungen.

BefehlBeschreibungVerwendungsbeispiele
/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
/copyLetzte Ausgabe in die Zwischenablage kopieren/copy
/quitQwen Code sofort beenden/quit oder /exit

1.8 Häufige Tastenkürzel

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

1.9 CLI-Auth-Unterbefehle

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

BefehlBeschreibung
qwen authInteraktives Authentifizierungs-Setup
qwen auth qwen-oauthAuthentifizierung mit Qwen OAuth
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 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 maskiert 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 eine automatische Migrationsaufforderung 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)

Regeln für die Befehlsbenennung

Zuordnungstabelle: Dateipfad zu Befehlsname

DateispeicherortGenerierter BefehlBeispielaufruf
~/.qwen/commands/test.md/test/test Parameter
<Projekt>/.qwen/commands/git/commit.md/git:commit/git:commit Nachricht

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

Spezifikation für das Markdown-Dateiformat (Empfohlen)

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

--- description: Optionale Beschreibung (wird in /help angezeigt) --- Dein Prompt-Inhalt hier. Verwende {{args}} für die Parameterinjektion.
FeldErforderlichBeschreibungBeispiel
descriptionOptionalBefehlsbeschreibung (wird in /help angezeigt)description: Code-Analyse-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-Analyse-Tool"

Parameterverarbeitungsmechanismus

VerarbeitungsmethodeSyntaxAnwendungsszenarienSicherheitsmerkmale
Kontextbewusste Injektion{{args}}Präzise Parametersteuerung erforderlichAutomatisches Shell-Escaping
Standard-ParameterverarbeitungKeine spezielle MarkierungEinfache Befehle, Parameter-AnhängungWird unverändert angehängt
Shell-Befehlsinjektion!{command}Dynamischer Inhalt erforderlichVorherige Ausführungsbestätigung erforderlich

1. Kontextbewusste Injektion ({{args}})

SzenarioTOML-KonfigurationAufrufmethodeTatsächlicher Effekt
Rohe 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
Mit ParameternWird am Ende des Prompts angehängt (getrennt durch zwei Zeilenumbrüche)/cmd parameter → Ursprünglicher Prompt + Parameter
Ohne ParameterPrompt wird unverändert gesendet/cmd → Ursprünglicher 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 (!{...})

OperationBenutzerinteraktion
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: Generierung von Git-Commit-Nachrichten

--- description: Commit-Nachricht basierend auf gestagten Änderungen generieren --- Bitte generiere eine Commit-Nachricht basierend auf folgendem Diff: ```diff !{git diff --staged} ```

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

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

Beispiel: Code-Review-Befehl

--- description: Code-Review basierend auf Best Practices --- Überprüfe {{args}}, Referenzstandards: @{docs/code-standards.md}

Praktisches Erstellungbeispiel

Tabelle: Schritte zur Erstellung des Befehls “Pure Function Refactoring”

OperationBefehl/Code
1. Verzeichnisstruktur erstellenmkdir -p ~/.qwen/commands/refactor
2. Befehlsdatei erstellentouch ~/.qwen/commands/refactor/pure.md
3. Befehlsinhalt bearbeitenSiehe den vollständigen Code unten.
4. Befehl testen@file.js/refactor:pure
--- description: Code zu reiner Funktion refactoren --- Bitte analysiere den Code im aktuellen Kontext und refactore ihn zu einer reinen Funktion. Anforderungen: 1. Liefere den refactorten Code 2. Erkläre die wichtigsten Änderungen und die Implementierung der Merkmale reiner Funktionen 3. Erhalte die Funktionalität der Funktion unverändert

Zusammenfassung der Best Practices für benutzerdefinierte Befehle

Tabelle: Empfehlungen zum Befehlsdesign

PraxispunkteEmpfohlener AnsatzVermeiden
BefehlsbenennungNamespaces zur Organisation verwendenVermeide zu generische Namen
ParameterverarbeitungVerwende explizit {{args}}Verlasse dich auf das Standard-Anhängen (kann verwirren)
FehlerbehandlungNutze Shell-FehlerausgabenIgnoriere Ausführungsfehler nicht
DateiorganisationOrganisiere nach Funktion in VerzeichnissenAlle Befehle im Root-Verzeichnis
BeschreibungsfeldGib immer eine klare Beschreibung anVerlasse dich nicht auf automatisch generierte Beschreibungen

Tabelle: Erinnerung an Sicherheitsfunktionen

SicherheitsmechanismusSchutzwirkungBenutzeroperation
Shell-EscapingVerhindert Command InjectionAutomatische Verarbeitung
AusführungsbestätigungVermeidet unbeabsichtigte AusführungDialogbestätigung
FehlerberichterstattungHilft bei der FehlerdiagnoseFehlerinformationen anzeigen
Last updated on