Deepseek ArtifactsDeepseek Artifacts
Personnalisation clavier · Mis à jour pour v2.1.288

Claude Code Keybindings : remappez vos touches, mode Vim et raccourcis

Toutes les façons de changer le comportement du clavier dans Claude Code : modifier keybindings.json, activer le mode vim avec /vim ou /config, et retenir les raccourcis clavier par défaut qui comptent vraiment.

L'essentiel

  • Vos raccourcis vivent dans ~/.claude/keybindings.json — lancez /keybindings pour le créer et l'ouvrir. Les modifications s'appliquent dès l'enregistrement, sans redémarrage.
  • Les liaisons sont regroupées par contexte (Chat, Autocomplete, Agents, Scroll…) et associent une touche comme "ctrl+e" à une action comme chat:externalEditor. Assignez null à une touche pour la délier.
  • Mode vim : lancez /vim, ou /config → Editor mode → Espace → Entrée. Escape bascule entre INSERT/NORMAL, et le mode visuel (v/V) est arrivé en v2.1.118.
  • Certaines touches sont intouchables : Ctrl+C, Ctrl+D et Ctrl+M ne peuvent pas être remappés, et le préfixe Ctrl+B de tmux avale les raccourcis avant même que Claude Code les voie.

How to Enable Vim Editor in Claude Code CLI

Chaîne : ProgrammingKnowledge21:32

Ouvrir

Claude Code v2.1.118 — Vim Visual Mode & Custom Themes

Chaîne : Claude Code Updates0:41

Ouvrir

How to use Vim in Claude Code

Chaîne : HAMY LABS5:41

Ouvrir

Claude Code release notes — v2.1.118 & v2.1.288

Notes de version : github.com/anthropics/claude-code

Ouvrir

Keybindings — official documentation

Docs : code.claude.com/docs

Ouvrir

Les faits de cette page sont recoupés avec la documentation officielle des keybindings et les entrées v2.1.118 & v2.1.288 du changelog ; les captures d'écran proviennent des vidéos ci-dessus. Le comportement décrit correspond à Claude Code v2.1.288 (octobre 2026).

Les captures d'écran sont des images des vidéos citées, utilisées avec attribution et reliées à l'horodatage source à chaque étape.

Remapper les touches et activer le mode vim, pas à pas

Remapper les touches dans keybindings.json

  1. 1

    Lancez Claude Code et vérifiez votre installation

    Exécutez claude dans votre terminal pour démarrer une session. La personnalisation des touches et le mode vim sont des fonctions du CLI : tout se joue dans le même prompt. À partir de la v2.1.288, vous bénéficiez aussi des derniers raccourcis de la vue agents : recherche Ctrl+F et sauts de groupe Alt+↑/↓.

    Claude Code welcome screen in a Windows PowerShell terminal showing the session banner and an empty prompt before any keybindings are customized
    Une session Claude Code toute fraîche, prête à être personnalisée.Voir à 0:17
  2. 2

    Ouvrez keybindings.json avec /keybindings

    Tapez /keybindings dans le prompt. Si ~/.claude/keybindings.json n'existe pas encore, Claude Code le crée puis l'ouvre dans votre éditeur. Chaque changement enregistré est détecté automatiquement — aucun redémarrage nécessaire.

    Claude Code slash command menu filtering the command list after a forward slash is typed into the input box
    Le menu des commandes filtre à la frappe — /keybindings en fait partie.Voir à 0:34
  3. 3

    Associez une touche à une action dans un contexte

    Le fichier contient un tableau bindings regroupé par contexte — Chat, Autocomplete, Agents, Task, Scroll, etc. Chaque bloc associe une touche à un nom d'action : { "context": "Chat", "bindings": { "ctrl+e": "chat:externalEditor" } }. Ajoutez le champ $schema en tête de fichier et votre éditeur proposera l'autocomplétion de chaque action.

  4. 4

    Déliez avec null et enchaînez les chord

    Assignez null à une touche pour désactiver un comportement par défaut — "ctrl+s": null coupe la mise en attente de la saisie. Les chord s'écrivent avec des espaces : "ctrl+x ctrl+k" signifie presse Ctrl+X, puis Ctrl+K dans les trois secondes. Quelques combinaisons sont réservées et ne peuvent pas être remappées : Ctrl+C, Ctrl+D, Ctrl+M, Ctrl+[ et Ctrl+I.

Activer le mode vim

  1. 5

    Ouvrez le panneau de réglages avec /config

    Vous préférez un interrupteur à l'édition JSON à la main ? /config ouvre le panneau montré dans la vidéo, avec ses onglets Status, Config et Usage et une zone de recherche qui filtre la liste à mesure de la saisie.

    Claude Code /config settings panel listing Auto-compact, Todo list, Editor mode and Theme options in the terminal
    Le panneau /config liste chaque réglage, y compris Editor mode.Voir à 0:40
  2. 6

    Filtrez la liste sur Editor mode

    Tapez edit dans la recherche et la liste se réduit au réglage Editor mode. Par défaut, il affiche normal — l'édition façon readline de Claude Code, familière si vous venez de bash ou des keybindings Emacs.

    Claude Code config search filtered to the Editor mode setting showing its default normal value
    Editor mode démarre sur normal ; Espace le bascule.Voir à 1:08
  3. 7

    Appuyez sur Espace pour passer en vim

    La ligne Editor mode étant sélectionnée, appuyez sur Espace — la valeur passe de normal à vim. La ligne d'aide résume le contrat : Space pour changer, Enter pour enregistrer, / pour chercher, Esc pour annuler.

    Claude Code Editor mode setting switched from normal to vim in the /config panel
    Une pression sur Espace suffit pour choisir vim.Voir à 1:11
  4. 8

    Enregistrez et repérez -- INSERT --

    Appuyez sur Entrée pour enregistrer. Claude Code affiche "Set editor mode to vim" et le pied de page gagne le marqueur -- INSERT -- propre à vim. Le choix persiste d'une session à l'autre sur la même machine — il est stocké sous forme d'editorMode dans ~/.claude.json, un fichier d'exécution à ne pas symlinker dans vos dotfiles car il contient aussi les caches OAuth et l'état des sessions.

    Claude Code confirming Set editor mode to vim with the vim INSERT mode indicator in the footer
    Enregistré — le pied de page affiche l'indicateur -- INSERT -- de vim.Voir à 1:28
  5. 9

    Saisissez en insert mode, commandez en normal mode

    L'insert mode tape comme d'habitude. Escape bascule vers le normal mode : h, j, k, l déplacent le curseur, b et w sautent de mot en mot, d supprime, c modifie, r remplace. Relancer /vim désactive tout le mode. Les touches propres à vim ne se remappent pas via keybindings.json — vimInsertModeRemaps est le réglage dédié aux séquences d'INSERT comme jj.

  6. 10

    Sélectionnez du texte avec le mode visuel (v2.1.118+)

    Les anciens tutoriels signalent l'absence du mode visuel — c'est dépassé. La v2.1.118 a ajouté le mode visuel (v) et le mode visuel-ligne (V) avec sélection, opérateurs et retour visuel : v suivi d'un motion sélectionne des caractères, V suivi d'un motion des lignes entières, puis d, y ou c agit sur la sélection.

    Claude Code v2.1.118 release note card listing the vim visual mode commands v plus motion and V plus motion
    La v2.1.118 a apporté la sélection v et V au mode vim de Claude Code.Voir à 0:16

Les raccourcis par défaut à connaître par cœur

  1. 11

    Retenez les raccourcis par défaut qui comptent

    Shift+Tab cycle les modes de permission, Enter soumet, Ctrl+J insère un saut de ligne, Ctrl+L vide la saisie, Ctrl+R fouille l'historique, Ctrl+O bascule le transcript, Ctrl+T affiche les todos, Ctrl+B passe une tâche en arrière-plan et Ctrl+X Ctrl+K arrête les agents. Dans la vue agents (v2.1.288+), Ctrl+F retrouve une session par son nom et Alt+↑/↓ saute de groupe en groupe — et tout cela se remappe dans keybindings.json.

keybindings.json vs /config vs /vim : qui change quoi

Trois couches pilotent le comportement de vos touches dans Claude Code. Elles se superposent plus qu'elles ne concourent — choisissez celle qui correspond au changement visé.

  • 1keybindings.json remappe des actions précises. Déplacez chat:externalEditor sur ctrl+e, déliez chat:stash, ajoutez un chord ctrl+x. Fin, portable, et sans risque à conserver dans un gestionnaire de versions.
  • 2/config → Editor mode bascule tout le modèle d'édition entre normal (readline) et vim. Un seul interrupteur, enregistré à l'instant, valable pour toutes les sessions futures de la machine.
  • 3/vim fait exactement la même chose que l'interrupteur Editor mode — c'est le chemin le plus court, et la commande utilisée dans la walkthrough de HAMY LABS. Relancez-la pour revenir en normal.
  • 4Votre terminal intercepte certaines touches avant même que Claude Code les voie : le préfixe Ctrl+B de tmux, le Ctrl+A de GNU screen, et Ctrl+Z qui suspend le processus. Ces conflits se règlent au niveau du terminal, pas dans keybindings.json.
  • 5En mode vim, vimInsertModeRemaps est la seule façon de remapper un comportement vim comme jj vers escape — keybindings.json ne touche délibérément pas aux touches internes de vim.

Règle pratique : un raccourci gênant → keybindings.json ; une autre manière d'éditer tout court → le mode vim ; une touche qui n'arrive jamais → vérifiez d'abord le terminal.

Un raccourci ne marche pas ? Débuggez dans l'ordre

La plupart des plaintes sur les keybindings tiennent en cinq causes. Parcourez la liste avant de rééditer le fichier.

  • 1Rien ne change après édition : vérifiez que le fichier est bien ~/.claude/keybindings.json (pas settings.json) et que le JSON parse. Lancez Claude Code avec --debug pour faire remonter les avertissements de liaison, action mal orthographiée ou contexte inconnu.
  • 2Une touche refuse de se remapper : Ctrl+C, Ctrl+D, Ctrl+M (toujours Entrée), Ctrl+[ (toujours Escape) et Ctrl+I (toujours Tab) sont réservés. Les caractères imprimables saisis dans un champ vont à la saisie, pas aux liaisons.
  • 3Ctrl+B ou Ctrl+A n'arrive jamais : tmux et GNU screen les consomment comme préfixes. Remappez le raccourci dans keybindings.json ou changez le préfixe du multiplexeur.
  • 4Réutiliser un préfixe de chord échoue : si ctrl+x démarre plusieurs chord, vous devez délier tous les chord ctrl+x avant que ctrl+x seul fonctionne comme touche simple.
  • 5Les touches de vim ignorent vos liaisons : c'est voulu — le mode vim gère ses propres touches. Passez par vimInsertModeRemaps pour les séquences d'insert, et mettez Claude Code à jour si la sélection v ou V ne fait rien (v2.1.118 requis).

Pour restaurer un défaut, supprimez sa ligne de keybindings.json — c'est la suppression, et non une valeur « default » enregistrée, qui restaure la liaison d'origine de la touche.

FAQ keybindings de Claude Code

Plus de guides Claude Code