このページでは、Claude Code が実行中のパフォーマンス、安定性、検索の問題について説明します。その他の問題については、問題が発生している場所に一致するページから始めてください：Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
| 症状 | 移動先 |
|---|---|
command not found、インストール失敗、PATH の問題、EACCES、TLS エラー | インストールとログインのトラブルシューティング |
ログインループ、OAuth エラー、403 Forbidden、「organization disabled」、Bedrock/Vertex/Foundry 認証情報 | インストールとログインのトラブルシューティング |
| 設定が適用されない、フック が実行されない、MCP サーバーがロードされない | 設定をデバッグする |
API Error: 5xx、529 Overloaded、429、リクエスト検証エラー | エラーリファレンス |
model not found または you may not have access to it | エラーリファレンス |
| VS Code 拡張機能が接続されていない、または Claude を検出していない | VS Code 統合 |
| JetBrains プラグインまたは IDE が検出されない | JetBrains 統合 |
| CPU またはメモリ使用量が多い、応答が遅い、ハング、検索がファイルを見つけられない | パフォーマンスと安定性（下記） |
/doctor を実行して、インストール、設定、MCP サーバー、コンテキスト使用量の自動チェックを実行してください。claude がまったく起動しない場合は、代わりにシェルから claude doctor を実行してください。
パフォーマンスと安定性
これらのセクションでは、リソース使用量、応答性、検索動作に関連する問題について説明します。CPU またはメモリ使用量が多い
Claude Code はほとんどの開発環境で動作するように設計されていますが、大規模なコードベースを処理する場合、かなりのリソースを消費する可能性があります。パフォーマンスの問題が発生している場合：/compactを定期的に使用してコンテキストサイズを削減します- 主要なタスク間で Claude Code を閉じて再起動します
- 大規模なビルドディレクトリを
.gitignoreファイルに追加することを検討してください
/heapdump を実行して JavaScript ヒープスナップショットとメモリ分析を ~/Desktop に書き込みます。Linux でデスクトップフォルダがない場合、ファイルはホームディレクトリに書き込まれます。
分析は常駐セットサイズ、JS ヒープ、配列バッファ、および説明されていないネイティブメモリを表示し、成長が JavaScript オブジェクトにあるか、ネイティブコードにあるかを識別するのに役立ちます。Chrome DevTools のメモリ → ロードで .heapsnapshot ファイルを開いて、リテイナーを検査します。メモリの問題を報告するときに両方のファイルを GitHub に添付します。
自動コンパクションがスラッシングエラーで停止する
Autocompact is thrashing: the context refilled to the limit... が表示される場合、自動コンパクションは成功しましたが、ファイルまたはツール出力がコンテキストウィンドウを数回連続で満杯に戻しました。Claude Code は進捗を遂行していないループで API 呼び出しを無駄にするのを避けるために再試行を停止します。
回復するには：
- Claude に、ファイル全体ではなく、特定の行範囲または関数など、より小さなチャンクで大きなファイルを読むよう依頼します
/compactを実行して、大きな出力を削除するフォーカスを使用します（例：/compact keep only the plan and the diff）- 大規模ファイルの作業を subagent に移動して、別のコンテキストウィンドウで実行されるようにします
- 以前の会話がもう必要ない場合は
/clearを実行します
コマンドがハングまたはフリーズする
Claude Code が応答しないように見える場合：- Ctrl+C を押して現在の操作をキャンセルしてみます
- 応答しない場合は、ターミナルを閉じて再起動する必要があります
claude --resume を実行してセッションを再開してください。
検索と発見の問題
Search ツール、@file メンション、カスタムエージェント、またはカスタムスキルがファイルを見つけられない場合、バンドルされた ripgrep バイナリがシステムで実行されない可能性があります。プラットフォームの ripgrep パッケージをインストールして、Claude Code にそれを使用するよう指示します：
- macOS
- Ubuntu/Debian
- Alpine
- Arch
- Windows
USE_BUILTIN_RIPGREP=0 を設定します。
WSL での遅い、または不完全な検索結果
WSL でファイルシステム間で作業する場合のディスク読み取りパフォーマンスペナルティにより、WSL で Claude Code を使用する場合、Search ツール使用時に予想より少ないマッチが返される可能性があります。検索は機能しますが、ネイティブファイルシステムより少ない結果を返します。この場合、
/doctor は Search を OK として表示します。- より具体的な検索を送信する：検索するファイル数を減らすために、ディレクトリまたはファイルタイプを指定します：「auth-service パッケージで JWT 検証ロジックを検索」または「JS ファイルで md5 ハッシュの使用を見つける」。
-
プロジェクトを Linux ファイルシステムに移動する：可能であれば、プロジェクトが Windows ファイルシステム（
/mnt/c/）ではなく Linux ファイルシステム（/home/）に配置されていることを確認します。 - ネイティブ Windows を使用する：WSL ではなく Windows でネイティブに Claude Code を実行することを検討して、ファイルシステムのパフォーマンスを向上させます。
さらにヘルプを得る
ここで説明されていない問題が発生している場合：/doctorを実行して、インストール状態、設定の有効性、MCP 設定、コンテキスト使用量を一度にチェックします- Claude Code 内で
/feedbackコマンドを使用して、Anthropic に問題を直接報告します - GitHub リポジトリで既知の問題を確認します
- Claude に直接その機能と機能について質問します。Claude はドキュメントへの組み込みアクセスを持っています。