CLAUDE_CODE_ACCESSIBILITY, prefersReducedMotion ou theme a partir da tabela Configurações de acessibilidade. O modo leitor de tela adapta apenas a interface do terminal, portanto você não precisa dele no painel de chat da extensão VS Code. No Claude Code v2.1.236 ou posterior, a extensão anuncia atividade de conversa para seu leitor de tela lá sem nenhuma configuração.
Ativar o modo leitor de tela
Escolha o método que corresponde à frequência com que você usa um leitor de tela:- Para uma sessão: execute
claude --ax-screen-reader. - Para sessões iniciadas a partir de um shell: defina a variável de ambiente
CLAUDE_AX_SCREEN_READERcomo1. Em Bash ou Zsh, executeexport CLAUDE_AX_SCREEN_READER=1. Em PowerShell, execute$env:CLAUDE_AX_SCREEN_READER = "1". Adicione essa linha ao seu perfil de shell para mantê-la para shells futuros. - Para cada sessão na máquina: adicione
"axScreenReader": trueao seu arquivo de configurações. A configuração se aplica em qualquer terminal, incluindo o terminal integrado do VS Code.
--ax-screen-reader sobre a variável de ambiente CLAUDE_AX_SCREEN_READER, e a variável sobre a configuração axScreenReader.
Se você usar Claude Code via SSH, defina a variável de ambiente ou configuração na máquina remota onde Claude Code é executado.
A primeira linha que Claude Code imprime confirma o modo: [Screen Reader Mode: on via flag], [Screen Reader Mode: on via env], ou [Screen Reader Mode: on via settings].
Desativar o modo leitor de tela
Reverta o método que ativou o modo: inicie sem a flag, desdefina a variável de ambiente ou definaaxScreenReader como false. Se você definir CLAUDE_AX_SCREEN_READER como 0, Claude Code mantém o modo desativado mesmo quando a configuração é true.
Configurações de acessibilidade
A tabela lista cada opção de acessibilidade, se você a define como um sinalizador, uma variável de ambiente ou uma configuração, e o que ela altera.O que seu leitor de tela ouve
No modo leitor de tela, Claude Code escreve texto simples:- Sem caracteres de desenho de caixa para a interface
- Sem pistas apenas de cor
- Sem redesenhos de conteúdo que não mudou. Spinners de progresso são renderizados como texto estático
- Tabelas nas respostas do Claude são lidas como sentenças
Header: valueem vez de uma grade com caracteres de caixa - Diffs são lidos como texto simples, linha por linha, com
+e-marcando as linhas adicionadas e removidas, para que você possa ouvir a alteração proposta em um prompt de aprovação de edição de arquivo antes de respondê-lo
tui no modo leitor de tela. Além das sessões em background anexadas listadas em Limitações conhecidas, ele imprime texto rolável em vez de renderização em tela cheia.
Depois que Claude Code imprime a linha de confirmação na inicialização, ele aguarda 3 segundos antes de desenhar o prompt, para que seu leitor de tela possa terminar a linha. Pressione qualquer tecla para encerrar a espera. Para alterar o comprimento da espera, defina CLAUDE_AX_STARTUP_QUIET_MS.
Cada mensagem na transcrição começa com um rótulo que seu leitor de tela anuncia, nomeando o que é: suas mensagens, respostas e pensamentos do Claude, atividade de ferramentas, erros e avisos, e prompts. Os rótulos também são pesquisáveis, para que você possa pular entre seções da transcrição pesquisando o scrollback do seu terminal:
Claude Code mantém o cursor do terminal no acento de entrada, para que o comando de leitura de linha atual do seu leitor de tela leia o prompt que você está editando.
Conforme você digita no final da linha de entrada, ou pressiona
Backspace lá, Claude Code escreve apenas os caracteres que mudam. Seu leitor de tela ecoa apenas esses caracteres.
Quando você deleta uma palavra ou uma linha com um dos atalhos de edição de texto, Claude Code anuncia o texto deletado:
- Deletando palavras com
Ctrl+WouAlt+D, ou comOption+Deleteno macOS ouCtrl+Backspaceno Windows - Deletando até o início da linha com
Ctrl+UouCmd+Backspace - Deletando até o final da linha com
Ctrl+K
Shift+Tab, Claude Code anuncia o modo de permissão em que você chega, como [plan mode on] ou [accept edits on]. Claude Code imprime o anúncio uma vez e não o repete em redesenhos posteriores.
Ler a saída anterior sem perder seu lugar
Se seu leitor de tela volta para o prompt enquanto você está lendo a saída anterior, ele está seguindo o cursor do terminal. Claude Code move o cursor do terminal de volta para o prompt sempre que escreve um novo texto. Para manter seu lugar enquanto lê, impeça que seu leitor de tela siga o cursor do terminal. No NVDA, pressioneNVDA+6 para impedir que o cursor de revisão siga o cursor do terminal. Pressione NVDA+6 novamente para reativar o acompanhamento.
Pular entre turnos
Claude Code emite marcadores de integração de shell OSC 133 nos limites de turno, para que a tecla de pulo para prompt anterior do seu terminal se mova entre turnos sem ler toda a transcrição:- iTerm2: Cmd+Shift+Up
- Terminal VS Code: Ctrl+Up no Windows, Cmd+Up no macOS
- Windows Terminal: nenhuma tecla por padrão; vincule a ação
scrollToMarkem suas configurações - Kitty e Ghostty: verifique a documentação do terminal para sua tecla de pulo para prompt
you: em vez disso.
Responda a menus e prompts
No modo leitor de tela, menus que você normalmente navegaria com as teclas de seta, incluindo prompts de permissão, tornam-se listas numeradas. Claude Code anuncia cada opção como uma linha numerada, seguida por um promptSelect with numbers que nomeia o intervalo válido. Digite o número da opção que deseja e pressione Enter.
- Pressione Escape para cancelar um menu cujo prompt termina com
or Escape to cancel. - Se você digitar um número que não está na lista, Claude Code anuncia o intervalo válido e permite que você tente novamente.
/effort, que é um controle deslizante fora do modo leitor de tela, torna-se o mesmo tipo de lista numerada.
Os prompts sim-ou-não pedem uma resposta digitada em vez de um menu de duas opções. Responda y ou n e pressione Enter. yes e no também funcionam.
Ouça quando Claude Code precisa de você
No modo leitor de tela, Claude Code toca o sino do terminal quando precisa de sua atenção, para que você não tenha que ficar verificando a transcrição. O sino toca quando:- Claude termina uma resposta
- Um prompt ou diálogo precisa de sua resposta, como um prompt de permissão
- Uma ferramenta que foi executada por mais de 5 segundos termina
preferredNotifChannel como "terminal_bell" para obter um sino semelhante quando Claude estiver aguardando você.
Limitações conhecidas
Alguns comportamentos não são adaptados para o modo leitor de tela:- O modo leitor de tela não é ativado automaticamente quando um leitor de tela está em execução.
- Claude Code não anuncia uma mudança de modo de permissão feita com um comando, como entrar no modo de planejamento com
/plan. - Anexar a uma sessão de fundo com
claude attachou da visualização de agente entra na tela alternativa do terminal, que não tem scrollback nativo. Este é o mesmo comportamento que outras sessões anexadas. Para sair, pressione Left Arrow em um prompt vazio, ou Ctrl+Z se um diálogo tiver foco. - Claude Code anuncia custos no resumo que imprime na saída, não por turno.
- O modo leitor de tela não altera modo não interativo com a flag
-p. O modo não interativo já escreve texto simples e permanece uma alternativa para scripts.