> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Use Claude Code com um leitor de tela
> Configure Claude Code para leitores de tela como VoiceOver e NVDA, além de configurações para ampliadores de tela, movimento reduzido e temas amigáveis para daltônicos.
Claude Code possui um modo leitor de tela que substitui sua interface de terminal visual por texto simples e linear. Em vez de caixas, animações de progresso e redesenhos no local, o modo imprime linhas rotuladas que um leitor de tela como VoiceOver ou NVDA lê em ordem, para que você possa manter uma conversa completa, aprovar permissões de ferramentas e revisar a saída de ponta a ponta.
O modo leitor de tela é opcional. Se você usar um ampliador de tela, movimento reduzido ou um tema amigável para daltônicos em vez de um leitor de tela, consulte [Configurações de acessibilidade além do modo leitor de tela](#accessibility-settings-beyond-screen-reader-mode).
O modo leitor de tela requer Claude Code v2.1.181 ou posterior. Versões anteriores rejeitam a flag `--ax-screen-reader` com `error: unknown option '--ax-screen-reader'`.
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_READER` como `1`. Em Bash ou Zsh, execute `export CLAUDE_AX_SCREEN_READER=1`; em PowerShell, execute `$env:CLAUDE_AX_SCREEN_READER = "1"`. Adicione a linha ao seu perfil de shell para cobrir todos os shells.
* Para cada sessão na máquina: adicione `"axScreenReader": true` ao seu [arquivo de configurações](/pt/settings). Isso cobre qualquer terminal, incluindo o terminal integrado do VS Code.
Os métodos são listados em ordem de precedência: a flag [`--ax-screen-reader`](/pt/cli-reference#cli-flags) substitui a variável de ambiente [`CLAUDE_AX_SCREEN_READER`](/pt/env-vars), que substitui a configuração [`axScreenReader`](/pt/settings#available-settings).
Se você usar Claude Code via SSH, defina a variável de ambiente ou configuração na máquina remota onde Claude Code é executado.
Quando o modo está ativado, a primeira coisa que Claude Code imprime é uma linha de confirmação nomeando o método que o ativou: `[Screen Reader Mode: on via flag]`, `[Screen Reader Mode: on via env]`, ou `[Screen Reader Mode: on via settings]`; este formato de nomeação de método requer Claude Code v2.1.206 ou posterior.
{/* max-version: 2.1.205 */}Versões anteriores imprimem `[Accessible screen reader mode: on]`.
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 defina `axScreenReader` como `false`. Definir `CLAUDE_AX_SCREEN_READER=0` mantém o modo desativado mesmo quando a configuração é `true`.
O que seu leitor de tela ouve
No modo leitor de tela, Claude Code escreve texto simples:
* sem caracteres de desenho de caixa para o chrome da 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 de Claude são lidas como sentenças `Header: value` em vez de uma grade de caracteres de caixa. {/* min-version: 2.1.198 */}Requer Claude Code v2.1.198 ou posterior; versões anteriores desenham tabelas como grades mesmo no modo leitor de tela.
A saída se acumula no scrollback do seu terminal, para que você possa reler turnos anteriores com os comandos de revisão do seu leitor de tela ou a busca do seu terminal.
O modo leitor de tela é renderizado como texto simples em rolagem, mesmo se você ativou [renderização em tela cheia](/pt/fullscreen) com a [configuração `tui`](/pt/settings#available-settings); a configuração não tem efeito enquanto o modo está ativo. Sessões de fundo anexadas ainda são renderizadas em tela cheia; consulte [Limitações conhecidas](#known-limitations).
Cada mensagem na transcrição começa com um rótulo que seu leitor de tela anuncia, nomeando o que é: suas mensagens, respostas de Claude, atividade de ferramentas, erros 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:
| Rótulo | Significado |
| :--------------------- | :------------------------------------------------------------------------------------------ |
| `you:` | Suas mensagens |
| `claude:` | Respostas de Claude |
| `tool:` | Atividade de ferramentas, como uma edição de arquivo ou um comando executado |
| `tool error:` | Uma ferramenta que falhou |
| `error:` | Um erro na conversa, como uma solicitação de API com falha |
| `Permission Required:` | Um prompt de permissão aguardando sua resposta |
| `Cost:` | O resumo de custo da sessão quando Claude Code sai, se sua conta [mostra custos](/pt/costs) |
O cursor do terminal segue o cursor de entrada, para que o comando de leitura de linha atual do seu leitor de tela responda "onde estou" com o prompt que você está editando.
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 `scrollToMark` em suas configurações
* Kitty e Ghostty: consulte a documentação do terminal para sua tecla de pulo para prompt
macOS Terminal não atua nos marcadores, e Claude Code não os emite em WezTerm. Nesses terminais, pesquise o scrollback pelo rótulo `you:` em vez disso.
Responder menus e prompts
No modo leitor de tela, menus que você normalmente navegaria com as teclas de seta, incluindo prompts de permissão, se tornam listas numeradas. Cada opção é anunciada como uma linha numerada, seguida por um prompt `Enter selection` que nomeia o intervalo válido. Digite o número da opção que deseja e pressione Enter.
* Para cancelar um menu dispensável: pressione Escape. Seu 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.
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 de permissão aparece
* uma ferramenta que foi executada por mais de 5 segundos termina
O sino é o alerta padrão do seu terminal. Para silenciá-lo, altere a configuração de sino no seu aplicativo de terminal. O sino não requer modo leitor de tela: fora do modo, defina [`preferredNotifChannel`](/pt/settings#available-settings) como `"terminal_bell"` para alertas semelhantes quando Claude está esperando por você. Consulte [Obter um sino de terminal ou notificação](/pt/terminal-config#get-a-terminal-bell-or-notification).
Configurações de acessibilidade além do modo leitor de tela
Essas opções abordam necessidades de acessibilidade fora do modo leitor de tela. Todas elas funcionam junto com ele.
* A [variável de ambiente](/pt/env-vars) `CLAUDE_CODE_ACCESSIBILITY` é para ampliadores de tela. Defina `CLAUDE_CODE_ACCESSIBILITY=1` para manter o cursor de terminal nativo visível para que ampliadores, como Zoom do macOS, possam rastrear a posição do cursor.
* A [configuração](/pt/settings#available-settings) `prefersReducedMotion` reduz ou desabilita spinners, shimmer e outras animações sem alterar o resto da interface.
* A [configuração](/pt/settings#available-settings) `theme` seleciona as cores da interface, incluindo os temas amigáveis para daltônicos `dark-daltonized` e `light-daltonized`.
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.
* Mudanças de modo, como entrar em [plan mode](/pt/permission-modes#analyze-before-you-edit-with-plan-mode), ainda não são anunciadas.
* Anexar a uma [sessão de fundo](/pt/agent-view) com `claude attach` ou 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](/pt/fullscreen). 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](/pt/headless) com a flag `-p`. O modo não interativo já escreve texto simples e permanece uma alternativa para scripts.
Relatar um problema
Se algo não funcionar com seu leitor de tela, ampliador ou terminal, abra um problema no [rastreador de problemas do Claude Code](https://github.com/anthropics/claude-code/issues) e mencione sua tecnologia assistiva no título. Inclua seu sistema operacional, aplicativo de terminal e nome e versão da tecnologia assistiva no relatório.
Essas páginas contêm as entradas de referência completa e a configuração relacionada para o que esta página cobre:
* [Settings](/pt/settings#available-settings): as entradas `axScreenReader`, `prefersReducedMotion`, `theme` e `preferredNotifChannel`
* [Environment variables](/pt/env-vars): as entradas `CLAUDE_AX_SCREEN_READER` e `CLAUDE_CODE_ACCESSIBILITY`
* [CLI reference](/pt/cli-reference#cli-flags): a flag `--ax-screen-reader`
* [Terminal configuration](/pt/terminal-config): sinos, notificações e temas fora do modo leitor de tela
* [Non-interactive mode](/pt/headless): execuções de `claude -p` com script, que escrevem texto simples sem modo leitor de tela