Claude Code が動かない・遅い時に最初に試す切り分けチェックリスト

監修者_SD以外

監修者プロフィール

森下浩志

日本最大級のAI情報プラットフォーム「romptn ai」編集長。著書に「0からはじめるStable Diffusion」「0からはじめるStable Diffusion モデル・拡張機能集編」など、AmazonベストセラーのAI関連書籍を多数執筆。AIにおける情報の非対称性を解消するための社内研修や出張講義も行う。

この記事の対象と切り分けのゴール

先に守備範囲を揃えます。扱うのはターミナルから claude コマンドで動かす CLI 版の Claude Code に限定し、デスクトップアプリの Claude Desktop や、ブラウザの claude.ai は別物として扱います。

読者が最も時間を奪われるのは「自分の環境のせいか、それとも今 Anthropic 側で何か起きているのか」の切り分けです。本記事は次の 3 つの入口のどれからでも辿れる作りにしています。

進行順は、外側を当てる『第0手』→ 全体を見渡す『早見表』→ 症状で辿る章 → エラー文字列で辿る章 → 「エラーは出ないのに何かおかしい」を扱う章、の 5 段です。近い入口だけ読めば閉じる作りで、通読は不要です。

問題が自分側か Anthropic 側かを1分で当てる

自分の環境を触る前に、外側で起きていないかを 1 分で確認します。

見るのは次の 2 つです。役割が違うので両方ブックマークしておきます。

2026 年 4 月 28 日から 5 月 13 日までの 2 週間で 25 件の incident が記録されており、Windows 上で Claude Code の IDE 拡張が起動しなくなり 2 時間で v2.1.137 が出て収束した、という外側で完結する障害も含まれます。「昨日まで動いていたのに今日だけおかしい」と感じた時、status が赤くなっていないかを見るだけで、自分の設定をいじって時間を失う前に手が止まります。

status が両方とも緑であれば、次は公式の診断コマンドを 1 つ走らせます。

/doctor はインストール状態、設定ファイル、MCP サーバー、コンテキスト使用量を点検します。赤い項目の名前が、次に読むべき章の入口になります。認証まわりが落ちていれば「認証が通らない」、MCP が落ちていれば「MCP サーバーに繋がらない」へ。/doctor も claude doctor も走らない場合は起動以前の問題なので「起動しない・コマンドが見つからない」から読んでください。

5 分で当たりをつける症状とエラーの早見表

ここで読者がやるのは「自分のいるマスを 1 行決める」だけです。左の症状名で当てに行っても、真ん中の英文エラー文字列で当てに行っても、同じ行の右端にこの記事の中での飛び先が書いてあります。

症状名は自分の言葉、エラー文字列は画面に出ている文字そのままで構いません。ぴったり一致しなくても、近い行を 1 つ選んで先にそちらを読み切る方が、複数の章を往復するより早く答えに着きます。

どの行にも当てはまらない、あるいはエラー文字列が画面に出ていない場合は、最後の「エラーが出ないのに遅い・出力が違う時」の章から読み始めてください。エラーが見えない時こそ、自分の側のどこを触ったかから逆に辿る方が早く片付きます。

症状別に試す切り分け手順

ここからは、自分の症状を言葉で名指せる人向けの章です。下に並ぶ 5 つの番号のうち、自分の状況に一番近いものだけを読めば閉じる作りにしてあります。

症状の見極めは、厳密でなくて構いません。「ターミナルで claude と打った時点で詰まる」なら ①、「画面は出るのに入力を受け付けない」なら ③、というように、自分の言葉で一番近い番号を選んでください。

そして、どの症状でも共通の一手目があります。Claude Code に組み込まれた診断コマンド /doctor を走らせる、それだけです。claude が起動しない時はシェルから claude doctor を叩きます。インストール、設定、MCP サーバー、コンテキスト使用量を一括でチェックでき、Anthropic 公式も切り分けの起点として案内しています (Troubleshooting – Claude Code Docs)。まずはここを通すと、以降の手順で何を疑うかが見えやすくなります。

① 起動しない・コマンドが見つからない

ターミナルで claude と打った瞬間に、bash / zsh なら command not found、PowerShell や CMD なら「claude は認識されません」系が返るパターンです。

原因は シェルが claude を PATH 上に見つけられていない 1 点。次の順で潰します。

claude doctor も command not found なら、バイナリが無いか別バージョンを掴んでいます。npm uninstall -g @anthropic-ai/claude-code で消し Node ごと入れ直すのが最短。EACCES や proxy 経由の失敗は Claude Code インストールと認証のトラブルシューティング に網羅されています。

② 認証が通らない・ログインが終わらない

認証の代表症状は、/login の URL は飛んだのに戻ってこない、API キーを入れたのに Not authenticated が消えない、社内ネット経由で SELF_SIGNED_CERT_IN_CHAIN が出る、の三つです。

最初に潰すのは 環境変数 ANTHROPIC_API_KEY が /login を上書きするトラップ。.zshrc や .env に古いキーが残っていると、Pro / Max でログインしてもそちらが優先され「Not authenticated」が消えません。

10 パターンの全リストは Claude Code インストールと認証のトラブルシューティング にまとまっています。

③ 反応しない・固まる

Claude Code は起動しているのに、入力やコマンドを一切受け付けないパターンです。GitHub の issue でもよく報告される代表症状は次の 3 つで、見た目は似ています。

公式が案内している復旧手順は次の 3 ステップです。順番通りに進めれば、ほとんどの固まりはここで抜けられます。

④ rate limit・上限に当たった時

Claude Code で「上限に当たった」時に厄介なのは、上限が 1 種類ではないことです。

Pro / Max の購読プランには、独立して効く 3 つの上限が surface します。1 つでも当たれば、その上限のリセット時刻まで Claude Code は続きを断ります。

3 つは別バケツです。session に余裕があっても、weekly や Opus 枠が先に尽きれば止まります。リセット時刻は画面の文末に出るので、その時刻まで待つか、Pro / Max 加入者は extra usage を有効化して従量課金で続きを進める選択ができます。

行き当たる前に見たい時は、起動中の Claude Code で /status を実行します。プラン利用量バーで session・weekly・Opus の残りが分かり、長い作業に入る前に余力を確認できます。

プラン別の含み量や Max 5x / 20x の差、extra usage の挙動など料金面の詳細は、料金プランの解説記事で扱います。

⑤ MCP サーバーに繋がらない

MCP サーバーが繋がらない時は、まず /mcp を打って 3 タイプのどれに当たるかを切り分けます。

(a) spawn npx ENOENT で起動しない
Windows + 公式プラグインで多発するパターンで、Failed to connect も併発します。.mcp.json の command を npx ... から cmd /c npx ... に包むと回避できるケースが報告されています。設定ファイル側の問題です。

(b) Failed to connect (起動自体が失敗)
コマンドは合っているのに繋がらない時はサーバープロセス側を疑います。/mcp から Reconnect、駄目なら claude --debug mcp で stderr を見ます。command / args の相対パスが .mcp.json の位置ではなく起動ディレクトリ基準で解決される罠もここに含まれます。

(c) 接続済みなのに tools/call で固まる
/mcp 上は connected なのに、ツール呼び出しの瞬間からスピナーが止まらないパターン。まず Reconnect、それでも tools 数が 0 のままなら server 側ログを見ます。

切り分けの 2 軸は 設定ファイル (.mcp.json / settings) 側か、server プロセス・権限側か。(a) は設定側、(b) (c) はプロセス側に寄せて潰すと早いです。MCP 仕様は更新が早いので、最新の挙動は Claude Code MCP 公式ドキュメント で都度確認してください。

エラーメッセージ別の小辞典

ここからは、画面に出ている英文エラーをそのままコピペで引きたい人向けの章です。検索窓に英文を貼り付けて辿り着いた読者が、自分の文字列をそのまま見出しの直下で見つけられる作りにしています。各エントリの冒頭でエラー文字列を code で再掲し、想定原因と最短の一手を一塊で返します。

扱うのは、現時点で読者からの問い合わせが多い代表 4 件です。

各エントリの末尾には、前章の症状別の該当する見出しへの戻し先を添えています。エラー文字列から入っても、症状名から入っても同じ場所に辿り着けるよう、両方向で行き来できる作りです。

① claude: command not found

bash / zsh で claude: command not found、PowerShell や CMD で「claude は…として認識されません」系が返るパターンです。表記はシェルごとに変わりますが、起きていることは 1 つで、シェルが claude を PATH 上に見つけられていない だけです。

初回 npm i -g @anthropic-ai/claude-code 直後にターミナルを開き直していない、WSL 側に入れた Node を Windows 側のシェルから見ようとしている、sudo で入れて権限がずれた、といった原因が大半。手順は症状別の「① 起動しない・コマンドが見つからない」にまとめてあるので、PATH 反映 → Node のバージョン → WSL と Windows の混線、の順でそちらを辿ってください。

② spawn npx ENOENT

画面に spawn npx ENOENT と Failed to connect が並ぶケースです。MCP server を npx ... で起動している設定の時、Claude Code 側から npx の実体が見えていない (PATH 解決の失敗) のが原因で、特に Windows + 公式プラグイン (context7 / playwright など) で報告が多いパターンです。

切り分けは 2 手です。

これで MCP 自体は繋がるはずです。接続後の tools/call でスピナーが固まる、/mcp 上で tools 数が 0 のままなど症状側に派生した時は「⑤ MCP サーバーに繋がらない」を参照してください。

③ You hit your weekly limit 系

画面に出る上限メッセージは公式に 3 種類用意されています。session・weekly・Opus がそれぞれ独立した枠なので、どれに当たったかは文面で見分け、後ろの resets ... の時刻をそのまま読めば次に動かせる目安が分かります。

公式が surface する文面は次の通りです。

時刻はお使いのタイムゾーンで表示されるので、特別な読み替えは要りません。session は直近 5 時間枠、weekly は週次の合算枠、Opus は Opus 系モデル専用の枠が、それぞれの時刻でリセットされます。

似た雰囲気で別物なのが、長い会話の中で出る Autocompact is thrashing 系の context window 不足エラーで、こちらは 1 会話の長さの話なのでプラン上限とは独立して起きます。プラン 3 種の切り分けや、/status での先回り確認、extra usage への切り替え判断は、症状別の章「④ rate limit・上限に当たった時」で扱っています。

④ Unable to connect to API 系

画面に Unable to connect to API (関連: ECONNRESET / ETIMEDOUT) と出る時は、API ホストへの TCP 接続自体が落ちています。順番が肝心で、外側 → 経路 → 証明書の順で潰します。

まず第0手に戻り、status.anthropic.com が緑かを確認してください。Anthropic 側が落ちていれば、打つ手はありません。リトライは Claude Code 側で最大 10 回まで自動で行われており、それでも見える形でこのエラーが出ている以上は一過性ではないと割り切ります。

緑だった場合は、同じシェルから到達性を測ります。

curl -I https://api.anthropic.com

返ってこなければ VPN が api.anthropic.com を遮断している、または社内 proxy が未設定です。HTTPS_PROXY HTTP_PROXY NO_PROXY を環境変数で渡して再実行してください。Claude Code は SOCKS プロキシには対応していない点だけ注意します。

curl が SELF_SIGNED_CERT_IN_CHAIN で落ちる時は社内 CA が Node に信頼されていないだけです。NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem で証明書のパスを渡せば解決します。詳細は公式の Unable to connect to API を参照してください。

エラーが出ないのに遅い・出力が違う時

ここは少し厄介な章です。代表的な症状は次の 3 つ。

共通点は、ログを見てもエラーが何も出ていないことです。「自分の PC のせいでは」と買い替えに走った人もいるくらい、静かに時間を奪うタイプの失敗です。

外側の言語化として、JP コミュニティでは 2 つの見方が広まっています。1 つは Qiita の「拡張競合」で、skills / hooks / CLAUDE.md の指示が Policy・State・Hooks の 3 レイヤで衝突するという整理 (qiita.com)。もう 1 つは note の claude-mem の worker が 2 分おきに静かに死んでいた、という第三者プラグインの観測例 (note.com)。どちらも Anthropic の公式名称ではなく外部の言い方で、現象としての参照点として中立に紹介します。

romptn からの推奨はもっと素朴です。まず端末を閉じ、同じディレクトリで claude --resume を打ち直して会話ごと拾い直す。/doctor を 1 回通す。それでも違和感が残るなら、CLAUDE.md / Skills / hooks / 第三者プラグインを 一度すべて外した状態 を作り、1 つずつ戻して再現性が変わる瞬間を見つけます。最後に変えた拡張が原因の最有力候補です。第三者プラグインなら最新版を 1 つ前に戻すことも選択肢に入ります。

CLAUDE.md / Skills を整理する具体は別記事に分けてあるので、そちらと組み合わせて運用してください。

よくある質問

ここでは本文に乗らないが検索動線で頻出する 5 つの疑問に短く答えます。本文中で扱った論点と重ならない聞かれ方だけを残しました。

切り分けチェックリストのまとめ

最後に、ここまでの切り分け順を 5 ステップに圧縮します。次に詰まった時はこの順で上から辿ってください。

詰まった時にこの記事の冒頭へ戻れるよう、ブックマークしておくと次回の所要時間が短くなります。プランの選び方や上限の細部、CLAUDE.md の整理、Skills の作り方は、それぞれ別記事に分けてあるので、必要な所だけ読んでください。