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.

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:

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:

Fußzeilen-Aktionen

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:

Doctor-Aktionen

Aktionen verfügbar im Doctor-Kontext:

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:

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

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:

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

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:

{
  "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:

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": 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:

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
• 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

Führen Sie /doctor aus, um Keybinding-Warnungen anzuzeigen.