Tastenkürzel

Konfiguriere eigene Tastenkürzel in Claude Code. Referenz für alle 17 Kontexte, Tastenkombinations-Syntax und keybindings.json-Beispiele.

Dein Muskelgedächtnis sagt, Ctrl+K öffnet eine Befehlspalette. Claude Code sieht das anders. Jedes Mal, wenn du nach einem vertrauten Kürzel greifst und die falsche Aktion bekommst, verlierst du den Fokus und deinen Flow.

Diese Reibung summiert sich. Entwickler, die stundenlange Claude Code-Sessions verbringen, bauen unbewusste Gewohnheiten rund um Tastenkürzel auf. Wenn die Standardbelegungen nicht zu deinem mentalen Modell passen, kämpfst du gegen das Tool statt es zu nutzen. Kommst du aus VS Code, Vim, Emacs oder einem terminal-lastigen Workflow, hast du bereits jahrelange Shortcut-Muster in deinen Fingern. Dich zu zwingen, neue zu lernen, ist reine Verschwendung kognitiver Energie.

Claude Code löst das mit einem vollständig anpassbaren Keybinding-System. Du definierst jeden Shortcut in einer einzigen JSON-Datei, geordnet nach Kontext, mit Unterstützung für Chord-Sequenzen, Modifier-Kombinationen und der Möglichkeit, jeden Standard zu deaktivieren. Änderungen gelten sofort ohne Neustart. So richtest du es ein und machst Claude Code zu einer echten Verlängerung deines bestehenden Workflows.

Erste Schritte mit eigenen Keybindings

Führe den Slash-Befehl /keybindings innerhalb von Claude Code aus. Das erstellt (oder öffnet) deine Konfigurationsdatei unter ~/.claude/keybindings.json. Wenn du Claude Code-Konfiguration noch nicht kennst: Diese Datei liegt neben deinen anderen Einstellungen im ~/.claude/-Verzeichnis.

Die Dateistruktur ist simpel:

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

Drei oberste Felder steuern alles:

• $schema - Optional. Zeig das auf Claudes JSON-Schema-URL und dein Editor gibt dir Autovervollständigung und Validierung gratis. Lohnt sich.
• $docs - Optional. Dokumentations-URL für schnelle Nachschläge.
• bindings - Das Array, in dem alle deine eigenen Shortcuts leben. Jeder Eintrag zielt auf einen bestimmten Kontext ab.

Das $schema-Feld allein macht die Konfiguration deutlich einfacher. Nutzt du VS Code oder einen Editor mit JSON-Schema-Support, bekommst du inline Vorschläge für jede gültige Aktion und jeden Kontextnamen.

Änderungen an keybindings.json werden automatisch erkannt und angewendet. Kein Neustart nötig. Bearbeiten, speichern, und deine neuen Shortcuts sind sofort aktiv.

Kontexte verstehen

Jedes Binding gehört zu einem Kontext, der Claude Code sagt, wann dieser Shortcut aktiv ist. Ein Shortcut im Chat-Kontext feuert nur, wenn du gerade im Haupt-Chat-Eingabefeld tippst. Dieselbe Tastenkombination kann in verschiedenen Kontexten verschiedene Dinge tun.

Claude Code hat 17 Kontexte:

Der Global-Kontext ist besonders. Bindings hier gelten überall, unabhängig davon, welcher Dialog oder welche Ansicht aktiv ist. Verwende ihn sparsam. Bindest du Ctrl+K global, feuert es sowohl im Chat als auch beim Durchsuchen von Autovervollständigungs-Vorschlägen oder beim Überprüfen von Diffs.

Vollständige Aktions-Referenz

Aktionen folgen dem Format namespace:action. Hier sind alle Aktionen in jedem Kontext, zusammen mit der Standardbelegung.

Globale Aktionen

Diese funktionieren überall in Claude Code:

Nutzt du Task-Management-Funktionen, ist app:toggleTodos eine, die du ständig brauchst. Bind sie auf etwas Zugänglicheres, wenn Ctrl+T in deinem Terminal zu Konflikten führt.

Chat-Aktionen

Der Haupt-Eingabebereich, in dem du die meiste Zeit verbringst:

Hinweis: chat:cycleMode ist auf Meta+M voreingestellt auf Windows ohne VT-Modus (Node-Versionen vor 24.2.0/22.17.0, oder Bun vor 1.2.23).

Verlaufs-Aktionen

Durch deinen Befehlsverlauf navigieren:

Autovervollständigungs-Aktionen

Wenn das Autovervollständigungs-Menü erscheint:

Bestätigungs-Aktionen

Berechtigungs- und Bestätigungsdialoge:

Transkript-Aktionen

Verlaufssuche-Aktionen

Task-Aktionen

Theme-, Hilfe- und Einstellungs-Aktionen

Navigations-Aktionen

Diese decken Tabs, Anhänge, Footer, Diffs, Modell-Picker, Auswahllisten und den Nachrichtenauswähler ab:

Tastenkombinations-Syntax

Claude Code nutzt eine lesbare Syntax für Tastenkombinationen.

Modifier-Tasten

Modifier-Tasten mit + kombinieren:

• ctrl oder control für die Strg-Taste
• alt, opt oder option für Alt/Option
• shift für Shift
• meta, cmd oder command für Meta/Command

Beispiele:

ctrl+k          Einzelner Modifier + Taste
shift+tab       Shift + Tab
meta+p          Command/Meta + P
ctrl+shift+c    Mehrere Modifier

Großbuchstaben und Shift

Ein alleinstehendes Großbuchstabe impliziert Shift. K in deinen Bindings zu schreiben ist dasselbe wie shift+k. Das ist besonders nützlich für Vim-artige Bindings, wo j und J (oder k und K) verschiedene Dinge tun.

Ein wichtiges Detail: Großbuchstaben mit Modifiern implizieren KEIN Shift. ctrl+K ist also identisch mit ctrl+k. Das Großbuchstabe wird bei vorhandenen Modifiern als rein stilistisch behandelt.

Chord-Sequenzen

Chords erlauben dir mehrgliedrige Shortcuts. Die Tastenanschläge mit einem Leerzeichen trennen:

ctrl+k ctrl+s Ctrl+K drücken, loslassen, dann Ctrl+S drücken

Das gibt dir einen viel größeren Namespace für Shortcuts. Wenn dir die Einzeltasten-Kombinationen ausgehen, eröffnen Chords Hunderte von Möglichkeiten ohne Konflikte mit bestehenden Bindings.

Sondertasten

Diese Namen für Nicht-Buchstaben-Tasten verwenden:

• escape oder esc
• enter oder return
• tab
• space
• up, down, left, right
• backspace, delete

Standard-Shortcuts deaktivieren

Setze eine Aktion auf null, um sie zu deaktivieren:

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

Das ist nützlich, wenn ein Standard-Shortcut mit deinem Terminal, deinem OS oder einem Tool kollidiert, das du neben Claude Code benutzt. Du kannst auch einen Standard deaktivieren und dann dieselbe Taste einer anderen Aktion neu zuweisen.

Reservierte Shortcuts

Zwei Shortcuts sind fest einprogrammiert und können nicht neu belegt werden:

Versuch nicht, diese neu zu belegen. Claude Code akzeptiert das nicht, und das aus gutem Grund. Ctrl+C als Interrupt und Ctrl+D als Exit sind Unix-Konventionen, die jeder Terminal-Benutzer erwartet.

Terminal-Multiplexer-Konflikte

Läufst du Claude Code innerhalb von tmux, GNU screen oder einem anderen Multiplexer, pass auf Präfix-Taste-Konflikte auf:

Die Standard-Aktion task:background nutzt Ctrl+B, was direkt mit tmux kollidiert. Bist du tmux-Nutzer, belege es sofort neu:

{
  "bindings": [
    {
      "context": "Task",
      "bindings": {
        "ctrl+b": null,
        "ctrl+shift+b": "task:background"
      }
    }
  ]
}

Das ist eine der häufigsten Verwirrungsquellen für Entwickler, die Claude Code innerhalb von Terminal-Sessions mit Multiplexern betreiben.

Vim-Modus-Interaktion

Wenn der Vim-Modus aktiviert ist (umschalten mit /vim), arbeiten Keybindings und Vim-Modus auf verschiedenen Ebenen:

• Vim-Modus steuert die Texteingabe: Cursorbewegung, Modi (INSERT, NORMAL), Motions und Text-Objekte
• Keybindings steuern Anwendungsaktionen: Aufgabenliste umschalten, Nachrichten absenden, Modell-Picker öffnen

Der entscheidende Unterschied ist die Escape-Taste. Im Vim-Modus wechselt Escape von INSERT nach NORMAL. Es löst nicht chat:cancel aus. Die meisten Ctrl+Taste-Shortcuts werden durch den Vim-Modus an das Keybinding-System weitergegeben, also schaltet Ctrl+T noch immer deine Aufgabenliste um, auch wenn du im NORMAL-Modus bist.

Im NORMAL-Modus zeigt ? das Hilfe-Menü (Standard-Vim-Verhalten), nicht die Claude Code-Hilfe.

Validierung und Diagnose

Claude Code validiert deine Keybindings-Datei automatisch und warnt dich bei:

• Parse-Fehlern in JSON-Syntax oder Struktur
• Ungültigen Kontext-Namen, die nicht zu den 17 unterstützten Kontexten passen
• Reservierten Shortcut-Konflikten, wenn du Ctrl+C oder Ctrl+D neu belegen willst
• Terminal-Multiplexer-Konflikten bei Ctrl+B, Ctrl+A und Ctrl+Z
• Doppelten Bindings im selben Kontext

Führe /doctor aus, um alle Keybinding-Warnungen auf einmal zu sehen. Das ist der schnellste Weg zu diagnostizieren, warum ein Shortcut nicht wie erwartet funktioniert.

Praktische Konfigurationsbeispiele

Hier sind reale Konfigurationen, die häufige Probleme lösen.

VS Code-Nutzerkonfiguration

Kommst du aus VS Code und willst vertraute Shortcuts:

{
  "$schema": "https://platform.claude.com/docs/schemas/claude-code/keybindings.json",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+k ctrl+s": "chat:stash",
        "ctrl+shift+p": "chat:modelPicker",
        "ctrl+g": "chat:externalEditor"
      }
    },
    {
      "context": "Global",
      "bindings": {
        "ctrl+shift+t": "app:toggleTodos"
      }
    }
  ]
}

tmux-freundliches Setup

Vermeidet alle tmux-Präfix-Konflikte:

{
  "$schema": "https://platform.claude.com/docs/schemas/claude-code/keybindings.json",
  "bindings": [
    {
      "context": "Task",
      "bindings": {
        "ctrl+b": null,
        "ctrl+shift+b": "task:background"
      }
    }
  ]
}

Minimales Ablenkungssetup

Deaktiviere Shortcuts, die du versehentlich immer wieder drückst:

{
  "$schema": "https://platform.claude.com/docs/schemas/claude-code/keybindings.json",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null,
        "ctrl+u": null
      }
    }
  ]
}

Chord-basiertes Power-User-Setup

Chords nutzen, um weniger häufig verwendete Funktionen zu erreichen, ohne einzelne Tasten zu blockieren:

{
  "$schema": "https://platform.claude.com/docs/schemas/claude-code/keybindings.json",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+k ctrl+t": "chat:thinkingToggle",
        "ctrl+k ctrl+m": "chat:modelPicker",
        "ctrl+k ctrl+e": "chat:externalEditor"
      }
    }
  ]
}

So bleiben deine meistgenutzten Einzeltasten-Shortcuts sauber, während du trotzdem schnellen Zugriff auf alles andere hast.

Deine eigene Konfiguration aufbauen

Fang klein an. Versuche nicht, alles auf einmal umzumappen. Hier ist ein praktischer Ansatz:

1. /keybindings ausführen, um die Konfigurationsdatei zu erstellen
2. Deine top 3 Schmerzpunkte identifizieren (kollidierte Shortcuts, fehlende Shortcuts, versehentliche Auslöser)
3. Diese zuerst beheben mit gezielten Bindings
4. /doctor ausführen, um zu validieren
5. Claude Code für eine vollständige Session nutzen und verbleibende Reibung notieren
6. Iterieren durch Hinzufügen oder Anpassen von Bindings nach Bedarf

Das Ziel ist nicht, jeden möglichen Shortcut anzupassen. Es geht darum, die Reibung zwischen deinem Muskelgedächtnis und Claude Codes Verhalten zu beseitigen. Die meisten Entwickler brauchen nur 5-10 eigene Bindings, um sich völlig zu Hause zu fühlen. ClaudeFasts Code Kit kommt mit einer voreingestellten settings.json, die keybinding-freundliche Standardwerte zusammen mit Slash-Befehlen und Hooks enthält, damit du mit einer soliden Basis startest statt von Null.

Wenn du ein umfassenderes Claude Code-Setup aufbaust, arbeiten deine Keybindings neben CLAUDE.md-Konfiguration und eigenen Slash-Befehlen zusammen, um eine vollständig personalisierte Umgebung zu schaffen. Die Keybindings steuern die physische Schnittstelle. Die Konfigurationsdateien steuern die Verhaltensschnittstelle. Zusammen lassen sie Claude Code so anfühlen, als wäre es speziell für deinen Workflow gebaut worden.