Claude Codeのエラー早見表
答え：エラーが出たら、まず表示された英語のメッセージを下の表で探してください。 多くは「待てば直る（混雑・利用上限）」か「コマンド1つで直る（/login・/compact・/clear）」ものです。
どれか分からないときは、Claude Codeの中で /doctor と打つと、インストール・設定・会話の使用量を自動で点検してくれます。起動すらできないときは、ターミナルで claude doctor を実行します（公式の案内）。
📌 本記事は2026年10月時点の公式ドキュメント（Error reference・Troubleshooting）に基づいています。
インストール・起動できない
| メッセージ | ひとことで | 詳しい記事 |
|---|---|---|
command not found: claude／'claude' is not recognized |
PATHが通っていない | command not foundの直し方 |
'irm' is not recognized／syntax error near unexpected token '<'／403／EACCES |
インストールコマンドや通信の問題 | インストールできない時の対処法 |
claude と打つとデスクトップアプリが開く（Windows） |
古いClaude Desktopが先に登録されている | Claude Desktopを最新版に更新 |
ログイン・認証
| メッセージ | ひとことで | まずやること |
|---|---|---|
Not logged in · Please run /login |
ログインしていない | /login |
Login expired · Please run /login／OAuth token has expired |
ログインの期限切れ | /login でログインし直す |
Invalid API key |
APIキーが間違っている・古い | 設定したAPIキーを確認 |
Your account does not have access to Claude |
アカウントに利用権がない | プランやログインしたアカウントを確認 |
詳しくは「認証エラーを解決する方法」をどうぞ。
利用上限・混雑
| メッセージ | ひとことで | まずやること |
|---|---|---|
You've hit your session limit／weekly limit |
自分のプランの利用枠を使い切った | 表示のリセット時刻まで待つ |
You've hit your Opus limit／Sonnet limit |
そのモデルだけの枠切れ | /model で別のモデルへ |
API Error: Repeated 529 Overloaded errors |
Anthropic側の混雑（自分の枠は減らない） | 数分待つ・別のモデルへ |
Server is temporarily limiting requests |
Anthropic側の一時的な制限 | 少し待って再送 |
API Error: 500 Internal server error |
Anthropic側の一時的な不具合 | 少し待って再送。status.claude.com を確認 |
詳しくは「利用上限・429・529エラーの対処法」をどうぞ。
会話が長すぎる
| メッセージ | ひとことで | まずやること |
|---|---|---|
Context limit reached · /compact or /clear to continue |
会話がいっぱい | /compact か /clear |
Prompt is too long |
同上 | 同上 |
Autocompact is thrashing |
大きなファイルですぐ満杯に戻る | ファイルを小分けに読ませる |
詳しくは「Context limit reachedの直し方」をどうぞ。
ネットワーク
| メッセージ | ひとことで | まずやること |
|---|---|---|
Unable to connect to API |
Anthropicのサーバーにつながらない | ネット接続・会社のプロキシを確認 |
Request timed out |
返事が時間内に来なかった | もう一度送る |
SSL certificate verification failed／unable to get local issuer certificate |
会社のネットワークの証明書の問題 | IT担当に相談 |
詳しくは「ネットワークエラー対処法」をどうぞ。
動作がおかしい・その他
| 症状 | 詳しい記事 |
|---|---|
ファイルの操作で permission denied |
permission deniedが出た時の解決法 |
| 返事が遅い・重い・固まる | 遅い・重い原因と高速化 |
| 「court」という謎の単語が出て止まる | 「court」エラーとは？ |
| アップデートがうまくいかない | アップデート方法 |
💡 固まったときは Ctrl+C で止められます。ターミナルを閉じても、同じフォルダで
claude --resumeと打てば会話を再開できます（公式の案内）。
それでも解決しないとき
/doctorで自動点検する- status.claude.com で障害が起きていないか確認する
- 不具合だと思ったら、Claude Codeの中で
/feedbackと打つと、Anthropicに直接報告できます - 料金・アカウントの問題は、claude.aiにログインして左下の自分の名前（イニシャル）→「Get help」からサポートに問い合わせます
よくある質問
Q1. エラーの英語が読めません。 A. エラーメッセージをそのままコピーして、Claude（チャット）に「このエラーの意味と直し方を教えて」と貼り付けるのが早いです。Claude Codeが動いているなら、Claude Code自身に聞いても大丈夫です。
Q2. エラーが出ると料金が余分にかかりますか？ A. 529（混雑）は利用枠にカウントされないと公式に明記されています。その他のエラーも、エラーそのものに追加料金はかかりません。
まとめ
- エラーが出たら、まずメッセージを上の表で探す
- 迷ったら
/doctor - 529・500・Server is temporarily limiting はAnthropic側の都合。待てば直る
- session limit は自分の枠切れ。リセットまで待つ
- Context limit は
/compactか/clear
