Il Flickering del Terminale di Claude Code: Oltre 700 Voti, 9 Mesi, Ancora Rotto
Claude Code ha un problema di rendering del terminale così grave da poter mandare in crash l'intero IDE, rendere il sistema inutilizzabile e potenzialmente scatenare crisi epilettiche negli utenti fotosensibili. Questo bug è documentato da marzo 2025. Ha accumulato oltre 1000 voti combinati attraverso molteplici segnalazioni. E a dicembre 2025, rimane ancora irrisolto.
La Portata di Questo Disastro
La Issue #3648 che documenta lo scrolling del terminale completamente impazzito ha 282 reazioni thumbs-up. La Issue #1913 ne ha 181. La Issue #769 di aprile 2025 ne ha 168. Ci sono almeno una dozzina di altri duplicati sparsi nel repository, tutti che descrivono lo stesso problema fondamentale.
Oltre 1000 sviluppatori che urlano per lo stesso bug non è un problema marginale, è un fallimento sistemico.
Uno sviluppatore ha effettivamente strumentato cosa fa Claude Code ai terminali. I risultati della issue #9935 sono davvero scioccanti: da 4.000 a 6.700 eventi di scroll al secondo. La causa principale è che Claude Code esegue un ridisegno completo del terminale ad ogni chunk di output in streaming invece di fare aggiornamenti incrementali come qualsiasi applicazione terminale sensata.
Cosa Sperimentano gli Utenti
Guardalo in azione: La [segnalazione originale del bug] include un video che mostra il terminale trasformarsi in una luce stroboscopica durante l'uso normale.
In VS Code e Cursor, il terminale inizia a lampeggiare, peggiora progressivamente, poi l'intero editor si blocca e crasha dopo 10-20 minuti, portandosi via tutto il lavoro non salvato.
Nei terminali standalone, ottieni l'effetto luce stroboscopica senza i crash. La vecchia cronologia delle conversazioni lampeggia mescolata con il nuovo output. La barra di scorrimento salta in modo erratico. Digitare mentre Claude pensa è un esercizio di frustrazione.
Il terminale inizia a scorrere velocissimo da solo e spesso non riesci a fermarlo a meno che non chiudi la scheda del terminale e riavvii Claude. Altre volte quando stai cercando di digitare il tuo prompt devi scorrere ripetutamente verso il basso per trovare dove stai digitando.
Alcuni utenti segnalano che il bug genera fino a sette processi paralleli di Claude Code, ognuno che consuma CPU mentre il terminale lampeggia all'infinito senza risposta.
Il Problema di Accessibilità
La segnalazione originale del bug ha esplicitamente segnalato questo come un problema di accessibilità. Il lampeggiamento rapido dello schermo è un trigger noto per l'epilessia fotosensibile. Le Web Content Accessibility Guidelines avvertono contro contenuti che lampeggiano più di tre volte al secondo. Claude Code lampeggia migliaia di volte al secondo.
Anthropic si presenta come profondamente impegnata nella sicurezza dell'IA, eppure ha rilasciato un prodotto con un rischio di accessibilità noto da nove mesi.
Perché Dovrebbe Essere Facile da Risolvere
Questo non è un problema architetturale profondo. La correzione è concettualmente semplice: smettere di ridisegnare l'intero buffer del terminale ad ogni aggiornamento. Usare il posizionamento del cursore per aggiornare solo ciò che è cambiato. Questa è programmazione base dei terminali compresa dagli anni '70.
Se l'interfaccia visiva elaborata è troppo complessa per essere renderizzata in modo incrementale, semplificala. Dai agli utenti una modalità testo semplice che funziona invece di un'interfaccia carina che manda in crash il loro IDE.
Come Sopravvivere Finché Non Lo Risolvono
Basandosi sui risultati della community, ecco i migliori workaround:
Per gli utenti Mac, abbandona completamente il terminale dell'IDE. Usa un semplice terminale bash standalone come il Terminal.app nativo o iTerm2. Il flickering continua a verificarsi ma almeno non manderà in crash l'intero ambiente di sviluppo.
Riduci lo scrollback del terminale a 500 righe o meno nelle impostazioni del terminale. Questo non risolve il bug ma riduce la gravità.
Usa /clear frequentemente tra i prompt per resettare il buffer. Questo ritarda ma non previene l'eventuale collasso.
Evita completamente i terminali integrati di VS Code e Cursor per le sessioni di Claude Code. I terminali esterni gestiscono meglio l'abuso.
Mantieni le sessioni brevi. Se stai facendo lavoro agentico pesante con subagent, aspettati che il flickering peggiori. Riavvia prima che crashi.
Disabilita l'accelerazione GPU e lo scrolling fluido nel tuo terminale se esistono queste opzioni.
In conclusione: nove mesi, oltre 700 voti, 6.700 eventi di scroll al secondo, zero correzioni. Usa i workaround, sii paziente e magari aggiungi il tuo voto alla pila.
Issue GitHub Correlate
- [#3648 - Terminal Scrolling Uncontrollably] - 282 voti, la issue di flickering più votata
- [#1913 - Terminal Flickering] - 181 voti
- [#769 - In-progress Call causes Screen Flickering] - 168 voti, la segnalazione completa originale di aprile 2025
- [#9935 - Excessive scroll events causing UI jitter] - Analisi tecnica approfondita che mostra 6.700 scroll al secondo
- [#10794 - Critical: Terminal Flickering Causes Complete VSCode Crashes] - Documenta crash completi dell'IDE su macOS
- [#9658 - Multiple Claude Code instances spawning] - Documenta la generazione incontrollata di processi
- [#7276 - VS Code Terminal Flickering and Crash During Long Conversations] - Segnalazioni di crash di VS Code
- [#392 - Flickering display] - Una delle prime segnalazioni di marzo 2025
