SpyBara
Go Premium

keybindings.md 2026-09-27 23:59 UTC to 2026-09-28 22:01 UTC

This page contains 30 additions and 30 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Mon 21 22:59 Tue 22 23:59 Fri 25 23:58 Mon 28 22:59

Tastaturkürzel anpassen

Passen Sie Tastaturkürzel in Claude Code mit einer Keybindings-Konfigurationsdatei an.

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.

Feld Beschreibung
$schema Optionale JSON-Schema-URL für Editor-Autovervollständigung
$docs Optionale Dokumentations-URL
bindings Array von Binding-Blöcken nach Kontext

Dieses Beispiel bindet Ctrl+E zum Öffnen eines externen Editors im Chat-Kontext und hebt die Bindung von Ctrl+U auf:

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/en/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null
      }
    }
  ]
}

Kontexte

Jeder Binding-Block gibt einen Kontext an, in dem die Bindings gelten:

Kontext Beschreibung
Global Gilt überall in der App
Chat Haupteingabebereich für Chat
Autocomplete Autovervollständigungsmenü ist offen
Settings Einstellungsmenü
Confirmation Berechtigungs- und Bestätigungsdialoge
Tabs Tab-Navigationskomponenten
Help Hilfemenü ist sichtbar
Transcript Transkript-Viewer
HistorySearch Verlaufssuchmodus (Ctrl+R)
Task Hintergrundaufgabe wird ausgeführt
ThemePicker Design-Picker-Dialog
Attachments Bildanhang-Navigation in Auswahldialogen
Footer Fußzeilen-Indikator-Navigation (Aufgaben, Teams, Diff, Artefakte)
MessageSelector Nachrichtenauswahl für Rewind- und Zusammenfassungsdialog
DiffDialog Diff-Viewer-Navigation
DiffPanel Das Diff-Panel ist offen
ModelPicker Modell-Picker-Aufwandsstufe
EffortSlider Aufwands-Schieberegler, geöffnet durch /effort
Select Generische Select/List-Komponenten
Plugin Plugin-Dialog (durchsuchen, entdecken, verwalten)
Agents Agent-Ansicht (claude agents)
Scroll Konversations-Scrolling und Textauswahl im Vollbildmodus

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:

Aktion Standard Beschreibung
app:interrupt Ctrl+C Aktuelle Operation abbrechen
app:exit Ctrl+D Claude Code beenden. Zweimal innerhalb von 800 ms drücken, um zu bestätigen
app:redraw (nicht gebunden) Bildschirm neu zeichnen erzwingen
app:toggleTodos Ctrl+T Sichtbarkeit der Aufgabenliste von Claude umschalten. Dies ist nicht die /tasks Hintergrund-Aufgabenansicht
app:toggleTranscript Ctrl+O Ausführliches Transkript umschalten

Verlaufsaktionen

Aktionen zum Navigieren im Befehlsverlauf:

Aktion Standard Beschreibung
history:search Ctrl+R Verlaufssuche öffnen
history:previous Oben Vorheriges Verlaufselement
history:next Unten Nächstes Verlaufselement

Chat-Aktionen

Aktionen verfügbar im Chat-Kontext:

Aktion Standard Beschreibung
chat:cancel Escape Aktuelle Eingabe abbrechen
chat:clearInput Ctrl+L Vollständiges Bildschirm-Neuzeichnen erzwingen, Eingabe und Konversation beibehalten
chat:clearScreen Cmd+K Dasselbe wie chat:clearInput. Siehe Konversation löschen, um zu erfahren, wie sich Cmd+K auf iTerm2 und Terminal.app verhält
chat:killAgents Ctrl+X Ctrl+K Alle laufenden Hintergrund-Subagenten in dieser Sitzung beenden und automatische Artefakt-Antworten für den Rest der Sitzung ausschalten
chat:cycleMode Shift+Tab* Berechtigungsmodi durchlaufen
chat:modelPicker Meta+P Modell-Picker öffnen
chat:fastMode Meta+O Schnellmodus umschalten
chat:thinkingToggle Meta+T Erweitertes Denken umschalten
chat:submit Enter Nachricht senden
chat:queueSubmit Ctrl+X Enter Nachricht senden, markiert zum Warten auf ihren Platz: Während Claude arbeitet, reiht Claude Code sie ein und unterbricht den Zug nie. Im Gegensatz zu chat:submit sendet es den Entwurf auch, wenn Autovervollständigungsvorschläge offen sind. Erfordert v2.1.247 oder später
chat:sendNow Ctrl+Enter, Ctrl+X Ctrl+S Senden Sie Ihre eingereihten Nachrichten und Ihren Entwurf mit ihnen sofort ab. Wenn Claude Code das sendet, was Sie eingereicht haben behandelt, was mit dem Zug passiert, an dem Claude arbeitet. Wenn nichts läuft, sendet der Schlüssel den Entwurf, und im Shell-Modus reiht er nur den Befehl ein. Terminals, die erweiterte Tasten nicht melden, liefern Ctrl+Enter als einfaches Enter, daher ist Ctrl+X Ctrl+S die Bindung, die in jedem Terminal funktioniert. Erfordert v2.1.275 oder später
chat:newline Ctrl+J Zeilenumbruch einfügen, ohne zu senden
chat:undo Ctrl+_, Ctrl+Shift+- Letzte Aktion rückgängig machen
chat:externalEditor Ctrl+G, Ctrl+X Ctrl+E In externem Editor öffnen. Die Eingabeverteilung der Agent-Ansicht folgt auch den Eintasten-Bindungen dieser Aktion
chat:stash Ctrl+S Aktuelle Eingabeaufforderung speichern
chat:imagePaste Ctrl+V (Alt+V unter Windows und WSL) Bild aus der Zwischenablage einfügen. Unter WSL sind beide Tastenkombinationen standardmäßig gebunden

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

Aktion Standard Beschreibung
autocomplete:accept Tab Vorschlag akzeptieren
autocomplete:dismiss Escape Menü schließen
autocomplete:previous Oben Vorheriger Vorschlag
autocomplete:next Unten Nächster Vorschlag

Bestätigungsaktionen

Aktionen verfügbar im Confirmation-Kontext:

Aktion Standard Beschreibung
confirm:yes Enter Aktion bestätigen
confirm:no Escape Aktion ablehnen
confirm:previous Oben Vorherige Option
confirm:next Unten Nächste Option
confirm:nextField Tab Nächstes Feld
confirm:previousField (nicht gebunden) Vorheriges Feld
confirm:toggle Leertaste Auswahl umschalten
confirm:cycleMode Shift+Tab* Berechtigungsmodi durchlaufen. Bei einer Dateiberechtigungsaufforderung schließt ein offenes Kommentarfeld; ohne offenes Feld wird die Option ausgewählt, die die Aktion für den Rest der Sitzung zulässt, wenn die Aufforderung diese Option anbietet

*Unter Windows ohne VT-Modus (Node <24.2.0/<22.17.0, Bun <1.2.23) Standard auf Meta+M.

Vor v2.1.257 zeigte eine confirm:toggleExplanation-Aktion, standardmäßig an Ctrl+E gebunden, eine modellgenerierte Erklärung des Befehls bei Bash- und PowerShell-Berechtigungsaufforderungen.

Dialoge verwenden confirm:yes und confirm:no, um zu akzeptieren und abzubrechen, auch wenn sie keine Ja-oder-Nein-Frage stellen. Wenn Sie einen bloßen Buchstaben wie y oder n in diesem Kontext binden, wirkt sich der Buchstabe auch auf Dialoge aus, die ihn nie als Taste anzeigen. Ein Dialog, der y und n als seine Tasten anzeigt, liest diese Buchstaben selbst und benötigt keine Bindung.

Dieses Beispiel bindet y an confirm:yes und n an confirm:no:

{
  "bindings": [
    {
      "context": "Confirmation",
      "bindings": {
        "y": "confirm:yes",
        "n": "confirm:no"
      }
    }
  ]
}

Mit diesen Bindungen tippen y und n immer noch als Buchstaben, während ein Textfeld den Fokus hat.

Vor v2.1.280 waren y auch an confirm:yes und n an confirm:no standardmäßig gebunden. Wenn Sie Ihre keybindings.json mit /keybindings vor v2.1.280 erstellt haben, listet die Datei beide Bindungen auf und sie bleiben wirksam, bis Sie diese beiden Zeilen löschen.

Berechtigungsaktionen

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

Aktion Standard Beschreibung
permission:toggleDebug (nicht gebunden) Berechtigungs-Debug-Info umschalten. Der vorherige Standard von Ctrl+D wurde in v2.1.146 entfernt, da er app:exit überlagerte

Transkript-Aktionen

Aktionen verfügbar im Transcript-Kontext:

Aktion Standard Beschreibung
transcript:toggleShowAll Ctrl+E Alle Inhalte anzeigen umschalten
transcript:exit q, Ctrl+C, Escape Transkript-Ansicht beenden

transcript:toggleShowAll gilt nur im klassischen Renderer; im Vollbildrendering bietet der Transkript-Viewer keine Show-All-Umschaltung.

Verlaufssuch-Aktionen

Aktionen verfügbar im HistorySearch-Kontext:

Aktion Standard Beschreibung
historySearch:next Ctrl+R Nächster Treffer
historySearch:accept Escape, Tab Auswahl akzeptieren
historySearch:cancel Ctrl+C Suche abbrechen
historySearch:execute Enter Ausgewählten Befehl ausführen
historySearch:cycleScope Ctrl+S Bereich durchlaufen: Sitzung, Projekt, überall

Die Standards für historySearch:next, historySearch:accept, historySearch:cancel und historySearch:execute gelten für die Inline-Verlaufssuche im klassischen Renderer, die immer Eingabeaufforderungen aus allen Projekten durchsucht. historySearch:cycleScope wird nur im Vollbildrendering wirksam, wo Ctrl+R stattdessen einen Suchdialog öffnet und Ctrl+S seinen Bereich durchläuft. Die anderen Tasten des Dialogs sind fest und können nicht neu gebunden werden: Enter oder Tab platziert den hervorgehobenen Treffer in der Eingabeaufforderung und Esc bricht ab.

Aufgaben-Aktionen

Aktionen verfügbar im Task-Kontext:

Aktion Standard Beschreibung
task:background Ctrl+B, Ctrl+X Ctrl+B Aktuelle Aufgabe in den Hintergrund verschieben. Die Ctrl+X Ctrl+B-Kombination vermeidet den tmux-Präfix-Konflikt

Design-Aktionen

Aktionen verfügbar im ThemePicker-Kontext:

Aktion Standard Beschreibung
theme:toggleSyntaxHighlighting Ctrl+T Syntaxhervorhebung umschalten

Hilfe-Aktionen

Aktionen verfügbar im Help-Kontext:

Aktion Standard Beschreibung
help:dismiss Escape Hilfemenü schließen

Tabs-Aktionen

Aktionen verfügbar im Tabs-Kontext:

Aktion Standard Beschreibung
tabs:next Tab, Rechts Nächster Tab
tabs:previous Shift+Tab, Links Vorheriger Tab

Anhänge-Aktionen

Aktionen verfügbar im Attachments-Kontext:

Aktion Standard Beschreibung
attachments:next Rechts Nächster Anhang
attachments:previous Links Vorheriger Anhang
attachments:remove Rücktaste, Löschen Ausgewählten Anhang entfernen
attachments:exit Unten, Escape Anhang-Navigation beenden

Aktionen verfügbar im Footer-Kontext:

Aktion Standard Beschreibung
footer:next Rechts Nächstes Fußzeilen-Element
footer:previous Links Vorheriges Fußzeilen-Element
footer:up Oben In der Fußzeile nach oben navigieren (Auswahl oben aufheben)
footer:down Unten In der Fußzeile nach unten navigieren
footer:openSelected Enter Ausgewähltes Fußzeilen-Element öffnen
footer:clearSelection Escape Fußzeilen-Auswahl löschen
footer:dismiss Rücktaste, Löschen Ausgewählten Artefakt-Link aus der Fußzeile entfernen; das veröffentlichte Artefakt selbst ist nicht betroffen. Bei anderen Fußzeilenzeilen haben diese Tasten keine Auswirkung. Erfordert v2.1.217 oder später

Während ein Fußzeilen-Element ausgewählt ist, wie eine Zeile im Agent-Panel unter der Eingabeaufforderung, öffnet Enter es auch, wenn Sie Enter im Chat-Kontext zu chat:queueSubmit oder chat:newline neu binden.

Chat-Bindungen auf Tasten, die der Footer-Kontext nicht bindet, wie Shift+Tab für chat:cycleMode, funktionieren weiterhin, während ein Element ausgewählt ist.

Nachrichtenauswahl-Aktionen

Aktionen verfügbar im MessageSelector-Kontext:

Aktion Standard Beschreibung
messageSelector:up Oben, K, Ctrl+P In der Liste nach oben bewegen
messageSelector:down Unten, J, Ctrl+N In der Liste nach unten bewegen
messageSelector:top Ctrl+Oben, Shift+Oben, Meta+Oben, Shift+K Zum Anfang springen
messageSelector:bottom Ctrl+Unten, Shift+Unten, Meta+Unten, Shift+J Zum Ende springen
messageSelector:select Enter Nachricht auswählen

Diff-Aktionen

Aktionen verfügbar im DiffDialog-Kontext:

Aktion Standard Beschreibung
diff:dismiss Escape Diff-Viewer schließen; aus der Detailansicht zurück zur Dateiliste
diff:previousSource Links Vorherige Diff-Quelle
diff:nextSource Rechts Nächste Diff-Quelle
diff:previousFile Oben, K Vorherige Datei in der Dateiliste; eine Zeile nach oben in der Detailansicht scrollen
diff:nextFile Unten, J Nächste Datei in der Dateiliste; eine Zeile nach unten in der Detailansicht scrollen
diff:viewDetails Enter Diff-Details anzeigen
diff:back (nicht gebunden) Im Diff-Viewer zurückgehen. Escape führt die Zurück-Aktion über diff:dismiss aus. Der vorherige Standard von Links in der Detailansicht wurde in v2.1.203 entfernt

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.

Aktion Standard Beschreibung
scroll:pageUp Bild-Auf Halbe Viewport-Höhe nach oben scrollen
scroll:pageDown Bild-Ab Halbe Viewport-Höhe nach unten scrollen
scroll:fullPageUp Shift+Leertaste, B Volle Viewport-Höhe nach oben scrollen
scroll:fullPageDown Leertaste Volle Viewport-Höhe nach unten scrollen
scroll:top G, Pos1 Zum Anfang springen
scroll:bottom Shift+G, Ende Zum Ende springen

Diff-Panel-Aktionen

Aktionen für das Diff-Panel, das /diff im Vollbildrendering öffnet. app:cycleDiffBase ist im DiffPanel-Kontext, der aktiv ist, während das Panel offen ist; die anderen sind Global. Das Panel erfordert Claude Code v2.1.260 oder später.

Aktion Standard Beschreibung
app:toggleReplTab (nicht gebunden) Diff-Panel öffnen oder schließen, dasselbe wie das Ausführen von /diff
app:cycleDiffBase Ctrl+X B Vergleichsbasis des Panels durchlaufen: diese Sitzung, nicht committete Änderungen, dann Branch
app:diffFileListUp Ctrl+Oben, Meta+Oben Dateiliste des Panels nach oben scrollen, wenn sie überläuft
app:diffFileListDown Ctrl+Unten, Meta+Unten Dateiliste des Panels nach unten scrollen, wenn sie überläuft
app:toggleDiffNoiseFilter (nicht gebunden) Test- und generierte Dateien im Panel anzeigen oder ausblenden
app:toggleDiffPreSession (nicht gebunden) Änderungen vor dieser Sitzung erweitern oder reduzieren

Modell-Picker-Aktionen

Aktionen verfügbar im ModelPicker-Kontext:

Aktion Standard Beschreibung
modelPicker:decreaseEffort Links Aufwandsstufe verringern
modelPicker:increaseEffort Rechts Aufwandsstufe erhöhen
modelPicker:thisSessionOnly s Hervorgehobenes Modell nur auf diese Sitzung anwenden

Effort-Schieberegler-Aktionen

Aktionen verfügbar im EffortSlider-Kontext, dem Schieberegler, der sich öffnet, wenn Sie /effort ohne Argumente ausführen. Die Tasten Links, Rechts, Enter und Escape des Schiebereglers können nicht neu gebunden werden.

Aktion Standard Beschreibung
effortSlider:thisSessionOnly s Wenden Sie die fokussierte Aufwandsstufe nur auf diese Sitzung an. Erfordert v2.1.257 oder später

Select-Aktionen

Aktionen verfügbar im Select-Kontext:

Aktion Standard Beschreibung
select:next Unten, J, Ctrl+N Nächste Option
select:previous Oben, K, Ctrl+P Vorherige Option
select:pageUp Bild-Auf Eine Seite mit Optionen nach oben bewegen
select:pageDown Bild-Ab Eine Seite mit Optionen nach unten bewegen
select:first Pos1 Erste Option
select:last Ende Letzte Option
select:accept Enter Auswahl akzeptieren
select:cancel Escape Auswahl abbrechen

Claude Code wendet Ihre select:pageUp-, select:pageDown-, select:first- und select:last-Bindungen im /skills-Menü an. In den meisten anderen Listen, wie dem /model-Picker, gelten Ihre select:first- und select:last-Bindungen. Bild-Auf und Bild-Ab blättern durch die Optionen in diesen Listen unabhängig von Ihren Bindungen.

Vor v2.1.280 ignorierten diese anderen Listen Pos1, Ende und Ihre select:first- und select:last-Bindungen.

Plugin-Aktionen

Aktionen verfügbar im Plugin-Kontext:

Aktion Standard Beschreibung
plugin:toggle Leertaste Plugin-Auswahl umschalten
plugin:install I Ausgewählte Plugins installieren
plugin:favorite F Ausgewähltes Plugin als Favorit markieren, damit es oben auf der Registerkarte „Installiert" sortiert wird

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.

Aktion Standard Beschreibung
settings:search / Suchmodus aktivieren
settings:retry R Nutzungsdaten neu laden (bei Fehler)
select:accept Enter, Leertaste Ändern Sie die ausgewählte Einstellung oder öffnen Sie das Untermenü
confirm:no Escape Schließen Sie das Panel. Änderungen sind bereits gespeichert

Agents-Aktionen

Aktionen verfügbar im Agents-Kontext, der in der Agent-Ansicht gilt, die mit claude agents geöffnet wird. Erfordert v2.1.257 oder später.

Aktion Standard Beschreibung
agents:switchView Ctrl+S Sitzungsgruppenbildung zwischen Status und Verzeichnis wechseln
agents:togglePin Ctrl+T Ausgewählte Sitzung anheften oder loslösen

Während die Agent-Ansicht offen ist, verwendet Claude Code die Agents-Bindung für jede Taste, die der Agents-Kontext bindet, und ignoriert eine Chat- oder Global-Bindung auf derselben Taste. Wenn Sie beispielsweise Ctrl+S in der Agent-Ansicht drücken, wird die Sitzungsgruppenbildung gewechselt, anstatt den Standard chat:stash auszulösen.

Die Eingabeverteilung des externen Editors ist keine Agents-Aktion. Die Agent-Ansicht folgt der Chat-Kontext-Bindung chat:externalEditor, Ctrl+G standardmäßig.

Bindungen werden bei einzelnen Tastenanschlägen in der Agent-Ansicht ausgelöst, daher öffnet die Ctrl+X Ctrl+E-Kombination, die an chat:externalEditor gebunden ist, den Editor dort nicht.

Sprach-Aktionen

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

Aktion Standard Beschreibung
voice:pushToTalk Leertaste Eingabeaufforderung diktieren. Halten oder tippen je nach /voice-Modus

Scroll-Aktionen

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

Aktion Standard Beschreibung
scroll:lineUp wheelup Eine Zeile nach oben scrollen. Mausrad-Scrolling löst diese Aktion aus
scroll:lineDown wheeldown Eine Zeile nach unten scrollen. Mausrad-Scrolling löst diese Aktion aus
scroll:pageUp Bild-Auf Halbe Viewport-Höhe nach oben scrollen
scroll:pageDown Bild-Ab Halbe Viewport-Höhe nach unten scrollen
scroll:top Ctrl+Pos1 Zum Anfang der Konversation springen
scroll:bottom Ctrl+Ende Zur neuesten Nachricht springen und Auto-Follow erneut aktivieren
scroll:halfPageUp (nicht gebunden) Halbe Viewport-Höhe nach oben scrollen. Gleiches Verhalten wie scroll:pageUp, bereitgestellt für Vi-ähnliche Neubindungen
scroll:halfPageDown (nicht gebunden) Halbe Viewport-Höhe nach unten scrollen. Gleiches Verhalten wie scroll:pageDown, bereitgestellt für Vi-ähnliche Neubindungen
scroll:fullPageUp (nicht gebunden) Volle Viewport-Höhe nach oben scrollen
scroll:fullPageDown (nicht gebunden) Volle Viewport-Höhe nach unten scrollen
selection:copy Ctrl+Shift+C / Cmd+C Ausgewählten Text in die Zwischenablage kopieren
selection:clear (nicht gebunden) Aktive Textauswahl löschen. Erfordert v2.1.234 oder später
selection:extendLeft Shift+Links Aktive Auswahl eine Spalte nach links erweitern
selection:extendRight Shift+Rechts Aktive Auswahl eine Spalte nach rechts erweitern
selection:extendUp Shift+Oben Aktive Auswahl eine Zeile nach oben erweitern. Scrollt den Viewport, wenn die Auswahl die obere Kante erreicht
selection:extendDown Shift+Unten Aktive Auswahl eine Zeile nach unten erweitern. Scrollt den Viewport, wenn die Auswahl die untere Kante erreicht
selection:extendLineStart Shift+Pos1 Aktive Auswahl zum Anfang der Zeile erweitern
selection:extendLineEnd Shift+Ende Aktive Auswahl zum Ende der Zeile erweitern

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:

ctrl+k          Strg + K
shift+tab       Umschalt + Tab
meta+p          Option + P unter macOS, Alt + P anderswo
ctrl+shift+c    Mehrere Modifizierer

Großbuchstaben

Claude Code analysiert Tastennamen groß- und kleinschreibungsunabhängig, daher ist K dieselbe Bindung wie k und ctrl+K ist dasselbe wie ctrl+k. Um Umschalt und einen Buchstaben zu binden, schreiben Sie shift+k.

Nicht-US-Tastaturlayouts

Schreiben Sie die Tastennamen von Strg-Verknüpfungen als lateinische Zeichen, auch wenn Ihr aktives Tastaturlayout andere Zeichen eingibt.

Wie Claude Code die Taste, die Sie drücken, mit einer Bindung abgleicht, hängt von der Art des Layouts ab:

  • Unter einem nicht-lateinischen Layout wie Kyrillisch gleicht Claude Code Strg-Verknüpfungen durch die US-Layout-Position der Taste ab, wenn das Terminal das Kitty-Tastaturprotokoll verwendet und diese Position meldet. In einem solchen Terminal mit aktivem russischem Layout löst das Drücken von Strg und der physischen W-Taste ctrl+w aus. In einem Terminal, das die Position nicht meldet, gleicht Claude Code ab, was das Terminal für den Tastendruck sendet: Ein ASCII-Steuercode löst die lateinische Verknüpfung aus, und ein Tastendruck, der als kyrillisches Zeichen ankommt, entspricht keiner Bindung
  • Unter Layouts, die lateinische Buchstaben neu anordnen, wie AZERTY, gleicht Claude Code den Buchstaben ab, den die Taste eingibt, daher löst das Drücken von Strg und der mit A beschrifteten Taste ctrl+a aus

Vor v2.1.247 löste das Drücken einer Strg-Verknüpfung unter einem nicht-lateinischen Layout seine Bindung in Terminals, die das Kitty-Tastaturprotokoll verwenden, wie Ghostty, Kitty, WezTerm und iTerm2, nicht aus.

Akkorde

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

ctrl+k ctrl+s   Drücken Sie Strg+K, loslassen, dann Strg+S

Drücken Sie jede Tastenkombination innerhalb von 3 Sekunden nach der vorherigen. Wenn Sie länger warten, bricht Claude Code den Akkord ab und zeigt eine kurze Benachrichtigung an, die dies anzeigt.

Spezielle Tasten

  • escape oder esc - Escape-Taste
  • enter oder return - Enter-Taste
  • tab - Tab-Taste
  • space - Leertaste
  • up, down, left, right - Pfeiltasten
  • pageup, pagedown - Bild-auf- und Bild-ab-Tasten
  • home, end - Pos1- und Ende-Tasten
  • backspace, delete - Löschtasten
  • wheelup, wheeldown - Mausrad-Scroll-Ereignisse

Standardkürzel aufheben

Setzen Sie eine Aktion auf null, um ein Standardkürzel aufzuheben:

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null
      }
    }
  ]
}

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.

Claude Code bindet diese Standard-Akkorde auf dem ctrl+x-Präfix: ctrl+x ctrl+k, ctrl+x ctrl+e, ctrl+x enter, ctrl+x ctrl+a, ctrl+x ctrl+s und ctrl+x tab in Chat, ctrl+x ctrl+b in Task und ctrl+x b in DiffPanel. Der ctrl+x enter-Akkord erfordert v2.1.247 oder später, ctrl+x b, ctrl+x ctrl+a und ctrl+x tab erfordern v2.1.260 oder später, und ctrl+x ctrl+s erfordert v2.1.275 oder später.

Um ctrl+x selbst als Single-Key-Binding zurückzugewinnen, heben Sie alle auf:

{
  "bindings": [
    {
      "context": "Task",
      "bindings": {
        "ctrl+x ctrl+b": null
      }
    },
    {
      "context": "DiffPanel",
      "bindings": {
        "ctrl+x b": null
      }
    },
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": null,
        "ctrl+x enter": null,
        "ctrl+x ctrl+a": null,
        "ctrl+x ctrl+s": null,
        "ctrl+x tab": null,
        "ctrl+x": "chat:newline"
      }
    }
  ]
}

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:

Kürzel Grund
Ctrl+C Hardcodierter Interrupt/Abbruch
Ctrl+D Hardcodierter Ausstieg
Ctrl+M Claude Code empfängt es immer als Enter
Ctrl+[ Claude Code empfängt es immer als Escape. In Terminals, die das Kitty-Tastaturprotokoll verwenden, ist v2.1.242 oder später erforderlich
Ctrl+I Claude Code empfängt es immer als Tab
Ctrl+H Sendet das ASCII-Backspace-Byte. Wie Claude Code es unter Windows liest hängt von Ihrem Terminal und der Umgebungsvariablen CLAUDE_CODE_BS_AS_CTRL_BACKSPACE ab
Caps Lock Nicht an Terminalanwendungen übermittelt

Terminal-Konflikte

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

Kürzel Konflikt
Ctrl+B tmux-Präfix (zweimal drücken zum Senden)
Ctrl+A GNU Screen-Präfix
Ctrl+Z Unix-Prozess-Suspend (SIGTSTP)

Textfelder

Wenn Sie einen einzelnen Buchstaben, eine Ziffer oder die Leertaste binden, können Sie dieses Zeichen trotzdem in einem Textfeld in einem Dialog oder Panel eingeben. Ein solches Feld ist die Other-Antwort auf eine Frage, die Claude stellt. Während das Feld den Fokus hat, geht ein druckbares Zeichen, das Sie ohne Strg, Alt oder Cmd drücken, in das Feld, und Claude Code gleicht es nicht gegen Ihre Bindungen ab.

Diese Tasten führen ihre Bindungen aus, während das Feld den Fokus hat:

  • Tasten, die kein Zeichen eingeben, wie Eingabe, Escape, Tab und die Pfeiltasten
  • Jede Taste, die mit Strg, Alt oder Cmd gedrückt wird
  • Der zweite Tastendruck eines Akkords, der bereits läuft

Bei der Haupteingabeaufforderung gleicht Claude Code jede Taste gegen die aktiven Kontexte, wie Chat, ab und gibt die Taste nur ein, wenn keine Bindung sie übernimmt.

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
  • Ungültige Aktionswerte, wie eine Aktion, die keine Zeichenkette oder null ist
  • Unbekannte Aktionsnamen, wie ein Tippfehler einer registrierten Aktion. Claude Code überspringt die Bindung und behält alle Standard-Bindungen für diese Taste bei. Vor v2.1.246 deaktivierte eine Bindung mit einem unbekannten Aktionsnamen diese Taste stillschweigend
  • Reservierte Kürzel-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.