Claude Code が固まる・フリーズする？完全対処ガイド

「Compacting conversation…」（会話を圧縮中）で固まる

コンテキストウィンドウが満杯に近づくとオートコンパクトが発火し、Claude Code はそれまでの会話を要約して差し替えます。本当に巨大なセッションなら数分かかるのは正常——しかも v2.1.282 と v2.1.284 では、要約リクエストの拒否で圧縮が失敗する問題や、圧縮後に「Prompt is too long」が残る問題が実際に修正されています。普通のサイズのセッションが2、3分より長く止まっているなら、それは作業中ではなく固まっています。

1. 1セッションが本当に巨大なら、まず2、3分は待ちましょう——v2.1.283 で圧縮スピナーが作り直され、タイマーは圧縮が実際に始まってから動くようになりました。
2. 2それを過ぎたら Esc、続いて Ctrl+C で圧縮をキャンセル。公式ドキュメントは、Ctrl+C は現在の操作だけを取り消しセッションは破棄しないと明記しています。
3. 3手動で焦点を絞って圧縮し、かさばるツール出力を要約から落とします。例：/compact keep only the plan and the diff。
4. 4古い履歴を捨てていいなら /clear で整理し——かつ、v2.1.284 以降に更新して修正済みの圧縮リトライを手に入れましょう。

/compact keep only the plan and the diff/clear

「Almost done thinking…」で固まる

直感に反しますが、このスピナーラベルは進捗表示ではありません：メンテナーが issue #63387 で、ローテーションするフレーズはモデルの実際の推論状態に対応しないと確認しています。だから「almost done」は何分も居座り得て、issue #55328 には拡張思考が長引く間 Esc も Ctrl+C も効かなかったターンが記録されています。

1. 1まず Esc を一度押して数秒待ち、スピナーが回り続けるなら Ctrl+C。
2. 2入力が死んだままなら、ターミナルのタブを閉じて新しく開き、同じディレクトリで claude --resume を実行してセッションを拾い直します。
3. 3長いターンが毎回同じように固まるなら、Claude Code を更新した上で、MCP サーバーやフックの停滞を疑いましょう——思考の停滞と見分けがつかないためです。/mcp を見ればどのサーバーが悪さをしているか分かります。

claude --resume

「Not responding — try stopping」

このオレンジのバナーは Claude Code のウォッチドッグです：ツール呼び出し——大抵は長い bash コマンド——が一定時間静かだと、UI が停止ボタンを差し出します。これは注意喚起であって診断ではありません：Anthropic 自身のデモでは、バナーの下でプロセスが普通に動き続けていたこともあり、Claude Code のリードである Boris Cherny はこの状態の録画を公に募集しています——チームは認知し調査中という意味です。

1. 1まず下のコマンドがまだ出力を生んでいるか確認——静かにコンパイル中のビルドは中断する必要がありません。
2. 2本当に詰まっていると確認できたら、Esc かオレンジの停止ボタンでそのターンを中断します。
3. 3自分が手動で止めたことを Claude に伝えてください——手動停止の後、モデルはツールが拒否されたと誤解して、続きではなく謝罪から始めることがあります。
4. 4長い処理はバックグラウンドで、または小刻みに実行し直し、フォアグラウンドのウォッチドッグを再発火させないようにします。

claude --resume

既知の荒い縁：Anthropic 自身のこのバナーのデモでは、停止ボタンが出た瞬間もコマンドは健常でした——止める前に確認を。

「Resuming container…」で固まる（クラウドセッション）

Claude Code の Web・モバイルセッションはクラウドのコンテナで動きます。古いセッションを開き直すということは、コンテナを起こし直してトランスクリプトをストリーミングすることで、履歴が大きいほど本当に時間がかかります。v2.1.286 は、超大きな履歴のセッションが、トランスクリプトの読み込み中にコンテナが止まったせいで二度と復帰しないバグを修正しました。

1. 1まず数分待ちます——コールドなコンテナ再開は新規セッションより遅く、動いていることを告げるプログレスバーもありません。
2. 2CLI を v2.1.286 以降に更新——claude update、または npm install -g @anthropic-ai/claude-code——あのリリースが超大きなクラウド履歴が目覚めないバグを修正しました。
3. 3更新後も凍ったまま？Web セッションを再読み込みし、それでもだめなら新しいセッションを開いて作業を続けます。

claude updatenpm install -g @anthropic-ai/claude-code

コミュニティの回避策、公式回答は未出：複数のユーザーがコンテナは5分前後に目覚めたと報告しています——それを過ぎてから死んだと判断しましょう。

起動時にフリーズする

プロンプトが表示される前のフリーズは、ほぼ例外なくローカルの問題です：クラッシュする MCP サーバー、プラグイン、フック、壊れた状態、あるいは拡張機能。v2.1.284 は Restart Extensions 後にタブが応答しなくなる問題を、v2.1.286 は拡張機能が停止応答したときの終わらない「Teleporting session…」スピナーを修正しました。アプリ内の /doctor はセッションが生きていなければ使えないので、シェルから始めます。

1. 1ターミナルから claude doctor を実行——起動しないケースについて公式ドキュメントが推奨する正是です。インストールを検査し、修正案を提示します。
2. 2claude --safe-mode で起動します。これはそのセッション限りで全プラグイン・MCP サーバー・フックを無効化します——起動できたら、犯人はそのカスタマイズの中にいます。
3. 3カスタマイズを一つずつ再有効化するか——入れるなら /mcp を回して——犯人を特定し、更新するか削除します。
4. 4VS Code なら拡張機能も更新——上の2つの 2.1.28x 修正は現行バージョンにしか存在しません。

claude doctorclaude --safe-mode

ターミナルでフリーズする

定番の全ウィンドウフリーズ——入力死亡、スピナー停止、Ctrl+C 無視——には公式の型があります：キャンセルを試み、必要ならターミナルを再起動し、セッションを再開する。どちらにせよ失うものはありません。エディタの統合ターミナルで出力が文字化け・欠落するのは別問題で、GPU アクセラレーションに原因があり、コマンド一つで直ります。

1. 1Ctrl+C で現在の操作のキャンセルを試みます。
2. 2ウィンドウが応答なしなら、ターミナルを完全に閉じて新しく開きます。
3. 3新しいターミナルで、同じプロジェクトディレクトリにて claude --resume——公式ドキュメントは会話は失われないと約束しています。
4. 4VS Code の統合ターミナルで出力が化けるなら /terminal-setup——ターミナルの GPU アクセラレーションを切って、化けを解消します。

claude --resume/terminal-setup