/keybindings aus, um Ihre Konfigurationsdatei unter ~/.claude/keybindings.json zu erstellen oder zu öffnen.
Konfigurationsdatei
Die Keybindings-Konfigurationsdatei ist ein Objekt mit einembindings-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 einemnamespace: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 imGlobal-Kontext:
Verlaufsaktionen
Aktionen zum Navigieren im Befehlsverlauf:Chat-Aktionen
Aktionen verfügbar imChat-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 imAutocomplete-Kontext:
Bestätigungsaktionen
Aktionen verfügbar imConfirmation-Kontext:
Berechtigungsaktionen
Aktionen verfügbar imConfirmation-Kontext für Berechtigungsdialoge:
Transkript-Aktionen
Aktionen verfügbar imTranscript-Kontext:
Verlaufssuch-Aktionen
Aktionen verfügbar imHistorySearch-Kontext:
Aufgaben-Aktionen
Aktionen verfügbar imTask-Kontext:
Design-Aktionen
Aktionen verfügbar imThemePicker-Kontext:
Hilfe-Aktionen
Aktionen verfügbar imHelp-Kontext:
Tabs-Aktionen
Aktionen verfügbar imTabs-Kontext:
Anhänge-Aktionen
Aktionen verfügbar imAttachments-Kontext:
Fußzeilen-Aktionen
Aktionen verfügbar imFooter-Kontext:
Nachrichtenauswahl-Aktionen
Aktionen verfügbar imMessageSelector-Kontext:
Diff-Aktionen
Aktionen verfügbar imDiffDialog-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 imModelPicker-Kontext:
Select-Aktionen
Aktionen verfügbar imSelect-Kontext:
Plugin-Aktionen
Aktionen verfügbar imPlugin-Kontext:
Einstellungs-Aktionen
Aktionen verfügbar imSettings-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 imChat-Kontext, wenn Sprachdiktat aktiviert ist:
Scroll-Aktionen
Aktionen verfügbar imScroll-Kontext, wenn Vollbildrendering aktiviert ist:
Tastenkombinations-Syntax
Modifizierer
Verwenden Sie Modifizierer-Tasten mit dem+-Trennzeichen:
ctrlodercontrol- Strg-Tasteshift- Umschalt-Tastealt,opt,optionodermeta- Alt-Taste unter Windows und Linux, Option-Taste unter macOScmd,command,superoderwin- Befehlstaste unter macOS, Windows-Taste unter Windows, Super-Taste unter Linux
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 istK 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
escapeoderesc- Escape-Tasteenteroderreturn- Enter-Tastetab- Tab-Tastespace- Leertasteup,down,left,right- Pfeiltastenbackspace,delete- Löschtasten
Standardkürzel aufheben
Setzen Sie eine Aktion aufnull, um ein Standardkürzel aufzuheben:
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:
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:cancelaus - 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
jjauf Escape abzubilden, verwenden Sie die EinstellungvimInsertModeRemaps - 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
--debug, um die Details zu sehen.