Migotanie terminala w Claude Code: ponad 700 głosów, 9 miesięcy, wciąż nienaprawione
Claude Code ma problem z renderowaniem terminala na tyle poważny, że może zawiesić całe IDE, uczynić system bezużytecznym i potencjalnie wywołać ataki u osób wrażliwych na światło. Ten błąd jest dokumentowany od marca 2025 roku. Zgromadził ponad 1000 łącznych głosów w wielu zgłoszeniach. A na grudzień 2025 roku pozostaje nienaprawiony.
Skala tej katastrofy
Zgłoszenie #3648 dokumentujące całkowicie niekontrolowane przewijanie terminala ma 282 reakcje kciuka w górę. Zgłoszenie #1913 ma 181 kciuków w górę. Zgłoszenie #769 z kwietnia 2025 ma 168 kciuków w górę. Jest co najmniej tuzin kolejnych duplikatów rozrzuconych po repozytorium, wszystkie opisujące ten sam fundamentalny problem.
Ponad 1000 programistów krzyczących o tym samym błędzie to nie marginalny problem, to systemowa porażka.
Jeden z programistów faktycznie zmierzył, co Claude Code robi z terminalami. Odkrycia ze zgłoszenia #9935 są naprawdę szokujące: od 4000 do 6700 zdarzeń przewijania na sekundę. Główną przyczyną jest to, że Claude Code wykonuje pełne przerysowanie terminala przy każdym fragmencie strumieniowanego wyjścia, zamiast wykonywać przyrostowe aktualizacje jak każda rozsądna aplikacja terminalowa.
Co doświadczają użytkownicy
Zobacz to w akcji: [Oryginalne zgłoszenie błędu] zawiera wideo pokazujące terminal zamieniający się w stroboskop podczas normalnego użytkowania.
W VS Code i Cursor terminal zaczyna migotać, stopniowo się pogarsza, a następnie cały edytor zawiesza się i ulega awarii po 10 do 20 minutach, zabierając ze sobą całą niezapisaną pracę.
W samodzielnych terminalach otrzymujesz efekt stroboskopu bez awarii. Stara historia konwersacji miga zmieszana z nowym wyjściem. Pasek przewijania skacze chaotycznie. Pisanie podczas gdy Claude myśli to ćwiczenie frustracji.
Terminal zaczyna przewijać się superszybko sam i często nie można tego zatrzymać, chyba że zabijesz kartę terminala i zrestartujesz Claude. Innym razem, gdy próbujesz wpisać swój prompt, musisz wielokrotnie przewijać w dół, aby znaleźć miejsce, w którym piszesz.
Niektórzy użytkownicy zgłaszają, że błąd tworzy do siedmiu równoległych procesów Claude Code, z których każdy zużywa CPU, podczas gdy terminal miga bez końca bez odpowiedzi.
Problem dostępności
Oryginalne zgłoszenie błędu wyraźnie oznaczyło to jako problem dostępności. Szybkie miganie ekranu jest znanym wyzwalaczem padaczki światłoczułej. Wytyczne dotyczące dostępności treści internetowych ostrzegają przed treściami migającymi więcej niż trzy razy na sekundę. Claude Code miga tysiące razy na sekundę.
Anthropic reklamuje się jako głęboko zaangażowany w bezpieczeństwo AI, a jednak wydał produkt ze znanym zagrożeniem dostępności przez dziewięć miesięcy.
Dlaczego to powinno być łatwe do naprawienia
To nie jest jakiś głęboki problem architektoniczny. Poprawka jest koncepcyjnie prosta: przestań przerysowywać cały bufor terminala przy każdej aktualizacji. Użyj pozycjonowania kursora, aby aktualizować tylko to, co się zmieniło. To podstawowe programowanie terminala rozumiane od lat 70. XX wieku.
Jeśli fantazyjny interfejs wizualny jest zbyt skomplikowany, aby renderować go przyrostowo, uprość go. Daj użytkownikom tryb zwykłego tekstu, który działa, zamiast ładnego interfejsu, który zawiesza ich IDE.
Jak przetrwać, dopóki tego nie naprawią
Na podstawie ustaleń społeczności, oto najlepsze obejścia:
Dla użytkowników Mac, porzuć całkowicie terminal IDE. Użyj prostego samodzielnego terminala bash, takiego jak natywny Terminal.app lub iTerm2. Migotanie nadal występuje, ale przynajmniej nie zawiesi całego środowiska programistycznego.
Zmniejsz przewijanie terminala do 500 linii lub mniej w ustawieniach terminala. To nie naprawia błędu, ale zmniejsza jego nasilenie.
Używaj /clear często między promptami, aby zresetować bufor. To opóźnia, ale nie zapobiega ewentualnemu załamaniu.
Unikaj zintegrowanych terminali VS Code i Cursor całkowicie dla sesji Claude Code. Zewnętrzne terminale lepiej radzą sobie z nadużyciami.
Utrzymuj krótkie sesje. Jeśli wykonujesz ciężką pracę agentową z podagentami, spodziewaj się, że migotanie się nasili. Restartuj, zanim się zawiesi.
Wyłącz przyspieszenie GPU i płynne przewijanie w swoim terminalu, jeśli takie opcje istnieją.
Podsumowanie: dziewięć miesięcy, ponad 700 głosów, 6700 zdarzeń przewijania na sekundę, zero poprawek. Używaj obejść, bądź cierpliwy i może dodaj swój głos do stosu.
Powiązane zgłoszenia GitHub
- [#3648 - Terminal Scrolling Uncontrollably] - 282 głosy, najbardziej głosowane zgłoszenie migotania
- [#1913 - Terminal Flickering] - 181 głosów
- [#769 - In-progress Call causes Screen Flickering] - 168 głosów, oryginalny kompleksowy raport z kwietnia 2025
- [#9935 - Excessive scroll events causing UI jitter] - Głęboka analiza techniczna pokazująca 6700 przewinięć na sekundę
- [#10794 - Critical: Terminal Flickering Causes Complete VSCode Crashes] - Dokumentuje całkowite awarie IDE na macOS
- [#9658 - Multiple Claude Code instances spawning] - Dokumentuje niekontrolowane tworzenie procesów
- [#7276 - VS Code Terminal Flickering and Crash During Long Conversations] - Raporty awarii VS Code
- [#392 - Flickering display] - Jeden z najwcześniejszych raportów z marca 2025
