Raccourcis clavier Claude Code : guide pratique

Les raccourcis clavier de Claude Code font gagner du temps seulement s’ils traversent correctement le système, le terminal, l’éditeur et les outils d’accessibilité. Une combinaison qui fonctionne sur un Mac peut être capturée par Windows Terminal. Une touche disponible dans Claude Code peut être interceptée par VS Code, tmux, un IME, un lecteur d’écran ou le système d’exploitation. Une bonne documentation de raccourcis commence donc par la vérification, pas par la mémorisation.

Cette mise à jour du 2 juin 2026 explique comment découvrir les raccourcis actuels de Claude Code, gérer les conflits avec terminal et éditeur, choisir entre custom slash commands et raccourcis OS, documenter keybindings.json, préparer une cheat sheet d’onboarding, intégrer l’accessibilité, distinguer Windows et macOS, et écrire des prompts sûrs pour faire maintenir ces documents par Claude Code.

Les détails changent avec les versions. Vérifiez toujours les touches exactes dans votre session et avec les sources officielles : Claude Code keybindings, interactive mode, commands, slash commands et IDE integrations. Pour les habitudes associées, voyez aussi les astuces de productivité Claude Code et le guide command palette.

Commencer par l’état actuel

Le premier geste utile n’est pas d’apprendre une combinaison. Il consiste à ouvrir la configuration active. Claude Code fournit /keybindings pour afficher et modifier les raccourcis, et les personnalisations sont stockées dans ~/.claude/keybindings.json. Le command /doctor est aussi essentiel, car les limites du terminal font partie du problème. Si le terminal n’envoie pas une touche à Claude Code, changer Claude Code ne suffit pas.

Sous Windows PowerShell, commencez par ce contrôle.

claude --version
claude

# A saisir dans Claude Code:
# /status
# /keybindings
# /doctor

Sous macOS et Linux, gardez la même discipline. Notez la version de Claude Code, l’application terminal, l’OS, l’utilisation de VS Code ou de tmux. Sans ces informations, une table de touches devient vite impossible à auditer.

flowchart TD
  A["Touche appuyee"] --> B["Raccourci reserve par l OS"]
  B --> C["Traitement du terminal"]
  C --> D["Claude Code keybindings"]
  D --> E["Action chat, edition ou vue"]
  C --> F["Conflit tmux, IME ou editeur"]

Les raccourcis à apprendre en premier

Claude Code expose de nombreux raccourcis, mais l’onboarding doit commencer par ceux qui évitent les erreurs quotidiennes : interruption, envoi, saisie multiligne, nettoyage de l’écran, historique, éditeur externe et todos. Les exemples ci-dessous doivent être confirmés avec /keybindings.

Objectif	Exemples à vérifier	Attention pratique
Interrompre le travail	Ctrl+C	Ne pas changer légèrement une mémoire d’urgence
Envoyer l’entrée	Enter	Les prompts longs demandent une habitude multiligne
Saisie multiligne	Shift+Enter, Ctrl+J	Certains terminaux demandent /terminal-setup
Nettoyer l’écran	Ctrl+L	Nettoie l’affichage, pas l’historique
Revoir l’historique	Ctrl+R, Ctrl+O	Vérifier le texte non envoyé avant de changer
Editeur externe	Ctrl+X Ctrl+E, parfois Ctrl+G	Plus sûr pour les prompts longs
Voir les todos	Ctrl+T	Confirmer qu’il n’a pas été modifié localement

Pour un nouveau membre, une longue liste de touches est moins utile qu’un rituel : lancer /keybindings, lancer /doctor, tester la saisie multiligne, ouvrir l’éditeur externe et savoir interrompre proprement.

Windows, macOS, VS Code et terminal

Sur macOS, Option peut jouer le rôle de Meta, mais la préférence du terminal peut aussi l’utiliser pour saisir des caractères spéciaux. Sous Windows, Ctrl, Alt et la touche Windows changent de comportement selon le terminal et l’application. Sous Linux, le gestionnaire de fenêtres peut intercepter des combinaisons avant le terminal.

VS Code ajoute le problème du focus. Dans le terminal intégré, une touche peut atteindre Claude Code. Dans l’éditeur, elle peut exécuter une commande VS Code. Une cheat sheet sérieuse précise donc “focus dans Claude Code” ou “focus dans VS Code”, au lieu de lister des touches hors contexte.

Trois décisions d’équipe réduisent les collisions :

• Choisir le terminal recommandé pour l’onboarding, par exemple Windows Terminal ou iTerm2.
• Décider si la saisie multiligne standard passe par Shift+Enter ou Ctrl+J.
• Documenter le passage entre VS Code, terminal intégré et Claude Code.

L’accessibilité doit rester dans le même document. Lecteur d’écran, IME, bureau distant ou clavier adapté peuvent rendre des combinaisons complexes peu fiables. Gardez des alternatives : menus, slash commands, éditeur externe et checklists. Le guide accessibilité avec Claude Code donne plus de contexte.

Garder keybindings.json minimal

Les custom keybindings sont utiles, mais trop de modifications cassent la cohérence avec la documentation officielle et les explications des collègues. Au début, limitez-vous à deux cas : désactiver une touche qui entre en conflit avec votre environnement ou ajouter un chemin sûr vers une action très fréquente.

Voici un exemple minimal de ~/.claude/keybindings.json. Il suit la structure documentée, associe Ctrl+E à l’éditeur externe et désactive Ctrl+U dans Chat. Si votre terminal ou shell utilise déjà Ctrl+E, choisissez une autre combinaison.

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

Chaque binding doit avoir une raison. Les raccourcis d’interruption, comme Ctrl+C, ne doivent pas être modifiés sans test réel. Avant de proposer un défaut d’équipe, validez Windows, macOS, VS Code intégré et tmux.

Ce PowerShell vérifie si un fichier custom existe déjà.

$path = Join-Path $HOME ".claude\keybindings.json"

if (Test-Path $path) {
  Get-Item $path | Select-Object FullName, LastWriteTime
} else {
  "No custom keybindings.json found."
}

Réserver les workflows aux slash commands

Un raccourci clavier doit déclencher une action d’interface ou une petite opération. Un workflow de revue, test, documentation ou publication doit plutôt devenir une slash command ou une skill. C’est plus visible, plus facile à relire et moins dangereux.

Par exemple, la revue des docs de raccourcis peut devenir une skill de projet.

$dir = ".claude\skills\shortcut-review"
New-Item -ItemType Directory -Force $dir | Out-Null

@'
---
description: Review Claude Code shortcut docs for this repository.
---

Check the current Claude Code shortcuts before editing docs.

1. Ask the user to run `/keybindings` and `/doctor`.
2. Compare Windows, macOS, VS Code, and terminal notes.
3. Do not invent exact keybindings that are not documented.
4. Keep destructive workflows behind explicit prompts.
5. End with changed files, checks, and residual risk.
'@ | Set-Content -Encoding utf8 "$dir\SKILL.md"

Si cette skill peut éditer des fichiers ou exécuter Git, reliez-la au guide des permissions Claude Code pour garder les approbations explicites.

Cas d’usage concrets

Premier cas : onboarding. Les 30 premières minutes doivent couvrir /keybindings, /doctor, la saisie multiligne, l’éditeur externe, le nettoyage écran, l’historique et l’interruption. C’est plus utile qu’une grande table.

Deuxième cas : revue longue. Sécurité, accessibilité, CTA, tests et risque résiduel ne se rédigent pas bien en une ligne. Ouvrez l’éditeur externe, écrivez le périmètre, les interdits, les commandes de vérification et le format de sortie. Le checklist de revue Claude Code est un bon complément.

Troisième cas : travail avec VS Code. Vous pouvez envoyer une sélection à Claude Code, recevoir un plan, lire le diff dans VS Code puis lancer les tests dans le terminal. La cheat sheet doit indiquer quelle application a le focus.

Quatrième cas : accessibilité. Avec lecteur d’écran, IME, bureau distant ou clavier personnalisé, une combinaison complexe peut échouer. Slash commands, menus, éditeur externe et checklists sont des chemins nécessaires.

Pièges fréquents

Le piège le plus grave est de réassigner Ctrl+C parce qu’il semble disponible. L’interruption doit rester prévisible. Si vous la changez, documentez pourquoi et testez des tool calls longs.

Le deuxième piège est d’ignorer tmux et les raccourcis du terminal. Ctrl+B, Ctrl+Shift+T et les combinaisons Alt sont souvent capturés avant Claude Code.

Le troisième piège est la documentation périmée. Mettez la date de mise à jour près de la cheat sheet et placez /keybindings et /doctor au-dessus du tableau.

Le quatrième piège est d’attacher commit, push, deploy ou changement de monétisation à une seule touche. Les actions destructives doivent rester explicites.

Prompt sûr et cheat sheet

Utilisez ce prompt pour faire maintenir la documentation par Claude Code.

You are updating our Claude Code keyboard shortcut guide.

Scope:
- Read only the target article and related docs.
- Preserve slug, heroImage, and existing internal links unless broken.
- Verify current shortcut facts against official Claude Code docs.
- Treat exact keybindings as version-sensitive.

Required content:
- How to open /keybindings and run /doctor.
- Windows, macOS, VS Code, terminal, tmux, and IME conflicts.
- keybindings.json example with a small safe change.
- 3 or more practical use cases.
- Concrete failure modes and accessibility notes.
- Final verification note with commands run and residual risk.

Do not:
- Invent undocumented shortcut details.
- Map destructive actions to one key.
- Remove monetization CTA, product links, or training links.

Pour l’onboarding, commencez avec ce bloc Markdown.

# Claude Code shortcuts onboarding

Update date: 2026-06-02
Before memorizing keys, run:

1. `/status`
2. `/keybindings`
3. `/doctor`

Daily keys to confirm:

| Situation | What to check |
| --- | --- |
| Stop current work | Confirm the interrupt key in `/keybindings` |
| Long prompt | Use external editor before sending |
| Multiline prompt | Test Shift+Enter and Ctrl+J |
| Screen is noisy | Use the clear-screen shortcut |
| Need old context | Open conversation history |
| VS Code workflow | Note which app has focus first |

Rule:
If your terminal, OS, or screen reader uses the same key,
do not force the Claude Code shortcut. Choose a safer route.

CTA et résultat pratique

Pour pratiquer seul, commencez par la cheat sheet gratuite Claude Code. Pour des prompts et modèles réutilisables, consultez les produits ClaudeCodeLab. Pour standardiser terminal, CLAUDE.md, permissions et revue dans une équipe, utilisez la formation et consultation Claude Code.

Dans les essais de Masa, le gain venait moins de nouvelles touches que de l’habitude de vérifier /keybindings et /doctor avant d’écrire. Dans Windows Terminal et le terminal intégré VS Code, confirmer la saisie multiligne et l’éditeur externe a réduit les envois accidentels de longs prompts. Le risque restant est la dérive des versions : Claude Code, les terminaux et les intégrations IDE peuvent changer, donc chaque refresh doit relire la documentation officielle et le keymap local.