どれが当てはまるかわからない場合は、Claude Code 内で
/doctor を実行して、インストール、設定、拡張機能、コンテキスト使用量の自動チェックを実行してください。確認後に適用できる修正を提案します。claude がまったく起動しない場合は、代わりにシェルから claude doctor を実行してください。MCP サーバーのステータスを確認するには /mcp を実行してください。
パフォーマンスと安定性
これらのセクションでは、リソース使用量、応答性、検索動作に関連する問題について説明します。CPU またはメモリ使用量が多い
Claude Code はほとんどの開発環境で動作するように設計されていますが、大規模なコードベースを処理する場合、かなりのリソースを消費する可能性があります。パフォーマンスの問題が発生している場合：/compactを定期的に使用してコンテキストサイズを削減します。Not enough messages to compact.が返される場合、カンバセーションのターン数が少なすぎて要約できません。これは、単一の大規模なペーストがコンテキストを満杯にした場合でも、コンテキストが満杯でも発生する可能性があります- 主要なタスク間で Claude Code を閉じて再起動します
- 大規模なビルドディレクトリを
.gitignoreファイルに追加することを検討してください claude --safe-modeで再起動して、プラグイン、MCP サーバー、またはフックが原因かどうかを確認します。セッション中のすべてのカスタマイズが無効になります。使用量が低下した場合は、設定をデバッグするを参照して、どれが原因かを特定します
claude --continue を実行し、新しいプロセスでカンバセーションを再開します。
フルスクリーンレンダリングの外では、/compact を実行するとメモリも解放されます。メモリ使用量が 2.5GB を下回ると、警告は消えます。
これらのステップ後もメモリ使用量が高いままの場合は、/heapdump を実行して 2 つのファイルを ~/Desktop に書き込みます。<session-id>.heapsnapshot という名前の JavaScript ヒープスナップショットと、<session-id>-diagnostics.json という名前のメモリ分析です。Claude Code はコマンドメニューからコマンドを非表示にします。完全に入力してください。Linux でデスクトップフォルダがない場合、ファイルはホームディレクトリに書き込まれます。
コマンドはカンバセーションに要約も出力します。プロセスの合計メモリ、JS ヒープ内のメモリ量、ヒープ外のメモリ量を表示します。また、高いメモリ増加率や異常に多くのオープンハンドルなど、検出されたリーク指標も表示します。要約は、ほとんどのメモリが JS ヒープ（スナップショットがキャプチャする）にあるか、ネイティブメモリ（キャプチャしない）にあるかを示します。
出力に対して次の 2 つのいずれかを実行します：
- 報告する：GitHub issue を開き、
-diagnostics.jsonファイルのみを添付します。このファイルには、出力された要約の背後にある統計が含まれており、カンバセーション内容や認証情報は含まれていません - 自分で調査する：要約がほとんどのメモリが JS ヒープにあると示している場合、Chrome DevTools の Memory → Load で
.heapsnapshotファイルを開き、保持されたサイズでソートして、メモリを保持しているものを確認します
ターミナルで大きなテーブルが切り取られる
200 行以上の Markdown テーブルは、最初の 200 行とそれに続く… N more rows not shown 行をレンダリングします。表示のみが制限されます。完全なテーブルはカンバセーションに残り、/copy はすべての行をコピーします。ターミナルで読むには大きすぎるテーブルの場合は、Claude にファイルに書き込むよう依頼してください。v2.1.208 より前では、Claude Code はすべての行をレンダリングしていたため、非常に大きなテーブルを含むセッションを再開すると、再レンダリング中にスタールする可能性がありました。
自動コンパクションがスラッシングエラーで停止する
Autocompact is thrashing: the context refilled to the limit... が表示される場合、自動コンパクションは成功しましたが、ファイルまたはツール出力がコンテキストウィンドウを数回連続で満杯に戻しました。Claude Code は進捗を遂行していないループで API 呼び出しを無駄にするのを避けるために再試行を停止します。
回復するには：
- Claude に、ファイル全体ではなく、特定の行範囲または関数など、より小さなチャンクで大きなファイルを読むよう依頼します
/compactを実行して、大きな出力を削除するフォーカスを使用します（例：/compact keep only the plan and the diff）- 大規模ファイルの作業を subagent に移動して、別のコンテキストウィンドウで実行されるようにします
- 以前のカンバセーションがもう必要ない場合は
/clearを実行します
/clear の後にエラーが再発する場合は、/context を実行し、Messages 行とその上の行を比較します：
Messagesが最大の行である場合：新しい会話内のファイルまたはツール出力がウィンドウを再び満杯にしているため、手順 1〜3 をもう一度実行します- 他の行の合計のほうが大きい場合：セッション開始時に読み込まれるものによって作業の余地がほとんど残っていないため、起動時に読み込まれるものを削減します
コマンドがハングまたはフリーズする
Claude Code が応答しないように見える場合：- Ctrl+C を押して現在の操作をキャンセルしてみます
- 応答しない場合は、ターミナルを閉じて再起動する必要があります
claude --resume を実行してセッションを再開してください。
エディタの統合ターミナルでのテキストの文字化けまたは破損
VS Code、Cursor、または Devin Desktop の統合ターミナルで Claude Code を実行する場合、文字がボックス、スミア、または間違ったグリフとしてレンダリングされる場合、ターミナルの GPU レンダラーが原因である可能性があります。Claude Code 内で/terminal-setup を実行して、terminal.integrated.gpuAcceleration を "off" に設定するか、エディタの設定で手動で設定してウィンドウをリロードします。ターミナル設定で、/terminal-setup が書き込む他の設定を参照してください。
フルスクリーンレンダリングでマウスホイールが一度に 1 行スクロールする
フルスクリーンレンダリングでは、Claude Code はカンバセーション自体をスクロールし、ターミナルに任せません。各ホイールノッチが希望より少ない行を移動する場合、/scroll-speed を実行してノッチあたりの行数を増やして保存するか、CLAUDE_CODE_SCROLL_SPEED 環境変数を設定します。ただし、JetBrains IDE ターミナルでは、Claude Code は独自のスクロール処理を適用し、どちらも有効になりません。マウスホイールスクロールで、各値が受け入れるものを参照してください。
速度を変更せずにより速く移動するには、PgUp と PgDn を押して一度に半画面スクロールします。スクロールをターミナルのネイティブスクロールバックに戻すには、/tui default を実行してクラシックレンダラーに切り替えます。
サンドボックス内で pbcopy などのクリップボードコマンドが失敗する
サンドボックスがオンの場合、pbcopy、xclip、wl-copy などのクリップボードユーティリティは、サンドボックス化された Bash コマンド内からシステムクリップボードに到達できず、Claude がテキストをパイプした後、クリップボードが変更されないままになる可能性があります。
Claude の出力をクリップボードに配置するには、Claude に応答でコンテンツを出力するよう依頼してから、/copy を実行します。/copy はサンドボックス化されたコマンドではなく Claude Code プロセス自体からクリップボードに書き込むため、サンドボックスはそれをブロックしません。応答全体ではなく単一のコードブロックをコピーでき、コピーしたものをファイルに書き込んで、パスを出力します。これにより、クリップボード書き込みがターミナルに到達しない場合（例えば SSH 経由）のフォールバックが提供されます。
Claude がテキストをこれらのツールにパイプする場合、pbcopy *、wl-copy *、または xclip * を excludedCommands に追加しても、そのコマンドをサンドボックスの外で実行することはできません。
SSH 経由でコピーされたテキストがローカルクリップボードに到達しない
Claude Code がリモートマシンで SSH 経由で実行されている場合、ローカルマシンでクリップボードツールを実行できません。tmux の外では、フルスクリーンレンダリングでテキストを選択するか/copy を実行すると、Claude Code はテキストを OSC 52 エスケープシーケンスとしてターミナルに送信します。ターミナルがそれをクリップボードに配置するかどうかを決定します。/copy は、テキストが到達したかどうかに関わらず Copied to clipboard を報告し、tmux の外では選択通知は sent N chars via OSC 52 と表示されます。
一部のターミナルは OSC 52 に対応していません。iTerm2 は Settings > General > Selection > Applications in terminal may access clipboard をオンにするまで無視し、macOS Terminal.app はそれをサポートしていません。
OSC 52 なしでテキストを取得するには：
- ターミナルのネイティブ選択キーを押しながらドラッグしてから、ターミナルの通常のショートカット（
Cmd+Cなど）でコピーします。キーは Terminal.app ではFn、iTerm2 ではOptionです。ネイティブテキスト選択を保持で他のターミナルのキーを一覧表示します。 - リモートマシンで
CLAUDE_CODE_DISABLE_MOUSE=1を設定して、ターミナルがセッション全体の選択を処理するようにします。
検索と発見の問題
Search ツール、@file メンション、カスタムエージェント、またはカスタムスキルがファイルを見つけられない場合、バンドルされた ripgrep バイナリがシステムで実行されない可能性があります。プラットフォームの ripgrep パッケージをインストールして、Claude Code にそれを使用するよう指示します：
- macOS
- Ubuntu/Debian
- Alpine
- Arch
- Windows
USE_BUILTIN_RIPGREP を 0 に設定します。シェル環境または settings.json の env ブロックで設定します：
claude doctor を実行して、Search 行がシステム ripgrep のパスを表示していることを確認します。OK (bundled) ではなく。
WSL での遅い、または不完全な検索結果
WSL でファイルシステム間で作業する場合のディスク読み取りパフォーマンスペナルティにより、WSL で Claude Code を使用する場合、Search ツール使用時に予想より少ないマッチが返される可能性があります。検索は機能しますが、ネイティブファイルシステムより少ない結果を返します。claude doctor はこの場合、Search を OK として表示します。- より具体的な検索を送信する：検索するファイル数を減らすために、ディレクトリまたはファイルタイプを指定します：「auth-service パッケージで JWT 検証ロジックを検索」または「JS ファイルで md5 ハッシュの使用を見つける」。
-
プロジェクトを Linux ファイルシステムに移動する：可能であれば、プロジェクトが Windows ファイルシステム（
/mnt/c/）ではなく Linux ファイルシステム（/home/）に配置されていることを確認します。 - ネイティブ Windows を使用する：WSL ではなく Windows でネイティブに Claude Code を実行することを検討して、ファイルシステムのパフォーマンスを向上させます。
さらにヘルプを得る
ここで説明されていない問題が発生している場合：/doctorを実行してセットアップをチェックし、/mcpを実行して MCP サーバーのステータスを確認します- Claude Code 内で
/feedbackコマンドを使用して、Anthropic に問題を直接報告します - GitHub リポジトリで既知の問題を確認します
- Claude に直接その機能と機能について質問します。Claude はドキュメントへの組み込みアクセスを持っています。