どこで止まっているのか？画面を確認してからプロセスを調べる
# 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、リアクション21件。2.1.1xxビルドではセッションの規模を問わず発生）。Anthropicのエンジニアは2.1.233で再現できなかったため、まず更新してください。古いビルドではプロセスを終了し、巻き戻す代わりに次で再開してください：
claude -c。巻き戻しは行わないでください。 - Remote Controlセッションが実行中にフリーズし、ローカルの`Esc`でしか復帰しない (#51267、未解決）。ツールやサブプロセスがブロックすると、リモートセッション全体がフリーズし、リモートからキャンセルできません。このようなセッションは短くし、入力を求める可能性のあるツールは避けてください。
- MCP認証プロンプトが`Enter`でハングする (#42707、未解決）。別の次のコマンドからサーバーを認証してください：
claude mcp。またはブラウザーで認証し、その後セッションを再起動してください。 - 組み込みマッチャー経由の`grep`がすべてのメモリを消費する (#54394）：ネイティブビルドでは、シェルの各
grepが次のプロセス内で実行されます：claude。このプロセスは独自のV8ヒープを持ちます。長い圧縮済みの行に対するバックトラッキング正規表現の処理でメモリ使用量が数ギガバイトに膨れ上がり、WSL2でもLinuxでもOOMキラーによってセッションごと終了します。圧縮済みファイルに対する無制限の正規表現を避け、ビルド出力と次を除外してください：node_modules。または、システムに次をインストールし、ripgrep明示的に呼び出してください。 - `400 thinking blocks cannot be modified`でリトライループから抜け出せない (#63231）— 会話履歴が無効で、リトライするたびに同じ理由で失敗します。
/rewindでターンの前まで戻すか、次を実行してください：/clear。詳しくは次を参照してください： 400ガイド. - **クラウド実行／スケジュール実行が「クラウドコンテナをセットアップしています」で停止する**（#53691, #54528）— サービス側の問題です。ローカルで対処できることはありません。キャンセルしてstatus.claude.com.を確認してください。
- 大規模なセッションの再開に数分かかる — 起動時にトランスクリプトが再生されます。最大のセッションではなく、必要な特定のセッションを再開し（
claude -r）、巨大なセッションは圧縮で縮小してください。
起動時にハングする
次の実行直後に画面が空白になる場合： claude 。プロンプトも表示されない場合、通常は最初のAPI呼び出しが応答していません。原因は、停止したプロキシを指すプロキシ変数、VPN、DNS、または到達不能な ANTHROPIC_BASE_URLです。次のガイドにあるcurlチェックを実行してください： 接続エラーガイド。続いて次を実行してください： 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で終了しました では、Windowsで孤立したプロセスのケースを説明しています）。
クライアントではなくAPIが原因の場合
小さなスピナーが表示され、やがてリトライの行が出る状態で、毎ターン同じ箇所でハングするセッションは、クライアントのバグではなく、APIへの通信経路が遅いか切断されています。原因は次のいずれかです： 529 過負荷, サーバー側のスロットリング または接続のリセットです。ゲートウェイ（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よくある質問
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キーを取得 無制限プランを見るAI Prime Techは独立したAPIゲートウェイであり、Anthropicとの提携関係はなく、同社の推奨や支援も受けていません。「Claude」と「Claude Code」はAnthropicの商標です。ここで説明するClaude Codeの機能は、執筆時点のAnthropicの公開ドキュメントに基づいており、頻繁に変更されます。このページの料金とモデル一覧は、このゲートウェイの現在の設定から取得しています。