Personnaliser les raccourcis clavier

Personnalisez les raccourcis clavier dans Claude Code avec un fichier de configuration des liaisons de touches.

Claude Code prend en charge les raccourcis clavier personnalisables. Exécutez /keybindings pour créer ou ouvrir votre fichier de configuration à ~/.claude/keybindings.json.

Fichier de configuration

Le fichier de configuration des liaisons de touches est un objet avec un tableau bindings. Chaque bloc spécifie un contexte et une carte des séquences de touches aux actions.

Cet exemple lie Ctrl+E pour ouvrir un éditeur externe dans le contexte de chat, et délié Ctrl+U :

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

Contextes

Chaque bloc de liaison spécifie un contexte où les liaisons s'appliquent :

Actions disponibles

Les actions suivent un format namespace:action, tel que chat:submit pour envoyer un message ou app:toggleTodos pour afficher la liste des tâches. Chaque contexte a des actions spécifiques disponibles.

Actions d'application

Actions disponibles dans le contexte Global :

Actions d'historique

Actions pour naviguer dans l'historique des commandes :

Actions de chat

Actions disponibles dans le contexte Chat :

*Sous Windows sans mode VT (Node <24.2.0/<22.17.0, Bun <1.2.23), la valeur par défaut est Meta+M.

Actions d'autocomplétion

Actions disponibles dans le contexte Autocomplete :

Actions de confirmation

Actions disponibles dans le contexte Confirmation :

Actions de permission

Actions disponibles dans le contexte Confirmation pour les dialogues de permission :

Actions de transcription

Actions disponibles dans le contexte Transcript :

Actions de recherche d'historique

Actions disponibles dans le contexte HistorySearch :

Actions de tâche

Actions disponibles dans le contexte Task :

Actions de thème

Actions disponibles dans le contexte ThemePicker :

Actions d'aide

Actions disponibles dans le contexte Help :

Actions d'onglets

Actions disponibles dans le contexte Tabs :

Actions de pièces jointes

Actions disponibles dans le contexte Attachments :

Actions de pied de page

Actions disponibles dans le contexte Footer :

Actions du sélecteur de message

Actions disponibles dans le contexte MessageSelector :

Actions de diff

Actions disponibles dans le contexte DiffDialog :

La vue détaillée du diff lie également les touches de style paginateur aux actions de défilement standard. Ces liaisons font partie du contexte DiffDialog et s'appliquent uniquement dans la vue détaillée ; les valeurs par défaut du contexte Scroll listées sous Actions de défilement sont inchangées.

Actions du sélecteur de modèle

Actions disponibles dans le contexte ModelPicker :

Actions de sélection

Actions disponibles dans le contexte Select :

Actions de plugin

Actions disponibles dans le contexte Plugin :

Actions des paramètres

Actions disponibles dans le contexte Settings :

Actions du docteur

Actions disponibles dans le contexte Doctor :

Actions vocales

Actions disponibles dans le contexte Chat lorsque la dictée vocale est activée :

Actions de défilement

Actions disponibles dans le contexte Scroll lorsque le rendu plein écran est activé :

Syntaxe des séquences de touches

Modificateurs

Utilisez les touches de modification avec le séparateur + :

• ctrl ou control - Touche Contrôle
• shift - Touche Maj
• alt, opt, option, ou meta - Touche Alt sur Windows et Linux, touche Option sur macOS
• cmd, command, super, ou win - Touche Commande sur macOS, touche Windows sur Windows, touche Super sur Linux

Le groupe cmd n'est détecté que dans les terminaux qui signalent le modificateur Super, comme ceux prenant en charge le protocole clavier Kitty ou le mode modifyOtherKeys de xterm. La plupart des terminaux ne l'envoient pas, donc utilisez ctrl ou meta pour les liaisons que vous voulez que fonctionnent partout.

Par exemple :

ctrl+k          Ctrl + K
shift+tab       Maj + Tab
meta+p          Option + P sur macOS, Alt + P ailleurs
ctrl+shift+c    Plusieurs modificateurs

Lettres majuscules

Une lettre majuscule autonome implique Maj. Par exemple, K est équivalent à shift+k. Ceci est utile pour les liaisons de style vim où les touches majuscules et minuscules ont des significations différentes.

Les lettres majuscules avec des modificateurs (par exemple, ctrl+K) sont traitées comme stylistiques et n'impliquent pas Maj : ctrl+K est identique à ctrl+k.

Accords

Les accords sont des séquences de touches séparées par des espaces :

ctrl+k ctrl+s   Appuyez sur Ctrl+K, relâchez, puis Ctrl+S

Touches spéciales

• escape ou esc - Touche Échappement
• enter ou return - Touche Entrée
• tab - Touche Tab
• space - Barre d'espace
• up, down, left, right - Touches fléchées
• backspace, delete - Touches de suppression

Délier les raccourcis par défaut

Définissez une action sur null pour délier un raccourci par défaut :

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

Cela fonctionne également pour les liaisons d'accords. Délier tous les accords qui partagent un préfixe libère ce préfixe pour une utilisation comme liaison à touche unique :

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": null,
        "ctrl+x": "chat:newline"
      }
    }
  ]
}

Si vous déliez certains accords mais pas tous sur un préfixe, appuyer sur le préfixe entre toujours en mode d'attente d'accord pour les liaisons restantes.

Raccourcis réservés

Ces raccourcis ne peuvent pas être reliés :

Conflits de terminal

Certains raccourcis peuvent entrer en conflit avec les multiplexeurs de terminal :

Interaction du mode Vim

Lorsque le mode vim est activé via /config → Mode Éditeur, les liaisons de touches et le mode vim fonctionnent indépendamment :

• Mode Vim gère l'entrée au niveau de la saisie de texte (mouvement du curseur, modes, motions)
• Liaisons de touches gèrent les actions au niveau du composant (basculer les tâches, soumettre, etc.)
• La touche Échappement en mode vim bascule INSERT en mode NORMAL ; elle ne déclenche pas chat:cancel
• La plupart des raccourcis Ctrl+touche passent par le mode vim au système de liaison de touches
• En mode NORMAL vim, ? affiche le menu d'aide (comportement vim)
• En mode NORMAL vim, / ouvre la recherche dans l'historique, identique à Ctrl+R en mode standard

Validation

Claude Code valide vos liaisons de touches et affiche des avertissements pour :

• Erreurs d'analyse (JSON invalide ou structure)
• Noms de contexte invalides
• Conflits de raccourcis réservés
• Conflits de multiplexeur de terminal
• Liaisons en double dans le même contexte

Exécutez /doctor pour voir les avertissements de liaison de touches.