Zum Hauptinhalt springen
Claude Code unterstützt anpassbare Tastaturkürzel. Führen Sie /keybindings aus, um Ihre Konfigurationsdatei unter ~/.claude/keybindings.json zu erstellen oder zu öffnen.

Konfigurationsdatei

Die Keybindings-Konfigurationsdatei ist ein Objekt mit einem bindings-Array. Jeder Block gibt einen Kontext und eine Zuordnung von Tastenkombinationen zu Aktionen an.
Änderungen an der Keybindings-Datei werden automatisch erkannt und angewendet, ohne Claude Code neu zu starten.
Dieses Beispiel bindet Ctrl+E zum Öffnen eines externen Editors im Chat-Kontext und hebt die Bindung von Ctrl+U auf:

Kontexte

Jeder Binding-Block gibt einen Kontext an, in dem die Bindings gelten: Vor v2.1.205 existierten ein Doctor-Kontext und eine doctor:fix-Aktion für den /doctor-Diagnose-Bildschirm.

Verfügbare Aktionen

Aktionen folgen einem namespace:action-Format, wie chat:submit zum Senden einer Nachricht oder app:toggleTodos zum Anzeigen der Aufgabenliste. Jeder Kontext hat spezifische verfügbare Aktionen.

App-Aktionen

Aktionen verfügbar im Global-Kontext:

Verlaufsaktionen

Aktionen zum Navigieren im Befehlsverlauf:

Chat-Aktionen

Aktionen verfügbar im Chat-Kontext: *Unter Windows ohne VT-Modus (Node <24.2.0/<22.17.0, Bun <1.2.23) Standard auf Meta+M.

Autovervollständigungsaktionen

Aktionen verfügbar im Autocomplete-Kontext:

Bestätigungsaktionen

Aktionen verfügbar im Confirmation-Kontext:

Berechtigungsaktionen

Aktionen verfügbar im Confirmation-Kontext für Berechtigungsdialoge:

Transkript-Aktionen

Aktionen verfügbar im Transcript-Kontext:

Verlaufssuch-Aktionen

Aktionen verfügbar im HistorySearch-Kontext:

Aufgaben-Aktionen

Aktionen verfügbar im Task-Kontext:

Design-Aktionen

Aktionen verfügbar im ThemePicker-Kontext:

Hilfe-Aktionen

Aktionen verfügbar im Help-Kontext:

Tabs-Aktionen

Aktionen verfügbar im Tabs-Kontext:

Anhänge-Aktionen

Aktionen verfügbar im Attachments-Kontext: Aktionen verfügbar im Footer-Kontext:

Nachrichtenauswahl-Aktionen

Aktionen verfügbar im MessageSelector-Kontext:

Diff-Aktionen

Aktionen verfügbar im DiffDialog-Kontext: Die Detailansicht des Diff bindet auch Pager-ähnliche Tasten an die Standard-Scroll-Aktionen. Diese Bindungen sind Teil des DiffDialog-Kontexts und gelten nur in der Detailansicht; die Scroll-Kontext-Standards, die unter Scroll-Aktionen aufgelistet sind, bleiben unverändert.

Modell-Picker-Aktionen

Aktionen verfügbar im ModelPicker-Kontext:

Select-Aktionen

Aktionen verfügbar im Select-Kontext:

Plugin-Aktionen

Aktionen verfügbar im Plugin-Kontext:

Einstellungs-Aktionen

Aktionen verfügbar im Settings-Kontext. Die Aktionen select:accept und confirm:no werden aus den Kontexten Select und Confirmation wiederverwendet mit einstellungsspezifischem Verhalten: Änderungen werden auf jede Einstellung angewendet, sobald Sie sie ändern, daher schließt Escape das Panel mit Ihren gespeicherten Änderungen, anstatt abzulehnen.

Sprach-Aktionen

Aktionen verfügbar im Chat-Kontext, wenn Sprachdiktat aktiviert ist:

Scroll-Aktionen

Aktionen verfügbar im Scroll-Kontext, wenn Vollbildrendering aktiviert ist:

Tastenkombinations-Syntax

Modifizierer

Verwenden Sie Modifizierer-Tasten mit dem +-Trennzeichen:
  • ctrl oder control - Strg-Taste
  • shift - Umschalt-Taste
  • alt, opt, option oder meta - Alt-Taste unter Windows und Linux, Option-Taste unter macOS
  • cmd, command, super oder win - Befehlstaste unter macOS, Windows-Taste unter Windows, Super-Taste unter Linux
Die cmd-Gruppe wird nur in Terminals erkannt, die den Super-Modifizierer melden, wie z. B. solche, die das Kitty-Tastaturprotokoll oder den modifyOtherKeys-Modus von xterm unterstützen. Die meisten Terminals senden ihn nicht, daher verwenden Sie ctrl oder meta für Bindungen, die überall funktionieren sollen. Beispiele:

Großbuchstaben

Ein eigenständiger Großbuchstabe impliziert Umschalt. Zum Beispiel ist K gleichbedeutend mit shift+k. Dies ist nützlich für Vim-ähnliche Bindungen, bei denen Groß- und Kleinbuchstaben unterschiedliche Bedeutungen haben. Großbuchstaben mit Modifizierern (z. B. ctrl+K) werden als stilistisch behandelt und implizieren nicht Umschalt: ctrl+K ist dasselbe wie ctrl+k.

Akkorde

Akkorde sind Sequenzen von Tastenkombinationen, die durch Leerzeichen getrennt sind:

Spezielle Tasten

  • escape oder esc - Escape-Taste
  • enter oder return - Enter-Taste
  • tab - Tab-Taste
  • space - Leertaste
  • up, down, left, right - Pfeiltasten
  • backspace, delete - Löschtasten

Standardkürzel aufheben

Setzen Sie eine Aktion auf null, um ein Standardkürzel aufzuheben:
Dies funktioniert auch für Akkord-Bindings. Das Aufheben aller Akkorde, die ein Präfix teilen, gibt dieses Präfix für die Verwendung als Single-Key-Binding frei. Ein Akkord in einem beliebigen aktiven Kontext behält sein Präfix reserviert, daher müssen Sie jeden Akkord in dem Kontext aufheben, der ihn definiert. Die Standard-Ctrl+X-Familie umfasst zwei Kontexte: ctrl+x ctrl+k und ctrl+x ctrl+e in Chat sowie ctrl+x ctrl+b in Task. Um ctrl+x selbst als Single-Key-Binding zurückzugewinnen, heben Sie alle auf:
Wenn Sie einige, aber nicht alle Akkorde auf einem Präfix aufheben, führt das Drücken des Präfix immer noch in den Akkord-Wartmodus für die verbleibenden Bindings ein.

Reservierte Kürzel

Diese Kürzel können nicht neu gebunden werden:

Terminal-Konflikte

Einige Kürzel können mit Terminal-Multiplexern in Konflikt geraten:

Vim-Modus-Interaktion

Wenn der Vim-Modus aktiviert ist über /config → Editor-Modus, arbeiten Keybindings und Vim-Modus unabhängig:
  • Vim-Modus verarbeitet Eingaben auf der Texteingangsebene (Cursor-Bewegung, Modi, Bewegungen)
  • Keybindings verarbeiten Aktionen auf der Komponentenebene (Aufgaben umschalten, senden usw.)
  • Die Escape-Taste im Vim-Modus wechselt von INSERT zu NORMAL-Modus; sie löst nicht chat:cancel aus
  • Die meisten Ctrl+Taste-Kürzel werden durch den Vim-Modus zum Keybinding-System weitergeleitet
  • Vim-Tasten können nicht über die Keybindings-Datei neu zugeordnet werden. Um eine zwei-Tasten-INSERT-Modus-Sequenz wie jj auf Escape abzubilden, verwenden Sie die Einstellung vimInsertModeRemaps
  • Im Vim-NORMAL-Modus zeigt ? das Hilfemenü an (Vim-Verhalten)
  • Im Vim-NORMAL-Modus öffnet / die Verlaufssuche, dasselbe wie Ctrl+R im Standardmodus

Validierung

Claude Code validiert Ihre Keybindings und zeigt Warnungen für:
  • Parse-Fehler (ungültiges JSON oder Struktur)
  • Ungültige Kontextnamen
  • Reservierte Kürzel-Konflikte
  • Terminal-Multiplexer-Konflikte
  • Doppelte Bindings im selben Kontext
Claude Code meldet Warnungen, wenn die Datei geladen wird, und schreibt jede einzelne in das Debug-Protokoll. Starten Sie Claude Code mit --debug, um die Details zu sehen.