Claude Code のエラー: よくある5つの問題と素早い解決方法（2026年）

Claude Code は更新が速く、コマンド名や挙動が変わることがあります。自分で確認すべき点はその都度お伝えします。確実な情報が必要なときはClaude Code 公式ドキュメントも参照してください。

エラー早見表（症状 → 解決）

ここがメインのリファレンスです。表示されているメッセージに合う行を探し、右端の列に従ってください。原因を理解したい場合は詳細セクションへ進みましょう。

対処の前に: あなたの問題か、Anthropic の問題か？

初心者にありがちな失敗は、実際はサーバー側の問題なのに、いきなり再インストールや設定の書き換えに飛びつくことです。対処の前に、30秒かけて次のように切り分けましょう:

• あなた側（環境・設定）: command not found、不正な PATH、壊れた認証、権限ブロック、コンテキスト満杯など。見分け方: 毎回同じメッセージが一貫して繰り返されます。
• Anthropic 側（自分では直せない）: overloaded というメッセージ、ネットワークは正常なのにモデルが応答しない、何も変えていないのに突然出るエラーなど。見分け方: 突然起こり、通常は数分で自然に解消します。

素早く切り分ける3つのコマンド: claude --version（正しくインストールできているか）→ /status（今どのルートで、クォータは残っているか）→ Anthropic 公式ステータスページを開く（システム障害はないか）。3つとも問題ないのにまだ詰まっているなら、ローカル環境を直す番です。

エラー1 - インストール済みなのに claude が動かない（command not found ／ PATH）

症状。 インストールは終わったのに、claude と入力すると次のいずれかのメッセージが出ます:

# macOS / Linux (zsh, bash)
zsh: command not found: claude

# Windows (PowerShell / CMD)
claude : The term 'claude' is not recognized as the name of a cmdlet...

厄介なのは、npm はインストール成功と表示するのに、ターミナルはコマンドを見つけられない点です。

原因。 パッケージは npm の グローバル bin フォルダに置かれますが、そのフォルダが PATH 環境変数に含まれていないため、シェルは claude バイナリの場所を認識できません。Windows では、あるウィンドウで設定した環境変数は、新しいウィンドウを開いた瞬間に消えていることがよくあります。

解決。 まず、npm のグローバル bin フォルダを見つけます:

npm config get prefix
# e.g. returns: /Users/you/.npm-global (macOS)
# or: C:\Users\you\AppData\Roaming\npm (Windows)

コマンドは PREFIX/bin（macOS/Linux）または PREFIX そのもの（Windows）にあります。これを PATH に追加します:

# macOS / Linux - append to the end of ~/.zshrc (or ~/.bashrc)
export PATH="$(npm config get prefix)/bin:$PATH"
# then reload
source ~/.zshrc

# verify
claude --version

Windows では、PowerShell プロファイルを開いて同等の行を追加するか、npm のパスをシステムの PATH 変数（設定 → 環境変数）に追加してからターミナルを開き直します。ただ、私の実践的なおすすめはこうです: Windows では Claude Code を WSL2 の中で動かす こと。ネイティブの PowerShell/CMD ではなく、こうすれば Linux 環境が、Windows 特有の面倒な PATH・権限の問題をほぼすべて回避してくれます。

PATH を直しても認識されないなら、そもそも最初のインストールがきれいに済んでいなかった可能性が高いです。Claude Code を正しくインストールする方法 をもう一度見て、まっさらな状態からやり直しましょう。

エラー2 - ログインできない・認証エラー（API キー vs サブスクリプション）

症状。 ブラウザでログインが固まる、unauthorized と表示される、あるいは Pro/Max プランでサインイン済みのつもりなのに Claude Code が API キーを要求し続けます。

原因。 ここでの原因は主に2つです。1つは 壊れた認証情報のキャッシュ、つまり古いトークンが残ってしまうケース。2つ目、そしてより多いのは 2つの認証ルートの取り違え です: サブスクリプション（アカウント経由の Pro/Max プラン）でサインインするのと、ANTHROPIC_API_KEY（トークン課金）を使うのはまったくの別物です。もし ANTHROPIC_API_KEY 環境変数を設定していると、Claude Code は API キーのルートを優先し、課金しているプランを無視することがあります。

解決。 まず認証情報をリセットします:

claude logout
claude login # sign in again on the route you want (subscription)

次に、API キーの変数が「割り込んで」いないか確認します:

# macOS / Linux
echo $ANTHROPIC_API_KEY

# Windows (PowerShell)
echo $env:ANTHROPIC_API_KEY

Pro/Max プランを使いたいのにこの変数に値が入っている場合は、シェルのプロファイル（export ANTHROPIC_API_KEY=... の行、.zshrc など、Windows なら環境変数）から削除し、ターミナルを開き直します。最後に /status を Claude Code 内で実行し、正しいルートになっているか確認します。逆に、あえて API キーを使いたい場合は、そのキーが有効で残高があることを確認してください。

エラー3 - 「Rate limit reached」／ 429 エラー

症状。 作業を進めている途中で、Rate limit reached というメッセージや 429 コードが出て、タスクの途中で止まります。ほとんど使っていないのに出ることもあります。

原因。 落とし穴は、まったく別の2つのシステムが同じ表示を出す ことです。しかも対処法は正反対です:

解決。 まず /status でルートを特定します。次に取り残されたプロセスを探します。Claude Code はウィンドウを閉じたあともバックグラウンドにプロセスを残すことがあり、それがクォータを消費し続けます:

# macOS / Linux - list live claude processes
ps aux | grep claude
# see a stray PID? kill it: kill <PID>

# Windows: open Task Manager, find lingering node/claude processes and end them

ルートがサブスクリプションプランで本当に使い切ったなら、期間のリセットを待つか、使用量を抑えるために一時的に軽量なモデルへ切り替える以外に裏技はありません。API キーなら、上限の引き上げはアカウントのティア次第です。特定の 429 がどのルールから来たのかを正確に知りたい場合は、anthropics/claude-code リポジトリの issue を参照してください。

エラー4 - Claude Code がタスク中にハング・停止する（コンテキスト満杯）

症状。 セッションが固まる、返信が極端に遅くなる、モデルが最初に言ったことを「忘れ」始める、あるいは編集と再編集を延々と繰り返して終わらないループに陥ります。

原因。 たいていは コンテキストウィンドウの満杯 が原因です: 会話が非常に長くなった、巨大なファイルを貼り付けた、または出力が膨れ上がるほど大きなタスクを1つ渡した、などです。これは サーバーエラーではありません。ですから、Anthropic 側の overloaded メッセージと混同しないでください。

解決。 軽いものから重いものへ:

• /compact - 会話を圧縮し、要点を残しつつ空きを作ります。今の作業を続けたいときに使います。
• /clear - コンテキストを消してまっさらから始めます。無関係なタスクに移るときに使います。
• タスクを順番に分割する。 「モジュール全体をリファクタ」ではなく、1ファイルずつ渡しましょう。ここでは予防が治療に勝ります。
• 巨大なファイルを丸ごとチャットに貼り付けるのは避け、すべてをコンテキストに詰め込む代わりに、必要なときは Claude Code 自身にファイルを読ませましょう。
• 完全に固まった場合は、セッションを終了（Ctrl+C）して開き直します。今のコンテキストは失いますが、詰まった状態を確実に解消できます。

ハングを避けるためのコンテキスト管理をさらに深く学びたいなら、Claude Code を始めるための10ステップ の体系的で初心者にやさしいワークフローが、最初からきれいに作業を引き継ぐのに役立ちます。

エラー5 - 権限でブロックされる（コマンドを実行できない）

症状。 Claude Code がコマンドのたびに確認を求める、あるいはコマンド実行・ファイル編集をきっぱり拒否して、作業の流れを止めます。

原因。 これはたいてい「バグ」ではなく、安全機能 です: 権限モードが、アクセスを許可するまでリスクのある操作をブロックしているのです。デフォルトでは、Claude Code はファイルの変更・削除やシェルの実行につながるコマンドに慎重です。

解決。 管理された形でアクセスを許可します:

• Claude Code が尋ねてきたら、セッション単位 のアクセスを、信頼できる操作に対して選びます。毎回承認をクリックする必要はありません。
• よく使うコマンドを 許可リスト に追加すれば、尋ねられなくなります。
• 各種の権限モードを理解して、やっていることに合ったレベルを選べるようにしましょう。

正直な注意: 「速くしたい」だけの理由で、すべての確認をスキップするモードをオンにしないでください。これは Claude Code に何でも確認なしで実行させます。便利ですが、大事なマシンやリポジトリで、モデルが予想外のことをしたときには本当のリスクになります。使うのは隔離された環境（サンドボックス／コンテナ）だけにしましょう。

安全な権限設定にはいくつもの層があるので、専用の詳しい解説として Claude Code の権限と権限モード にまとめました。一度設定すれば長く頼れる内容です。

まだ小さなエラーが出る？ チェックリストと再インストールの目安

上の5グループをすべて試してもなお、変な小さいエラーが出るなら、再インストールを考える前にこのチェックリストを一通り実行しましょう:

• 最新ビルドに更新する: npm i -g @anthropic-ai/claude-code - 多くのバグは後のリリースで直っています。
• Node が LTS バージョンかを確認する（不可解なエラーは、Node が古すぎ・新しすぎることが原因の場合があります）。
• 1プロジェクトにつき ターミナル1つ で Claude Code を動かし、競合や取り残されたプロセスを避ける。
• 認証情報のキャッシュを claude logout でクリアし、ログインし直す。
• クリーンな再インストール: 完全にアンインストールしてから、Claude Code インストールガイド に従って入れ直す。
• ツールが実際どう動くのか自信がない？ もう一度 Claude Code とは何か を読んで、正しいメンタルモデルを持ちましょう。多くの「エラー」は、実は動作の仕方の誤解です。

Anthropic サポートに連絡すべきとき: クリーンなマシンでも消えないエラー、overloaded メッセージが何時間も続く、または自分では調整できない請求・アカウントの問題。

既製キット（AgentKit）でエラーを減らし、パワーを増す

小さなエラーの多くは、マシンごとに環境が違うことから生まれます。ゆがんだ PATH、散らばった設定、標準スキルやステータスラインの欠如などです。手動設定と格闘するのをやめたいなら、Claude Code 向け AgentKit キット には、作業環境を標準化するのに役立つ、すぐ使える設定・スキル・さらにはステータスラインビルダーまで付いています。面倒な設定エラーの多くを未然に防ぎ、セッションをより安定させます。上記の CLI エラーを代わりに「直して」くれるわけではありませんが、そもそも起きる可能性を減らしてくれます。試したい方は、AgentKit を試す（リンク経由で20%オフ） で、この既製セットアップが自分の働き方に合うか確かめてみてください。

よくある質問（FAQ）

なぜ claude と入力すると command not found と出るのですか？

コマンドを保持するフォルダ（npm のグローバル bin）が PATH 環境変数に含まれておらず、シェルがバイナリを見つけられないからです。npm config get prefix を実行し、対応する /bin フォルダを PATH に追加して、ターミナルを開き直してください。

Claude Code は Windows / PowerShell で動きますか？

動きます。ただ、ネイティブの PowerShell/CMD より WSL2 のほうが体験はずっとスムーズです。WSL2 は Windows 特有の PATH・権限の問題のほとんどを回避します。

「Rate limit reached」はどのくらい続きますか？

発生元によります。Pro/Max プランのクォータなら、期間がリセットされるのを待つ必要があります。API キーの RPM/TPM 制限なら、同時リクエストを減らせばすぐに解消します。/status を実行して、どちらに当たったのか確認しましょう。

Claude Code がハングしたらどうすればいい？

たいていはコンテキスト満杯です。/compact で会話を圧縮するか、/clear でリセットし、タスクを小さく分割し、巨大なファイルの貼り付けを避けます。完全に固まったら、セッションを終了（Ctrl+C）して開き直してください。

ログインエラーは API キーとプランのどちらが原因？

まず ANTHROPIC_API_KEY 変数を確認します: 値が入っていれば、Claude Code は支払っているプランではなく API キーのルートを使うことがあります。Pro/Max プランを使うには、その変数を削除してから claude logout と claude login をもう一度実行してください。

Claude Code を再インストールするには？

古いパッケージをアンインストールし、npm i -g @anthropic-ai/claude-code をもう一度実行し、Node が LTS バージョンであることを確認し、npm のグローバル bin フォルダが PATH に入っていることを確認します。そのうえで claude login を最初から実行してください。

まとめ + 次のステップ

結論: 手当たり次第に直さないこと。まず切り分け（あなたの問題か Anthropic の問題か）、それから該当する症状グループで対処します: 起動しない／PATH、認証、レート制限、ハング／コンテキスト、権限。3つのコマンド claude --version、/status、/compact で、日々のたいていの場面はカバーできます。インストール直後にエラーが出ているなら、Claude Code インストールガイド に戻りましょう。また、始めたばかりで根本からエラーを避けたいなら、初心者向け10ステップ に従ってください。環境を標準化して小さなエラーを長期的に減らすには、Claude Code 向け AgentKit レビュー をご覧ください。