Skip to main content
Claude Code dispose d’un mode lecteur d’écran qui remplace son interface de terminal visuelle par du texte simple et linéaire. Au lieu de boîtes, d’animations de progression et de redessinages sur place, Claude Code imprime des lignes étiquetées qu’un lecteur d’écran tel que VoiceOver ou NVDA lit dans l’ordre. Vous pouvez maintenir une conversation complète, approuver les autorisations d’outils et examiner la sortie de bout en bout. Le mode lecteur d’écran est optionnel. Si vous utilisez une loupe d’écran, un mouvement réduit ou un thème adapté aux daltoniens au lieu d’un lecteur d’écran, définissez CLAUDE_CODE_ACCESSIBILITY, prefersReducedMotion ou theme à partir du tableau Paramètres d’accessibilité. Le mode lecteur d’écran adapte uniquement l’interface du terminal, vous n’en avez donc pas besoin dans le panneau de chat de l’extension VS Code. Sur Claude Code v2.1.236 ou version ultérieure, l’extension annonce l’activité de conversation à votre lecteur d’écran sans aucun paramètre.

​
Activer le mode lecteur d’écran

Choisissez la méthode qui correspond à la fréquence à laquelle vous utilisez un lecteur d’écran :
  • Pour une session : exécutez claude --ax-screen-reader.
  • Pour les sessions démarrées à partir d’un shell : définissez la variable d’environnement CLAUDE_AX_SCREEN_READER sur 1. Dans Bash ou Zsh, exécutez export CLAUDE_AX_SCREEN_READER=1. Dans PowerShell, exécutez $env:CLAUDE_AX_SCREEN_READER = "1". Ajoutez cette ligne à votre profil shell pour la conserver pour les shells futurs.
  • Pour chaque session sur la machine : ajoutez "axScreenReader": true à votre fichier de paramètres utilisateur. Le paramètre s’applique dans n’importe quel terminal, y compris le terminal intégré VS Code.
Si vous combinez les méthodes, Claude Code applique l’indicateur --ax-screen-reader sur la variable d’environnement CLAUDE_AX_SCREEN_READER, et la variable sur le paramètre axScreenReader. Si vous utilisez Claude Code via SSH, définissez la variable d’environnement ou le paramètre sur la machine distante où Claude Code s’exécute. La première ligne que Claude Code imprime confirme le mode : [Screen Reader Mode: on via flag], [Screen Reader Mode: on via env], ou [Screen Reader Mode: on via settings].

​
Désactiver le mode lecteur d’écran

Inversez la méthode qui a activé le mode : démarrez sans l’indicateur, supprimez la variable d’environnement ou définissez axScreenReader sur false. Si vous définissez CLAUDE_AX_SCREEN_READER sur 0, Claude Code maintient le mode désactivé même lorsque le paramètre est true.

​
Paramètres d’accessibilité

Le tableau énumère chaque option d’accessibilité, que vous la définissiez comme un drapeau, une variable d’environnement ou un paramètre, et ce qu’elle change.

​
Ce que votre lecteur d’écran entend

En mode lecteur d’écran, Claude Code écrit du texte plat :
  • Pas de caractères de dessin de boîte pour le chrome de l’interface
  • Pas d’indices basés sur la couleur uniquement
  • Pas de redessins du contenu qui n’a pas changé. Les barres de progression s’affichent sous forme de texte statique
  • Les tableaux dans les réponses de Claude se lisent comme des phrases Header: value au lieu d’une grille de caractères de boîte
  • Les diffs se lisent comme du texte brut, ligne par ligne, avec + et - marquant les lignes ajoutées et supprimées, afin que vous puissiez entendre la modification proposée dans une demande d’approbation de modification de fichier avant d’y répondre
Claude Code laisse tout ce qu’il imprime dans l’historique de votre terminal, afin que vous puissiez relire les tours précédents avec les commandes de révision de votre lecteur d’écran ou la recherche de votre terminal. Claude Code ignore le paramètre tui en mode lecteur d’écran. À part les sessions d’arrière-plan attachées listées sous Limitations connues, il imprime du texte défilant au lieu du rendu en plein écran. Après que Claude Code imprime la ligne de confirmation au démarrage, il attend 3 secondes avant de dessiner l’invite, afin que votre lecteur d’écran puisse terminer la ligne. Appuyez sur n’importe quelle touche pour terminer l’attente. Pour modifier la durée de l’attente, définissez CLAUDE_AX_STARTUP_QUIET_MS. Chaque message dans la transcription commence par une étiquette que votre lecteur d’écran annonce, nommant ce qu’il est : vos messages, les réponses et la réflexion de Claude, l’activité des outils, les erreurs et les avertissements, et les invites. Les étiquettes sont également consultables, afin que vous puissiez sauter entre les sections de la transcription en recherchant l’historique de votre terminal : Claude Code garde le curseur du terminal sur le curseur d’entrée, afin que la commande de lecture de la ligne actuelle de votre lecteur d’écran lise l’invite que vous modifiez. Au fur et à mesure que vous tapez à la fin de la ligne d’entrée, ou appuyez sur Backspace à cet endroit, Claude Code écrit uniquement les caractères qui changent. Votre lecteur d’écran ne répète que ces caractères. Lorsque vous supprimez un mot ou une ligne avec l’un des raccourcis d’édition de texte, Claude Code annonce le texte supprimé :
  • Suppression de mots avec Ctrl+W ou Alt+D, ou avec Option+Delete sur macOS ou Ctrl+Backspace sur Windows
  • Suppression jusqu’au début de la ligne avec Ctrl+U ou Cmd+Backspace
  • Suppression jusqu’à la fin de la ligne avec Ctrl+K
Lorsque vous parcourez les modes de permission avec Shift+Tab, Claude Code annonce le mode de permission sur lequel vous atterrissez, comme [plan mode on] ou [accept edits on]. Claude Code imprime l’annonce une fois et ne la répète pas lors des redessins ultérieurs.

​
Lire la sortie précédente sans perdre votre position

Si votre lecteur d’écran revient à l’invite pendant que vous lisez une sortie précédente, c’est qu’il suit le curseur du terminal. Claude Code ramène le curseur du terminal à l’invite chaque fois qu’il écrit du nouveau texte. Pour conserver votre position pendant la lecture, empêchez votre lecteur d’écran de suivre le curseur du terminal. Dans NVDA, appuyez sur NVDA+6 pour empêcher le curseur de revue de suivre le curseur du terminal. Appuyez à nouveau sur NVDA+6 pour réactiver le suivi.

​
Sauter entre les tours

Claude Code émet des marqueurs d’intégration de shell OSC 133 aux limites des tours, afin que la touche de saut à l’invite précédente de votre terminal se déplace entre les tours sans lire toute la transcription :
  • iTerm2 : Cmd+Shift+Up
  • Terminal VS Code : Ctrl+Up sur Windows, Cmd+Up sur macOS
  • Windows Terminal : pas de touche par défaut ; liez l’action scrollToMark dans ses paramètres
  • Kitty et Ghostty : consultez la documentation du terminal pour sa touche de saut à l’invite
macOS Terminal n’agit pas sur les marqueurs, et Claude Code ne les émet pas dans WezTerm. Dans ces terminaux, recherchez plutôt l’étiquette you: dans l’historique.

​
Répondre aux menus et aux invites

En mode lecteur d’écran, les menus que vous navigueriez normalement avec les touches fléchées, y compris les invites de permission, deviennent des listes numérotées. Claude Code annonce chaque option comme une ligne numérotée, puis une invite Select with numbers qui nomme la plage valide. Tapez le numéro de l’option que vous souhaitez et appuyez sur Entrée.
  • Appuyez sur Échap pour annuler un menu dont l’invite se termine par or Escape to cancel.
  • Si vous tapez un numéro qui ne figure pas sur la liste, Claude Code annonce la plage valide et vous permet de réessayer.
Le sélecteur /effort, qui est un curseur en dehors du mode lecteur d’écran, devient le même type de liste numérotée. Les invites oui-ou-non demandent une réponse tapée au lieu d’un menu à deux options. Répondez y ou n et appuyez sur Entrée. yes et no fonctionnent également.

​
Entendre quand Claude Code a besoin de vous

En mode lecteur d’écran, Claude Code sonne la cloche du terminal quand il a besoin de votre attention, afin que vous n’ayez pas à vérifier constamment la transcription. La cloche sonne quand :
  • Claude termine une réponse
  • Une invite ou une boîte de dialogue nécessite votre réponse, comme une invite de permission
  • Un outil qui a fonctionné plus longtemps que 5 secondes se termine
La cloche est l’alerte standard de votre terminal. Pour la désactiver, modifiez le paramètre de cloche dans votre application de terminal. En dehors du mode lecteur d’écran, définissez preferredNotifChannel sur "terminal_bell" pour obtenir une cloche similaire quand Claude attend votre réponse.

​
Limitations connues

Certains comportements ne sont pas adaptés au mode lecteur d’écran :
  • Le mode lecteur d’écran ne s’active pas automatiquement lorsqu’un lecteur d’écran est en cours d’exécution.
  • Claude Code n’annonce pas un changement de mode de permission effectué à l’aide d’une commande, comme l’entrée en mode plan avec /plan.
  • L’attachement à une session d’arrière-plan avec claude attach ou à partir de la vue agent entre dans l’écran alternatif du terminal, qui n’a pas de scrollback natif. C’est le même comportement que les autres sessions attachées. Pour en sortir, appuyez sur la flèche gauche sur une invite vide, ou Ctrl+Z si une boîte de dialogue a le focus.
  • Claude Code annonce les coûts dans le résumé qu’il imprime à la sortie, pas par tour.
  • Le mode lecteur d’écran ne change pas le mode non interactif avec l’indicateur -p. Le mode non interactif écrit déjà du texte simple et reste une alternative pour les scripts.

​
Signaler un problème

Si quelque chose ne fonctionne pas avec votre lecteur d’écran, votre loupe ou votre terminal, ouvrez un problème sur le suivi des problèmes Claude Code et mentionnez votre technologie d’assistance dans le titre. Incluez votre système d’exploitation, votre application de terminal et le nom et la version de votre technologie d’assistance dans le rapport.