「Claude Codeに長いタスクを頼んだら途中で止まった」「ファイルを編集中に突然固まった」「コード生成が途中で終わって何も言わなくなった」——このような症状はClaude Codeユーザーから頻繁に報告されています。原因は複数あり、それぞれに対処法が異なります。この記事では症状ごとに原因を特定し、即座に使える解決策を解説します。
問題の症状
以下のような症状が該当します：
# ターミナルで止まる例 $ claude "src/以下のファイルをすべてリファクタリングして" > Working on it... （数分後、カーソルが点滅したまま何も起きない）
# VS Code拡張機能での症状 - チャット欄にスピナーが回り続ける - 「Thinking...」や「Working...」の表示が消えない - Ctrl+C を押しても応答しない
よくある具体的な症状： - 長時間タスク（大規模リファクタリング、大量ファイル読み込み）で止まる - ファイル数が多いプロジェクトで途中終了する - 「I'll continue...」と言ったまま次が来ない - ネットワーク切断後に再接続されない
原因の解説
原因1：コンテキストウィンドウ上限への到達
Claude Codeはセッション内の会話履歴・ファイル内容・ツール呼び出し結果をすべてコンテキストに積み上げます。大きなコードベースや長い会話ではコンテキスト上限（最大200Kトークン）に達し、それ以上の処理ができなくなります。
典型的なシナリオ： - 数十件のファイルを一括読み込みさせた - 何度もやり取りしてセッションが長くなった - 大きなファイル（10,000行以上）を丸ごと処理させた
原因2：使用量上限（Rate Limit）の到達
2026年3月〜4月にかけてAnthropicがピーク時間帯のセッション制限を強化しました。従来の使用量では余裕だったのに、突然制限に当たる症状が多数報告されています。
制限にかかるとClaude Codeは静かに止まることがあり、エラーメッセージが表示されないケースも存在します。
原因3：ネットワーク接続の不安定
Claude CodeはAPIを通じてAnthropicのサーバーと常時通信しています。Wi-Fi不安定・VPN切断・プロキシの問題などでセッションが切断されると処理が止まります。
原因4：ツール呼び出しのループ・エラー
特定の状況下でClaude Codeが内部的にツール（Bashコマンド実行、ファイル読み書き等）を繰り返し呼び出し続け、表向きは止まっているように見えることがあります。
原因5：VS Code拡張機能・エディタのキャッシュ問題
VS Code用Claude Code拡張機能のキャッシュが破損すると、処理が完了しているのに画面上では止まって見える状態になります。
原因6：Windowsのファイルパス問題
日本語フォルダ名やスペースを含むパスで実行すると、内部処理でエラーが発生して止まることがあります。
解決策（ステップバイステップ）
即時対応：強制終了して再開する
# ターミナルで止まっている場合 Ctrl + C # 処理を中断 # 再開する（前の会話を継続したい場合） claude --continue # 新規セッションで再開（履歴リセット） claude
対処法1：コンテキストを圧縮・分割する
長い会話を要約してリセット：
# Claude Codeに向けて /compact # 会話履歴を圧縮する（コンテキスト節約）
タスクを分割して依頼する：
# NG: 一度に大量のファイルを依頼 claude "src/以下の全ファイルをリファクタリングして" # OK: ディレクトリ単位で分割 claude "src/components/以下のファイルだけリファクタリングして" claude "src/utils/以下のファイルだけリファクタリングして"
大きなファイルを部分的に処理：
# 対象を絞り込む claude "auth.ts の100〜200行目だけ修正して"
対処法2：使用量上限を確認・回避する
# 使用量の残量を確認 claude /status # 利用制限のメッセージが出た場合は待機 # Pro/Maxプランは5時間ごとにリセット
ピーク時間帯を避ける： Anthropicが強化しているピーク時間は日本時間の21時〜翌3時（米国西海岸午前）です。この時間帯は制限が早く到達しやすいです。
対処法3：ネットワーク環境を改善する
# 接続テスト ping api.anthropic.com # Wi-Fiから有線に切り替える（推奨） # VPNを使用中の場合は一時的に無効化して試す
タイムアウト設定を調整：
// ~/.claude/settings.json { "timeout": 120000 // ミリ秒（デフォルト60秒→120秒に延長） }
対処法4：VS Codeのキャッシュをクリアする
# Windowsの場合 %APPDATA%\Code\Cache フォルダを削除 # macOSの場合 ~/Library/Application Support/Code/Cache フォルダを削除
- VS Code を完全終了する
- 上記キャッシュフォルダを削除（またはフォルダ名を変更）
- VS Code を再起動する
対処法5：ファイルパスの問題を解消する（Windows）
# 日本語パス・スペース含むパスは避ける # NG C:\ユーザー\鈴木\プロジェクト\src # OK: 英数字のみのパスに移動 C:\workspace\project\src
対処法6：Auto Modeを活用して長時間タスクを安定化する
Claude Code Auto Mode（2026年3月リリース）を有効にすると、タスクの途中で承認を求めずに処理が継続するため、対話待ちによる見かけ上の「止まり」が減少します。
// ~/.claude/settings.json { "autoMode": true }
補足・注意点
CLAUDE.mdでコンテキストを効率化する
プロジェクトルートに CLAUDE.md を置き、プロジェクト構成・ルール・禁止事項を記載しておくと、毎回の説明が不要になりコンテキスト消費を抑えられます。
# CLAUDE.md 例 ## プロジェクト構成 - src/ : メインソースコード - tests/ : テストコード ## 重要ルール - ファイルを変更する前は必ず読み込んで確認すること - テストファイルは変更しないこと
公式トラブルシューティングを確認する
Anthropicの公式ドキュメントにトラブルシューティングページがあります。最新のバグ情報・既知の問題は公式ドキュメントで定期的に更新されています。
バージョンを最新に保つ
# Claude Codeを最新バージョンに更新 npm install -g @anthropic-ai/claude-code@latest # バージョン確認 claude --version
