O modo leitor de tela traz Claude Code de volta à experiência básica do terminal: texto simples e sequencial com rótulos e sinais adicionados e sem enfeites visuais. Foi construído com e para usuários de leitores de tela, e é útil para qualquer pessoa que queira saída simples para displays braille, conexões lentas ou transcrições.
Ativar o modo leitor de tela
O modo leitor de tela requer Claude Code versão 2.1.181 ou posterior e pode ser ativado de várias maneiras:
Para uma sessão: execute
claude --ax-screen-readerPara cada sessão em um terminal: defina a variável de ambiente
CLAUDE_AX_SCREEN_READER=1Permanentemente: adicione
"axScreenReader": trueao seu arquivo de configurações do Claude Code (~/.claude/settings.json)
A primeira linha da sessão anuncia que o modo leitor de tela está ativado. No Claude Code v2.1.206 e posterior, anuncia: [Screen Reader Mode: on via flag] (ou via env / via settings).
O que esperar
Seus prompts e as respostas do Claude são rotulados. Suas mensagens começam com
you:e as respostas do Claude começam comclaude:. A atividade de ferramentas começa comtool:e prompts de permissão comPermission Required:. Os rótulos também são pesquisáveis, para que você possa usar a pesquisa do seu terminal para pular entre partes da conversa.Menus se tornam listas numeradas. Em vez de mover um destaque com as teclas de seta, você ouve cada opção como uma linha numerada, depois digita o número da opção que deseja e pressiona Enter. Para prompts sim ou não, digite
youne pressione Enter.Decorações visuais são removidas. Spinners, animações de progresso e redesenhos no local se tornam texto simples que é lido em ordem, e caracteres decorativos como linhas de desenho de caixa são removidos.
Um sino do terminal avisa quando Claude precisa de você. Você ouvirá o som de alerta do seu terminal quando Claude terminar uma resposta, quando um prompt de permissão aparecer e quando uma ferramenta de longa duração terminar. Se você não ouvir, verifique a configuração do sino no seu aplicativo de terminal—alguns terminais mantêm o som de alerta desativado por padrão. O canal de notificação próprio do Claude Code pode ser definido com
/configem notificações.
Para explorar documentação abrangente sobre marcadores de linha, navegação de lista e restrições existentes, visite a seção Acessibilidade do guia Claude Code.
Relatar um problema
Se algo não funcionar com seu leitor de tela ou terminal, abra um problema no repositório GitHub do Claude Code e mencione seu leitor de tela no título. Inclua seu sistema operacional, aplicativo de terminal e nome e versão do leitor de tela.
Nota: Uma configuração que é fácil de confundir: CLAUDE_CODE_ACCESSIBILITY=1 é uma configuração diferente e não relacionada—ela mantém o cursor do terminal visível para ampliadores de tela e não ativa o modo leitor de tela. Para um leitor de tela, use os métodos acima.