Usa Claude Code con un lettore di schermo

Claude Code ha una modalità lettore di schermo che sostituisce la sua interfaccia terminale visiva con testo semplice e lineare. Invece di caselle, animazioni di progresso e ridisegni in-place, la modalità stampa righe etichettate che un lettore di schermo come VoiceOver o NVDA legge in ordine, in modo che possiate mantenere una conversazione completa, approvare i permessi degli strumenti e rivedere l’output da capo a fondo. La modalità lettore di schermo è facoltativa. Se utilizzate un ingranditore dello schermo, movimento ridotto o un tema adatto ai daltonici invece di un lettore di schermo, consultate Impostazioni di accessibilità oltre la modalità lettore di schermo.

​

Attiva la modalità lettore di schermo

Scegli il metodo che corrisponde a quanto spesso utilizzi un lettore di schermo:

• Per una sessione: esegui claude --ax-screen-reader.
• Per sessioni avviate da una shell: imposta la variabile di ambiente CLAUDE_AX_SCREEN_READER su 1. In Bash o Zsh, esegui export CLAUDE_AX_SCREEN_READER=1; in PowerShell, esegui $env:CLAUDE_AX_SCREEN_READER = "1". Aggiungi la riga al tuo profilo shell per coprire ogni shell.
• Per ogni sessione sulla macchina: aggiungi "axScreenReader": true al tuo file di impostazioni dell’utente. Questo copre qualsiasi terminale, incluso il terminale integrato di VS Code.

Se utilizzi Claude Code su SSH, imposta la variabile di ambiente o l’impostazione sulla macchina remota dove Claude Code viene eseguito. Quando la modalità è attiva, la prima cosa che Claude Code stampa è una riga di conferma che nomina il metodo che l’ha attivata: [Screen Reader Mode: on via flag], [Screen Reader Mode: on via env], o [Screen Reader Mode: on via settings]; questo formato di denominazione del metodo richiede Claude Code v2.1.206 o successivo. Le versioni precedenti stampano [Accessible screen reader mode: on].

​

Disattiva la modalità lettore di schermo

Inverti il metodo che ha attivato la modalità: avvia senza il flag, annulla l’impostazione della variabile di ambiente o imposta axScreenReader su false. L’impostazione di CLAUDE_AX_SCREEN_READER=0 mantiene la modalità disattivata anche quando l’impostazione è true.

​

Cosa sente il tuo lettore di schermo

In modalità lettore di schermo, Claude Code scrive testo semplice:

• nessun carattere di disegno di caselle per il chrome dell’interfaccia
• nessun suggerimento basato solo sul colore
• nessun ridisegno del contenuto che non è cambiato; i spinner di progresso vengono renderizzati come testo statico
• le tabelle nelle risposte di Claude vengono lette come frasi Header: value invece di una griglia di caratteri di casella. Richiede Claude Code v2.1.198 o successivo; le versioni precedenti disegnano le tabelle come griglie anche in modalità lettore di schermo.

L’output si accumula nello scrollback del tuo terminale, in modo che tu possa rileggere i turni precedenti con i comandi di revisione del tuo lettore di schermo o la ricerca del tuo terminale. La modalità lettore di schermo viene renderizzata come testo scorrevole semplice, anche se hai attivato il rendering a schermo intero con l’impostazione tui; l’impostazione non ha effetto mentre la modalità è attiva. Le sessioni in background allegate vengono comunque renderizzate a schermo intero; consulta Limitazioni note. Ogni messaggio nella trascrizione inizia con un’etichetta che il tuo lettore di schermo annuncia, denominando cosa sia: i tuoi messaggi, le risposte di Claude, l’attività degli strumenti, gli errori e i prompt. Le etichette sono anche ricercabili, in modo che tu possa saltare tra le sezioni della trascrizione cercando nello scrollback del tuo terminale: Il cursore del terminale segue il cursore di input, quindi il comando di lettura della riga corrente di un lettore di schermo risponde a “dove sono” con il prompt che stai modificando.

​

Salta tra i turni

Claude Code emette marcatori di integrazione shell OSC 133 ai confini dei turni, in modo che il tasto per saltare al prompt precedente del tuo terminale si sposti tra i turni senza leggere l’intera trascrizione:

• iTerm2: Cmd+Shift+Up
• Terminale VS Code: Ctrl+Up su Windows, Cmd+Up su macOS
• Windows Terminal: nessun tasto per impostazione predefinita; associa l’azione scrollToMark nelle sue impostazioni
• Kitty e Ghostty: consulta la documentazione del terminale per il suo tasto di salto al prompt

macOS Terminal non agisce sui marcatori e Claude Code non li emette in WezTerm. In quei terminali, cerca nello scrollback l’etichetta you: invece.

​

Rispondi a menu e prompt

In modalità lettore di schermo, i menu che normalmente navigheresti con i tasti freccia, inclusi i prompt di permesso, diventano elenchi numerati. Ogni opzione viene annunciata come una riga numerata, seguita da un prompt Enter selection che nomina l’intervallo valido. Digita il numero dell’opzione che desideri e premi Invio.

• Per annullare un menu dismissibile: premi Escape. Il suo prompt termina con or Escape to cancel.
• Se digiti un numero che non è nell’elenco: Claude Code annuncia l’intervallo valido e ti consente di riprovare.

I prompt sì-o-no chiedono una risposta digitata invece di un menu a due opzioni. Rispondi con y o n e premi Invio. Funzionano anche yes e no.

​

Ascolta quando Claude Code ha bisogno di te

In modalità lettore di schermo, Claude Code suona il campanello del terminale quando ha bisogno della tua attenzione, in modo che tu non debba continuare a controllare la trascrizione. Il campanello suona quando:

• Claude finisce una risposta
• appare un prompt di permesso
• uno strumento che è stato eseguito per più di 5 secondi finisce

Il campanello è l’avviso standard del tuo terminale. Per silenziarlo, modifica l’impostazione del campanello nella tua applicazione terminale. Il campanello non richiede la modalità lettore di schermo: al di fuori della modalità, imposta preferredNotifChannel su "terminal_bell" per avvisi simili quando Claude è in attesa di te. Consulta Ottieni un campanello terminale o una notifica.

​

Impostazioni di accessibilità oltre la modalità lettore di schermo

Queste opzioni affrontano le esigenze di accessibilità al di fuori della modalità lettore di schermo. Tutte funzionano insieme ad essa.

• La variabile di ambiente CLAUDE_CODE_ACCESSIBILITY è per gli ingranditori di schermo. Imposta CLAUDE_CODE_ACCESSIBILITY=1 per mantenere visibile il cursore del terminale nativo in modo che gli ingranditori, come macOS Zoom, possano tracciare la posizione del cursore.
• L’impostazione prefersReducedMotion riduce o disabilita spinner, shimmer e altre animazioni senza modificare il resto dell’interfaccia.
• L’impostazione theme seleziona i colori dell’interfaccia, inclusi i temi adatti ai daltonici dark-daltonized e light-daltonized.

​

Limitazioni note

Alcuni comportamenti non sono adattati per la modalità lettore di schermo:

• La modalità lettore di schermo non si attiva automaticamente quando un lettore di schermo è in esecuzione.
• I cambiamenti di modalità, come l’ingresso in plan mode, non vengono ancora annunciati.
• L’allegato a una sessione in background con claude attach o dalla vista agente entra nello schermo alternativo del terminale, che non ha scrollback nativo. Questo è lo stesso comportamento di altre sessioni allegate. Per uscire, premi la freccia sinistra su un prompt vuoto, o Ctrl+Z se un dialogo ha il focus.
• Claude Code annuncia i costi nel riepilogo che stampa all’uscita, non per turno.
• La modalità lettore di schermo non modifica la modalità non interattiva con il flag -p. La modalità non interattiva scrive già testo semplice e rimane un’alternativa per lo scripting.

​

Segnala un problema

Se qualcosa non funziona con il tuo lettore di schermo, ingranditore o terminale, apri un problema sul tracker dei problemi di Claude Code e menziona la tua tecnologia assistiva nel titolo. Includi il tuo sistema operativo, l’applicazione terminale e il nome e la versione della tecnologia assistiva nel rapporto.

​

Risorse correlate

Queste pagine contengono le voci di riferimento complete e la configurazione correlata per ciò che questa pagina copre:

• Settings: le voci axScreenReader, prefersReducedMotion, theme e preferredNotifChannel
• Environment variables: le voci CLAUDE_AX_SCREEN_READER e CLAUDE_CODE_ACCESSIBILITY
• CLI reference: il flag --ax-screen-reader
• Terminal configuration: campanelli, notifiche e temi al di fuori della modalità lettore di schermo
• Non-interactive mode: esecuzioni claude -p con script, che scrivono testo semplice senza modalità lettore di schermo