Aller au contenu principal

Accessibilité

Débutant

Claude Code s'exécute dans le terminal — une interface textuelle, ce qui est un bon point de départ pour l'accessibilité, mais le rendu par défaut s'appuie sur la couleur, les glyphes de tracé de cadres et les indicateurs animés que les lecteurs d'écran et certaines configurations motrices gèrent mal. Depuis juillet 2026, il existe un mode lecteur d'écran dédié, ainsi que des réglages pour l'ergonomie vim et le comportement souris/défilement. Cette page rassemble les leviers qui rendent le CLI utilisable avec les technologies d'assistance.

What you'll learn
  • Comment activer le mode lecteur d'écran — trois façons, et ce que chacune change
  • Ce que le mode lecteur d'écran fait réellement à la transcription, aux tableaux et aux invites de permission
  • Comment remapper les touches du mode insertion vim (jj → Échap) pour réduire la fatigue des mains
  • Comment contrôler ou désactiver les clics souris et l'accélération du défilement en plein écran
  • Où se trouvent les thèmes à fort contraste, et comment signaler une lacune d'accessibilité

Mode lecteur d'écran​

Le mode lecteur d'écran remplace l'interface TUI décorative par un rendu en texte brut que les technologies d'assistance peuvent lire proprement. Activez-le de trois façons — un flag ponctuel, une variable d'environnement pour chaque session, ou un réglage persistant.

Guided walkthrough1 of 3
  1. Lancez avec le flag : claude --ax-screen-reader. Rien d'autre ne change — même session, sortie plus simple.

Mode lecteur d'écran persistant (~/.claude/settings.json)

{
"axScreenReader": true
}

Ce que cela change​

Pro tip
  • Un rendu en texte brut remplace le TUI stylisé pour que les lecteurs d'écran reçoivent un texte propre et linéaire.
  • Les glyphes décoratifs sont masqués aux lecteurs d'écran au lieu d'être lus comme du bruit.
  • Les symboles de la transcription sont annoncés sous forme d'étiquettes courtes plutôt que de caractères bruts.
  • Les tableaux imbriqués sont lus comme des lignes En-tête : valeur. — aplatis en rangées prononçables.
  • Les changements de mode de permission sont annoncés à voix haute lorsque vous alternez les modes avec Maj+Tab.

Ce dernier point compte : alterner les modes de permission avec Maj+Tab est une interaction essentielle de Claude Code (voir Permissions), et le mode lecteur d'écran énonce le nouveau mode à voix haute pour que vous sachiez toujours si vous êtes en mode plan, accept-edits ou auto sans lire la ligne d'état.

Ergonomie vim : remapper les touches du mode insertion​

Si vous utilisez le mode vim et qu'atteindre Échap fatigue votre main, mappez plutôt une séquence de deux touches en mode insertion. Le réglage vimInsertModeRemaps transforme des séquences comme jj en Escape, pour que vous ne quittiez jamais la rangée de repos.

Mapper jj vers Échap en mode vim (settings.json)

{
"editorMode": "vim",
"vimInsertModeRemaps": {
  "jj": "Escape"
}
}
Watch out
  • Le remap ne se déclenche qu'en mode insertion, donc taper jj comme texte littéral nécessite une brève pause entre les touches — choisissez une séquence que vous tapez rarement vite (jj et kj sont des choix courants).
  • editorMode: vim active les raccourcis vim ; vimInsertModeRemaps ne prend effet que lorsque le mode vim est activé.

Contrôles souris et défilement​

Les menus en plein écran acceptent désormais les clics souris — y compris les menus à sélection multiple et les lignes de saisie « Autre » — ce qui aide si la navigation au clavier uniquement est pénible. Deux réglages ajustent le comportement du pointeur pour la sensibilité au mouvement ou la précision :

RéglageCe qu'il fait
CLAUDE_CODE_DISABLE_MOUSE_CLICKSDésactive le clic, le glisser et le survol de la souris tout en conservant le défilement à la molette — utile si des clics parasites vous dérangent.
wheelScrollAccelerationEnabledRéglez sur false pour désactiver l'accélération du défilement à la molette en plein écran, pour un défilement plus stable et prévisible.

Défilement plus stable, sans clics accidentels (settings.json)

{
"wheelScrollAccelerationEnabled": false,
"env": {
  "CLAUDE_CODE_DISABLE_MOUSE_CLICKS": "1"
}
}

Contraste et thèmes​

Pour les utilisateurs malvoyants, le contraste du terminal est le premier levier. Claude Code fournit des thèmes clair et sombre et prend en charge des thèmes personnalisés que vous construisez depuis /theme ou fournissez dans un plugin — vous pouvez ainsi régler une palette à fort contraste qui répond à vos besoins. Voir Réglages pour savoir où le choix de thème est stocké, et Styles de sortie si vous voulez aussi une prose plus simple et moins décorée (les styles Explicatif et Apprentissage sont plus verbeux, pas moins — pour une sortie concise, restez sur Default).

:::tip Au-delà du CLI Le mode lecteur d'écran couvre le terminal. Pour une interaction mains libres avec Claude de façon plus large, le Mode vocal dans l'application vous permet de parler et d'écouter, et le playbook Accessibilité couvre l'usage de Claude lui-même comme outil d'assistance — simplifier du texte, construire des listes de contrôle et adapter l'information à votre façon de lire. :::

Vérifiez vos connaissances

0/3
  1. Laquelle de ces options active le mode lecteur d'écran automatiquement pour chaque session ?
  2. En mode lecteur d'écran, comment les tableaux imbriqués sont-ils lus ?
  3. Que permet vimInsertModeRemaps ?
Pro tip
  • Mode lecteur d'écran : flag --ax-screen-reader (une fois), CLAUDE_AX_SCREEN_READER=1 (par shell), ou axScreenReader: true (persistant).
  • Il met en texte brut la transcription, masque les glyphes décoratifs, aplatit les tableaux et énonce les changements de mode de permission sur Maj+Tab.
  • vimInsertModeRemaps réduit la fatigue des mains ; CLAUDE_CODE_DISABLE_MOUSE_CLICKS et wheelScrollAccelerationEnabled ajustent le comportement du pointeur.
  • Les thèmes personnalisés vous offrent des palettes à fort contraste ; le Mode vocal et le playbook Accessibilité couvrent le reste.

Suite​