Source: https://aiprimetech.io/ja/claude-code/errors/claude-code-hangs/

[ホーム](/ja/) › [Claude Code](/ja/claude-code/) › [エラー](/ja/claude-code/errors/) › ハング / 停止

[概要](/ja/claude-code/)[インストール](/ja/claude-code/install/)[CLIリファレンス](/ja/claude-code/cli/)[料金と制限](/ja/claude-code/pricing/)[Agent SDK](/ja/claude-code/sdk/)[スキルとプラグイン](/ja/claude-code/skills/)[GitHub](/ja/claude-code/github/)[ウェブ、デスクトップ、IDE](/ja/claude-code/web-and-desktop/)[モデル](/ja/claude-code/models/)[エラー](/ja/claude-code/errors/)[オープンソース？](/ja/claude-code/open-source/)[チュートリアル](/ja/claude-code/tutorial/)[学生向け](/ja/claude-code/for-students/)[QA自動化](/ja/claude-code/qa-automation/)[Cursorとの比較](/ja/claude-code/vs-cursor/)[Codex・OpenCodeとの比較](/ja/claude-code/vs-codex/)[サブエージェント](/ja/claude-code/subagents/)[フック](/ja/claude-code/hooks/)[MCP](/ja/claude-code/mcp/)[エコシステム](/ja/claude-code/ecosystem/)[VS Code](/ja/claude-code/vscode/)[OpenRouter](/ja/claude-code/openrouter/)[レート制限](/ja/claude-code/rate-limits/)[中国語ガイド](/claude-code/zh/)

最終更新：2026年10月11日

# Claude Codeがハングする、処理が進まない、応答しなくなる：停止箇所の特定方法と復旧方法

ハングには発生箇所があります。Claude CodeはAPI、起動したツール、MCPサーバー、ターミナル、または自身の処理を待っています。抜け出す方法はそれぞれ異なり、通常はプロセスを強制終了する前に、ステータス行でどれに該当するかを判断できます。

## TLDR
- APIを待機中 → トークン数付きの読み込み表示、または「APIの応答を待機中」の行が表示されます。これは [接続の問題](/ja/claude-code/errors/connection-lost/)であり、ハングではありません。
- ツールを待機中 → ツールの行が完了せずに残ります。 Esc でキャンセルできます。通常の原因は、入力待ちのシェルコマンドや、暴走した grep です。
- ユーザーの操作を待機中 → 承認や質問のプロンプトが画面外に隠れています。 Enter を押すか、スクロールしてください。
- 実際にハングしている（出力がなく、次の操作にも反応しない： Esc, Ctrl+C）→ プロセスを強制終了し、次のコマンドで再開してください： claude -c。以下の既知のバグを確認してください。

## どこで止まっているのか？画面を確認してからプロセスを調べる 

```
# in the session
Esc            # cancel the current tool or turn
Ctrl+C (twice) # abort the turn / exit
# from another terminal
ps aux | grep -E "claude|node" | grep -v grep     # child processes still running?
top -o cpu       # is claude spinning or idle?
claude --debug   # next time: timestamps for every request and tool call
claude -c        # resume the last session after a kill
```

プロンプトがフリーズしていてCPUがほぼ動いていない場合は、ネットワークストリーム、MCPサーバー、子プロセス、見えていないプロンプトなど、外部の何かを待っています。CPUが高使用率のままなら、巨大なツール結果の解析、正規表現のバックトラッキング、大きなセッションの読み込みなど、内部の処理を行っています。メモリ使用量が増え続ける場合は、ツールの結果やセッションファイルを丸ごと読み込んでいます。 

## トラッカーで確認されている原因 
- `/rewind`がハングし、`Ctrl+C`が無視され、`kill -9`が必要になる ([#53011](https://github.com/anthropics/claude-code/issues/53011)、リアクション21件。2.1.1xxビルドではセッションの規模を問わず発生）。Anthropicのエンジニアは2.1.233で再現できなかったため、まず更新してください。古いビルドではプロセスを終了し、巻き戻す代わりに次で再開してください： claude -c 。巻き戻しは行わないでください。
- Remote Controlセッションが実行中にフリーズし、ローカルの`Esc`でしか復帰しない ([#51267](https://github.com/anthropics/claude-code/issues/51267)、未解決）。ツールやサブプロセスがブロックすると、リモートセッション全体がフリーズし、リモートからキャンセルできません。このようなセッションは短くし、入力を求める可能性のあるツールは避けてください。
- MCP認証プロンプトが`Enter`でハングする ([#42707](https://github.com/anthropics/claude-code/issues/42707)、未解決）。別の次のコマンドからサーバーを認証してください： claude mcp 。またはブラウザーで認証し、その後セッションを再起動してください。
- 組み込みマッチャー経由の`grep`がすべてのメモリを消費する ([#54394](https://github.com/anthropics/claude-code/issues/54394)）：ネイティブビルドでは、シェルの各 grep が次のプロセス内で実行されます： claude 。このプロセスは独自のV8ヒープを持ちます。長い圧縮済みの行に対するバックトラッキング正規表現の処理でメモリ使用量が数ギガバイトに膨れ上がり、WSL2でもLinuxでもOOMキラーによってセッションごと終了します。圧縮済みファイルに対する無制限の正規表現を避け、ビルド出力と次を除外してください： node_modules。または、システムに次をインストールし、 ripgrep 明示的に呼び出してください。
- `400 thinking blocks cannot be modified`でリトライループから抜け出せない ([#63231](https://github.com/anthropics/claude-code/issues/63231)）— 会話履歴が無効で、リトライするたびに同じ理由で失敗します。 /rewind でターンの前まで戻すか、次を実行してください： /clear。詳しくは次を参照してください： [400ガイド](/ja/claude-code/errors/api-error-400/).
- **クラウド実行／スケジュール実行が「クラウドコンテナをセットアップしています」で停止する**（[#53691](https://github.com/anthropics/claude-code/issues/53691), [#54528](https://github.com/anthropics/claude-code/issues/54528)）— サービス側の問題です。ローカルで対処できることはありません。キャンセルしてstatus.claude.com.を確認してください。
- 大規模なセッションの再開に数分かかる — 起動時にトランスクリプトが再生されます。最大のセッションではなく、必要な特定のセッションを再開し（claude -r）、巨大なセッションは圧縮で縮小してください。 

## 起動時にハングする 

次の実行直後に画面が空白になる場合： claude 。プロンプトも表示されない場合、通常は最初のAPI呼び出しが応答していません。原因は、停止したプロキシを指すプロキシ変数、VPN、DNS、または到達不能な ANTHROPIC_BASE_URLです。次のガイドにあるcurlチェックを実行してください： [接続エラーガイド](/ja/claude-code/errors/connection-lost/)。続いて次を実行してください： claude doctor。起動が遅くても最終的にプロンプトが表示される場合は、MCPサーバーの起動が原因です。次を実行し、 claude mcp list タイムアウトするサーバーを削除してください。 

## 終了しない子プロセス 

エディターを開く、パスワードを待つ、ログを追跡する、開発サーバーを起動するといったシェルツールは処理を返さず、ターンはその終了を待ち続けます。エージェントにはサーバーをバックグラウンドで実行するよう指示し、入力を求める可能性があるコマンドには次を追加するよう指示してください： --no-pager, -y または < /dev/null 。すでに発生している場合は、 Esc でツールをキャンセルできます。子プロセスがそれを無視する場合は、別のターミナルからPIDを指定して終了してください。すると、ターンはエラーを受け取って続行します。 

## メモリとCPUの使用量が多い 
- ツールの結果は、セッション中、メモリとディスクに保持されます。200 MBのファイルを読み込むと、200 MBのセッションになります。必要な部分だけを読み込んでください。
- 多数のサブエージェントを並列実行すると、すべての使用量が倍増します。次を使用してください： CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2 。小規模なマシンでは特に有効です。
- 描画が遅いターミナルエミュレーター（一部のWindowsコンソールや、低帯域の回線経由のリモートtmux）では、ストリーミング出力がフリーズしているように見えます。次を使うと、 claude --debug トークンがまだ届いているか確認できます。
- アイドル中にメモリ使用量が増える場合は、クラッシュしたIDEセッションから残った次のプロセスを探してください： claude 。それらを終了してください（[プロセスがコード1で終了しました](/ja/claude-code/errors/process-exited-code-1/) では、Windowsで孤立したプロセスのケースを説明しています）。 

## クライアントではなくAPIが原因の場合 

小さなスピナーが表示され、やがてリトライの行が出る状態で、毎ターン同じ箇所でハングするセッションは、クライアントのバグではなく、APIへの通信経路が遅いか切断されています。原因は次のいずれかです： [529 過負荷](/ja/claude-code/errors/overloaded-529/), [サーバー側のスロットリング](/ja/claude-code/errors/usage-limit-reached/) または接続のリセットです。ゲートウェイ（ANTHROPIC_BASE_URL=https://aiprimetech.io）経由では、処理能力が限界に達した上流アカウントから別のアカウントにフェイルオーバーするため、まさにこのような停止時間を短縮できます。

## この問題への対処に疲れましたか？

代わりにAI Prime Techのゲートウェイ経由でClaude Codeを実行してください。ゲートウェイ独自のアップストリームアカウントで同じClaudeモデルを利用でき、環境変数を2つ変更するだけで切り替えられます。新規アカウントには $5分の無料APIクレジット を、コード FIXIT が付与されます。カードは不要です。

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[コードFIXITでアカウントを作成](/register?promo=FIXIT)

## よくある質問

Claude Codeが停止して応答しないのはなぜですか？

APIストリーム、起動したツール、MCPサーバー、画面外の承認プロンプトなど、何かを待っています。Escでツールをキャンセルし、Ctrl+Cを続けて押して中断してください。何も反応しない場合は、プロセスを終了してclaude -cで再開してください。/rewindでClaude Codeがハングする場合、どう直せますか？

最新のビルドに更新してください。このハングは2.1.1xxで報告されており、Anthropicは2.1.233では再現できませんでした。古いビルドではプロセスを終了し、/rewindの代わりにclaude -cを使用してください。Claude Codeが大量のメモリを使うのはなぜですか？

大きなツール結果とセッションのトランスクリプトが全体のまま保持され、サブエージェントによってそれらが増えます。また、ネイティブビルドでは、バックトラッキングを伴うgrep正規表現が、大きなV8ヒープを持つclaudeプロセス内で実行されます。読み込む量を減らし、ビルド出力を除外し、同時実行数を下げてください。Claude Codeが起動時にハングし、プロンプトが表示されません。何を確認すればよいですか？

最初のAPIリクエストが応答していません。プロキシ変数、VPN、DNS、または到達不能なANTHROPIC_BASE_URLを確認してください。エンドポイントに対してcurlを実行し、続いてclaude doctorを実行して、タイムアウトするMCPサーバーを削除してください。

## ゲートウェイでClaude Codeを実行

同じモデルを環境変数の設定だけで利用できます。額面の7.69231倍のクレジット、または定額無制限プランを選べます。 新規アカウント：コードFIXITで$5分の無料APIクレジット。[APIキーを取得](/register?promo=FIXIT) [無制限プランを見る](/ja/plans/)

AI Prime Techは独立したAPIゲートウェイであり、Anthropicとの提携関係はなく、同社の推奨や支援も受けていません。「Claude」と「Claude Code」はAnthropicの商標です。ここで説明するClaude Codeの機能は、執筆時点のAnthropicの公開ドキュメントに基づいており、頻繁に変更されます。このページの料金とモデル一覧は、このゲートウェイの現在の設定から取得しています。

## その他のClaude Codeガイド

[Claude Codeのエラーと修正方法](/ja/claude-code/errors/)[Claude Code「APIエラー：500」：意味と実際に有効な解決方法](/ja/claude-code/errors/api-error-500/)[Claudeの「過負荷」エラー（APIエラー529）：意味と対処方法](/ja/claude-code/errors/overloaded-529/)[Claude Code APIエラー400：プロンプトが長すぎる、ツール使用の並行処理、その他の問題](/ja/claude-code/errors/api-error-400/)[Claude CodeのOAuthエラー：15000msのタイムアウト超過とステータスコード500](/ja/claude-code/errors/oauth-error/)[「Claude Codeプロセスがコード1で終了しました」：実際のエラーの見つけ方と解決方法](/ja/claude-code/errors/process-exited-code-1/)[Claudeの「プロンプトが長すぎる」「指定されたモデルに対して入力が長すぎる」「コンテキスト上限に達しました」：ウィンドウが埋まる原因と空きを取り戻す方法](/ja/claude-code/errors/prompt-too-long/)[Claudeの使用量上限に到達：セッション、週次、Opusの上限、「指定されたAPI使用量上限」「クレジット残高が不足しています」— 対処方法](/ja/claude-code/errors/usage-limit-reached/)[Claude Codeの401と403：無効な認証情報、無効なAPIキー、「ログインしていません」、host_not_allowed](/ja/claude-code/errors/auth-401-403/)[Claude Codeの接続エラー：ECONNRESET、応答途中の接続切断、「API応答を待機中」「APIに接続できません」、SSL証明書エラー](/ja/claude-code/errors/connection-lost/)[Claude.aiが動作しない：「問題が発生しました」、処理容量の制約、「5時間の上限に達しました」、「ログイン中にエラーが発生しました」、その他の問題](/ja/claude-code/errors/claude-ai-not-working/)