Vai al contenuto principale
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, Claude Code stampa righe etichettate che un lettore di schermo come VoiceOver o NVDA legge in ordine. Potete 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, impostate CLAUDE_CODE_ACCESSIBILITY, prefersReducedMotion o theme dalla tabella Impostazioni di accessibilità. La modalità lettore di schermo adatta solo l’interfaccia terminale, quindi non è necessaria nel pannello chat dell’estensione VS Code. Su Claude Code v2.1.236 o successivo, l’estensione annuncia l’attività della conversazione al vostro lettore di schermo senza alcuna impostazione.

​
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 d’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 quella riga al tuo profilo shell per mantenerla per le shell future.
  • Per ogni sessione sulla macchina: aggiungi "axScreenReader": true al tuo file di impostazioni dell’utente. L’impostazione si applica in qualsiasi terminale, incluso il terminale integrato di VS Code.
Se combini i metodi, Claude Code dà la precedenza al flag --ax-screen-reader rispetto alla variabile d’ambiente CLAUDE_AX_SCREEN_READER, e alla variabile rispetto all’impostazione axScreenReader. Se utilizzi Claude Code su SSH, imposta la variabile d’ambiente o l’impostazione sulla macchina remota dove Claude Code viene eseguito. La prima riga che Claude Code stampa conferma la modalità: [Screen Reader Mode: on via flag], [Screen Reader Mode: on via env] o [Screen Reader Mode: on via settings].

​
Le impostazioni del progetto non possono attivare la modalità lettore di schermo

La riga di avvio Screen reader mode is off: project settings can't turn it on indica che il progetto ha richiesto la modalità lettore di schermo e nient’altro la attiva. Claude Code ignora sia la chiave axScreenReader sia un valore CLAUDE_AX_SCREEN_READER sotto env nei file .claude/settings.json e .claude/settings.local.json del progetto, qualunque sia il loro valore.
  • Per attivare la modalità: avvia Claude Code con --ax-screen-reader, imposta CLAUDE_AX_SCREEN_READER su 1 nella tua shell oppure aggiungi "axScreenReader": true al tuo file di impostazioni dell’utente e riavvia Claude Code. Non è necessario modificare i file del progetto. Una volta attivata la modalità, all’avvio compare invece la riga di conferma.
  • Se non utilizzi un lettore di schermo: non devi fare nulla. Per evitare che la riga compaia, aggiungi "axScreenReader": false al tuo file di impostazioni dell’utente, oppure rimuovi la chiave axScreenReader e la variabile CLAUDE_AX_SCREEN_READER dai file di impostazioni del progetto.

​
Disattiva la modalità lettore di schermo

Inverti il metodo che ha attivato la modalità: avvia senza il flag, annulla l’impostazione della variabile d’ambiente o imposta axScreenReader su false nel tuo file delle impostazioni utente. Se imposti CLAUDE_AX_SCREEN_READER su 0, Claude Code mantiene la modalità disattivata anche quando l’impostazione è true.

​
Impostazioni di accessibilità

La tabella elenca ogni opzione di accessibilità, se la impostate come flag, variabile di ambiente o impostazione, e cosa cambia.

​
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. Gli 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
  • I diff vengono letti come testo semplice, riga per riga, con + e - a indicare le righe aggiunte e rimosse, così puoi ascoltare la modifica proposta in una richiesta di approvazione di una modifica a un file prima di rispondere
Claude Code lascia tutto ciò che stampa 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. Claude Code ignora l’impostazione tui in modalità lettore di schermo. A parte le sessioni in background allegate elencate sotto Limitazioni note, stampa testo scorrevole invece di rendering a schermo intero. Dopo che Claude Code stampa la riga di conferma all’avvio, attende 3 secondi prima di disegnare il prompt, in modo che il tuo lettore di schermo possa finire la riga. Premi un tasto qualsiasi per terminare l’attesa. Per cambiare la durata dell’attesa, imposta CLAUDE_AX_STARTUP_QUIET_MS. Ogni messaggio nella trascrizione inizia con un’etichetta che il tuo lettore di schermo annuncia, indicando di cosa si tratta: i tuoi messaggi, le risposte e il ragionamento di Claude, l’attività degli strumenti, gli errori e gli avvisi 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: Claude Code mantiene il cursore del terminale sul cursore di input, in modo che il comando di lettura della riga corrente del tuo lettore di schermo legga il prompt che stai modificando. Mentre digiti alla fine della riga di input, o premi Backspace lì, Claude Code scrive solo i caratteri che cambiano. Il tuo lettore di schermo ripete solo quei caratteri. Quando elimini una parola o una riga con una delle scorciatoie di modifica del testo, Claude Code annuncia il testo eliminato:
  • Eliminazione di parole con Ctrl+W o Alt+D, o con Option+Delete su macOS o Ctrl+Backspace su Windows
  • Eliminazione fino all’inizio della riga con Ctrl+U o Cmd+Backspace
  • Eliminazione fino alla fine della riga con Ctrl+K
Quando passi ciclicamente tra le modalità di permesso con Shift+Tab, Claude Code annuncia la modalità di permesso su cui arrivi, come [plan mode on] o [accept edits on]. Claude Code stampa l’annuncio una volta e non lo ripete nei ridisegni successivi.

​
Leggi l’output precedente senza perdere il segno

Se il tuo lettore di schermo torna al prompt mentre stai leggendo l’output precedente, sta seguendo il cursore del terminale. Claude Code riporta il cursore del terminale sul prompt ogni volta che scrive nuovo testo. Per non perdere il segno mentre leggi, impedisci al tuo lettore di schermo di seguire il cursore del terminale. In NVDA, premi NVDA+6 per impedire al cursore di revisione di seguire il cursore del terminale. Premi di nuovo NVDA+6 per riattivare l’inseguimento.

​
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 invece nello scrollback l’etichetta you:.

​
Rispondere a menu e prompt

In modalità screen reader, i menu in cui normalmente navighi con i tasti freccia, incluse le richieste di permesso, diventano elenchi numerati. Claude Code annuncia ogni opzione come una riga numerata, seguita da un prompt Select with numbers che indica l’intervallo valido. Digita il numero dell’opzione che desideri e premi Enter.
  • Premi Escape per annullare un menu il cui prompt termina con or Escape to cancel.
  • Se digiti un numero che non è nell’elenco, Claude Code annuncia l’intervallo valido e ti permette di riprovare.
Il selettore /effort, che al di fuori della modalità screen reader è uno slider, diventa lo stesso tipo di elenco numerato. I prompt sì-o-no chiedono una risposta digitata invece di un menu a due opzioni. Rispondi y o n e premi Enter. Funzionano anche yes e no.

​
Ascoltate quando Claude Code ha bisogno di voi

In modalità lettore di schermo, Claude Code suona il campanello del terminale quando ha bisogno della vostra attenzione, in modo che non dobbiate continuare a controllare la trascrizione. Il campanello suona quando:
  • Claude finisce una risposta
  • Un prompt o una finestra di dialogo ha bisogno della vostra risposta, come un prompt di permesso
  • Uno strumento che è stato eseguito per più di 5 secondi finisce
Il campanello è l’avviso standard del vostro terminale. Per silenziarlo, cambiate l’impostazione del campanello nella vostra applicazione terminale. Al di fuori della modalità lettore di schermo, impostate preferredNotifChannel su "terminal_bell" per ottenere un campanello simile quando Claude è in attesa di voi.

​
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.
  • Claude Code non annuncia un cambio di modalità di permesso effettuato con un comando, come l’ingresso in plan mode con /plan.
  • 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, premete la freccia sinistra su un prompt vuoto, o Ctrl+Z se una finestra di 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.

​
Segnalate un problema

Se qualcosa non funziona con il vostro lettore di schermo, ingranditore o terminale, aprite un problema sul tracker dei problemi di Claude Code e menzionate la vostra tecnologia assistiva nel titolo. Includete il vostro sistema operativo, l’applicazione terminale e il nome e la versione della tecnologia assistiva nel rapporto.