Tremulação do Terminal no Claude Code: Mais de 700 Votos, 9 Meses, Ainda Quebrado
O Claude Code tem um problema de renderização de terminal tão grave que pode travar toda a sua IDE, tornar seu sistema inutilizável e potencialmente desencadear convulsões em usuários fotossensíveis. Este bug está documentado desde março de 2025. Acumulou mais de 1000 votos combinados em múltiplos issues. E em dezembro de 2025, permanece sem correção.
A Escala Deste Desastre
O issue #3648 documentando a rolagem do terminal ficando completamente descontrolada tem 282 reações de curtida. O issue #1913 tem 181 curtidas. O issue #769 de abril de 2025 tem 168 curtidas. Existem pelo menos uma dúzia de duplicatas espalhadas pelo repositório, todas descrevendo o mesmo problema fundamental.
Mais de 1000 desenvolvedores gritando sobre o mesmo bug não é um problema marginal, é uma falha sistêmica.
Um desenvolvedor realmente instrumentou o que o Claude Code faz com os terminais. As descobertas do issue #9935 são genuinamente chocantes: 4.000 a 6.700 eventos de rolagem por segundo. A causa raiz é que o Claude Code realiza um redesenho completo do terminal a cada pedaço de saída em streaming, em vez de fazer atualizações incrementais como qualquer aplicação de terminal sensata.
O Que os Usuários Experimentam
Veja em ação: O [relatório original do bug] inclui um vídeo mostrando o terminal se transformando em uma luz estroboscópica durante o uso normal.
No VS Code e Cursor, o terminal começa a tremer, piora progressivamente, então o editor inteiro congela e trava após 10 a 20 minutos, levando todo o trabalho não salvo junto.
Em terminais independentes, você obtém o efeito de luz estroboscópica sem os travamentos. O histórico antigo de conversas pisca misturado com a nova saída. A barra de rolagem pula erraticamente. Digitar enquanto o Claude pensa é um exercício de frustração.
O terminal começa a rolar super rápido sozinho e frequentemente você não consegue pará-lo a menos que mate a aba do terminal e reinicie o Claude. Outras vezes, quando você está tentando digitar seu prompt, precisa rolar repetidamente para baixo para encontrar onde está digitando.
Alguns usuários relatam o bug gerando até sete processos paralelos do Claude Code, cada um consumindo CPU enquanto o terminal pisca infinitamente sem resposta.
O Problema de Acessibilidade
O relatório original do bug explicitamente sinalizou isso como uma preocupação de acessibilidade. Piscadas rápidas de tela são um gatilho conhecido para epilepsia fotossensível. As Diretrizes de Acessibilidade para Conteúdo Web alertam contra conteúdo piscando mais de três vezes por segundo. O Claude Code pisca milhares de vezes por segundo.
A Anthropic se posiciona como profundamente comprometida com a segurança de IA, mas lançou um produto com um perigo de acessibilidade conhecido por nove meses.
Por Que Isso Deveria Ser Fácil de Corrigir
Este não é algum problema arquitetural profundo. A correção é conceitualmente simples: pare de redesenhar todo o buffer do terminal a cada atualização. Use posicionamento de cursor para atualizar apenas o que mudou. Esta é programação básica de terminal compreendida desde os anos 1970.
Se a interface visual sofisticada é muito complexa para renderizar incrementalmente, simplifique-a. Dê aos usuários um modo de texto simples que funciona em vez de uma interface bonita que trava sua IDE.
Como Sobreviver Até Eles Corrigirem
Baseado nas descobertas da comunidade, aqui estão as melhores soluções alternativas:
Para usuários de Mac, abandone completamente o terminal da IDE. Use um terminal bash simples e independente como o Terminal.app nativo ou iTerm2. A tremulação ainda acontece, mas pelo menos não travará todo o seu ambiente de desenvolvimento.
Reduza o histórico de rolagem do terminal para 500 linhas ou menos nas configurações do seu terminal. Isso não corrige o bug, mas reduz a gravidade.
Use /clear frequentemente entre prompts para resetar o buffer. Isso atrasa, mas não previne o colapso eventual.
Evite completamente os terminais integrados do VS Code e Cursor para sessões do Claude Code. Terminais externos lidam melhor com o abuso.
Mantenha sessões curtas. Se você está fazendo trabalho agêntico pesado com subagentes, espere que a tremulação piore. Reinicie antes que trave.
Desabilite aceleração de GPU e rolagem suave no seu terminal se essas opções existirem.
A linha de fundo: nove meses, mais de 700 votos, 6.700 eventos de rolagem por segundo, zero correção. Use soluções alternativas, mantenha a paciência e talvez adicione seu voto à pilha.
Issues Relacionados no GitHub
- [#3648 - Terminal Scrolling Uncontrollably] - 282 votos, o issue de tremulação mais votado
- [#1913 - Terminal Flickering] - 181 votos
- [#769 - In-progress Call causes Screen Flickering] - 168 votos, o relatório abrangente original de abril de 2025
- [#9935 - Excessive scroll events causing UI jitter] - Análise técnica profunda mostrando 6.700 rolagens por segundo
- [#10794 - Critical: Terminal Flickering Causes Complete VSCode Crashes] - Documenta travamentos completos da IDE no macOS
- [#9658 - Multiple Claude Code instances spawning] - Documenta geração descontrolada de processos
- [#7276 - VS Code Terminal Flickering and Crash During Long Conversations] - Relatórios de travamento do VS Code
- [#392 - Flickering display] - Um dos primeiros relatórios de março de 2025
