Claude Codeのターミナルちらつき問題:700以上の賛成票、9ヶ月経過、未だ未解決
Claude Codeには、IDE全体をクラッシュさせ、システムを使用不能にし、光感受性のあるユーザーに発作を引き起こす可能性があるほど深刻なターミナルレンダリングの問題があります。このバグは2025年3月から報告されています。複数のissueで合計1000以上の賛成票を集めています。そして2025年12月現在、未だ修正されていません。
この惨事の規模
ターミナルスクロールが完全に暴走する問題を記録したissue #3648には282のいいね反応があります。issue #1913には181のいいねがあります。2025年4月のissue #769には168のいいねがあります。リポジトリ全体には、同じ根本的な問題を説明する重複issueが少なくとも十数件散在しています。
1000人以上の開発者が同じバグについて叫んでいるのは、些細な問題ではありません。これは組織的な失敗です。
ある開発者は、Claude Codeがターミナルに対して何をしているのかを実際に計測しました。issue #9935の調査結果は本当に衝撃的です:毎秒4,000から6,700のスクロールイベント。根本原因は、Claude Codeがストリーミング出力の各チャンクごとにターミナル全体を再描画しており、まともなターミナルアプリケーションのように増分更新を行っていないことです。
ユーザーが体験すること
実際の動作を見る:[元のバグレポート]には、通常使用中にターミナルがストロボライトのようになる様子を示すビデオが含まれています。
VS CodeとCursorでは、ターミナルがちらつき始め、徐々に悪化し、10〜20分後にエディタ全体がフリーズしてクラッシュします。保存されていない作業はすべて失われます。
スタンドアロンターミナルでは、クラッシュなしでストロボライト効果が発生します。古い会話履歴が新しい出力と混ざって点滅します。スクロールバーが不規則に跳ねます。Claudeが考えている間に入力するのは苦痛です。
ターミナルが勝手に超高速でスクロールし始め、ターミナルタブを終了してClaudeを再起動しない限り止められないことがよくあります。プロンプトを入力しようとしているときに、入力している場所を見つけるために繰り返しスクロールダウンしなければならないこともあります。
一部のユーザーは、このバグが最大7つの並列Claude Codeプロセスを生成し、それぞれがCPUを消費しながらターミナルが無限にちらつき、応答がないと報告しています。
アクセシビリティの問題
元のバグレポートは、これを明示的にアクセシビリティの懸念事項として指摘しています。急速な画面の点滅は、光感受性てんかんの既知のトリガーです。Webコンテンツアクセシビリティガイドラインは、1秒間に3回以上点滅するコンテンツに対して警告しています。Claude Codeは毎秒数千回点滅します。
AnthropicはAI安全性に深くコミットしていると宣伝していますが、既知のアクセシビリティハザードを持つ製品を9ヶ月間出荷し続けています。
なぜこれが簡単に修正できるはずなのか
これは深いアーキテクチャ上の問題ではありません。修正は概念的にシンプルです:更新のたびにターミナルバッファ全体を再描画するのをやめる。カーソル位置を使用して、変更された部分だけを更新します。これは1970年代から理解されている基本的なターミナルプログラミングです。
派手なビジュアルインターフェースが複雑すぎて増分レンダリングできないなら、シンプルにしてください。IDEをクラッシュさせる見栄えの良いインターフェースよりも、動作するプレーンテキストモードをユーザーに提供してください。
修正されるまでの生き残り方
コミュニティの調査結果に基づいて、最良の回避策を紹介します:
Macユーザーの場合、IDEターミナルを完全に捨ててください。ネイティブのTerminal.appやiTerm2のようなシンプルなスタンドアロンbashターミナルを使用してください。ちらつきは依然として発生しますが、少なくとも開発環境全体がクラッシュすることはありません。
ターミナル設定でターミナルスクロールバックを500行以下に減らす。これはバグを修正しませんが、深刻度を軽減します。
プロンプト間で**/clearを頻繁に使用**してバッファをリセットします。これは最終的なメルトダウンを遅らせますが、防ぐことはできません。
Claude CodeセッションではVS CodeとCursorの統合ターミナルを完全に避ける。外部ターミナルの方が負荷に耐えられます。
セッションを短く保つ。サブエージェントを使った重いエージェント作業を行っている場合、ちらつきが悪化することを予期してください。クラッシュする前に再起動してください。
ターミナルにそのようなオプションがある場合、GPUアクセラレーションとスムーススクロールを無効にする。
結論:9ヶ月、700以上の賛成票、毎秒6,700のスクロールイベント、修正ゼロ。回避策を使用し、辛抱強く待ち、もしかしたら山積みの賛成票にあなたの票を追加してください。
関連するGitHub Issues
- [#3648 - Terminal Scrolling Uncontrollably] - 282の賛成票、最も賛成票の多いちらつき問題
- [#1913 - Terminal Flickering] - 181の賛成票
- [#769 - In-progress Call causes Screen Flickering] - 168の賛成票、2025年4月の元の包括的なレポート
- [#9935 - Excessive scroll events causing UI jitter] - 毎秒6,700のスクロールを示す詳細な技術分析
- [#10794 - Critical: Terminal Flickering Causes Complete VSCode Crashes] - macOSでの完全なIDEクラッシュを記録
- [#9658 - Multiple Claude Code instances spawning] - 暴走するプロセス生成を記録
- [#7276 - VS Code Terminal Flickering and Crash During Long Conversations] - VS Codeクラッシュレポート
- [#392 - Flickering display] - 2025年3月の最初期のレポートの1つ
