Passa al contenuto principale

Accessibilità

Principiante

Claude Code gira nel terminale — una UI testuale, che è un buon punto di partenza per l'accessibilità, ma il rendering di default si affida a colori, glifi di disegno a riquadri e spinner che screen reader e alcune configurazioni motorie gestiscono male. A luglio 2026 esiste una modalità screen reader dedicata, oltre a impostazioni per l'ergonomia vim e il comportamento di mouse/scroll. Questa pagina raccoglie le leve che rendono la CLI utilizzabile con le tecnologie assistive.

What you'll learn
  • Come attivare la modalità screen reader — tre modi, e cosa cambia ciascuno
  • Cosa fa davvero la modalità screen reader alla trascrizione, alle tabelle e ai prompt dei permessi
  • Come rimappare i tasti della modalità insert di vim (jj → Escape) per ridurre l'affaticamento della mano
  • Come controllare o disabilitare i click del mouse e l'accelerazione dello scroll a schermo intero
  • Dove si trovano i temi ad alto contrasto, e come segnalare una lacuna di accessibilità

Modalità screen reader​

La modalità screen reader sostituisce la TUI decorativa con un rendering in testo semplice che le tecnologie assistive possono leggere in modo pulito. Attivala in uno di tre modi — un flag una tantum, una variabile d'ambiente per ogni sessione, o un'impostazione persistente.

Guided walkthrough1 of 3
  1. Avvia con il flag: claude --ax-screen-reader. Non cambia nient'altro — stessa sessione, output più semplice.

Modalità screen reader persistente (~/.claude/settings.json)

{
"axScreenReader": true
}

Cosa cambia​

Pro tip
  • Il rendering in testo semplice sostituisce la TUI stilizzata così gli screen reader ricevono testo pulito e lineare.
  • I glifi decorativi vengono nascosti agli screen reader invece di essere letti come rumore.
  • I simboli della trascrizione vengono annunciati come brevi etichette anziché come caratteri grezzi.
  • Le tabelle annidate vengono lette come righe Intestazione: valore. — appiattite in righe pronunciabili.
  • I cambi di modalità dei permessi vengono annunciati a voce quando cicli tra le modalità con Shift+Tab.

Quest'ultimo punto conta: ciclare tra le modalità dei permessi con Shift+Tab è un'interazione centrale di Claude Code (vedi Permessi), e la modalità screen reader pronuncia a voce la nuova modalità così sai sempre se sei in modalità plan, accept-edits o auto senza leggere la barra di stato.

Ergonomia vim: rimappare i tasti della modalità insert​

Se usi la modalità vim e allungare la mano verso Escape la affatica, mappa al suo posto una sequenza di due tasti della modalità insert. L'impostazione vimInsertModeRemaps trasforma sequenze come jj in Escape, così non lasci mai la home row.

Mappa jj su Escape in modalità vim (settings.json)

{
"editorMode": "vim",
"vimInsertModeRemaps": {
  "jj": "Escape"
}
}
Watch out
  • Il remap scatta solo in modalità insert, quindi digitare jj come testo letterale richiede una breve pausa tra i tasti — scegli una sequenza che raramente digiti in fretta (jj e kj sono scelte comuni).
  • editorMode: vim abilita i keybinding di vim; vimInsertModeRemaps ha effetto solo mentre la modalità vim è attiva.

Controlli mouse e scroll​

I menu a schermo intero ora accettano i click del mouse — inclusi i menu a selezione multipla e le righe di input "Other" — il che aiuta se la navigazione solo da tastiera è faticosa. Due impostazioni regolano il comportamento del puntatore per sensibilità al movimento o precisione:

ImpostazioneCosa fa
CLAUDE_CODE_DISABLE_MOUSE_CLICKSDisabilita click, trascinamento e hover del mouse mantenendo lo scroll con la rotellina — utile se i click accidentali ti disturbano.
wheelScrollAccelerationEnabledImpostala a false per disattivare l'accelerazione dello scroll con la rotellina a schermo intero, per uno scorrimento più stabile e prevedibile.

Scroll più stabile, nessun click accidentale (settings.json)

{
"wheelScrollAccelerationEnabled": false,
"env": {
  "CLAUDE_CODE_DISABLE_MOUSE_CLICKS": "1"
}
}

Contrasto e temi​

Per gli utenti ipovedenti, il contrasto del terminale è la prima leva. Claude Code include temi chiari e scuri e supporta temi personalizzati che costruisci da /theme o distribuisci in un plugin — così puoi calibrare una palette ad alto contrasto adatta alle tue esigenze. Vedi Impostazioni per dove viene memorizzata la scelta del tema, e Output Styles se vuoi anche una prosa più semplice e meno decorata (gli stili Explanatory e Learning sono più verbosi, non meno — per un output conciso resta su Default).

:::tip Oltre la CLI La modalità screen reader copre il terminale. Per l'interazione a mani libere con Claude più in generale, Voice Mode nell'app ti permette di parlare e ascoltare, e il playbook Accessibilità tratta l'uso di Claude stesso come strumento assistivo — semplificare testi, costruire checklist e adattare le informazioni al modo in cui leggi. :::

Verifica le tue conoscenze

0/3
  1. Quale di queste attiva automaticamente la modalità screen reader per ogni sessione?
  2. In modalità screen reader, come vengono lette le tabelle annidate?
  3. Cosa ti permette di fare vimInsertModeRemaps?
Pro tip
  • Modalità screen reader: flag --ax-screen-reader (una volta), CLAUDE_AX_SCREEN_READER=1 (per shell), o axScreenReader: true (persistente).
  • Trasforma la trascrizione in testo semplice, nasconde i glifi decorativi, appiattisce le tabelle e pronuncia i cambi di modalità dei permessi su Shift+Tab.
  • vimInsertModeRemaps riduce l'affaticamento della mano; CLAUDE_CODE_DISABLE_MOUSE_CLICKS e wheelScrollAccelerationEnabled regolano il comportamento del puntatore.
  • I temi personalizzati offrono palette ad alto contrasto; Voice Mode e il playbook Accessibilità coprono il resto.

Prossimo​