Claude Codeが動かない・止まったときは、表示されたエラーメッセージで原因がほぼ決まる。本記事では、公式ドキュメントのトラブルシューティングとエラー一覧に載っているメッセージを、インストール・ログイン・利用上限・混雑・会話の長さの5つに分けて、意味と直し方をまとめた。メッセージは英語のまま載せているので、画面の表示と見比べてほしい。
2026年10月11日時点の情報：Claude Code公式ドキュメント（code.claude.com/docs）、Claude料金ページ（claude.com/pricing）、GitHubのリリース情報で確認した。全体像はClaude Code完全ガイドで解説している。
1. まず試す3つのこと
claude doctorを実行して診断するclaude --versionでバージョンを確認し、古ければ更新する（ネイティブ版は自動更新、npm版はnpm install -g @anthropic-ai/claude-code@latest）- ログイン関係なら、
/logout→ Claude Codeを終了 →claudeで入り直す
2. インストール・起動のエラー
| エラーメッセージ | 意味と対処 |
|---|---|
| command not found: claude（zsh） bash: claude: command not found |
インストール先がPATHに入っていない。公式手順でPATHを通し、ターミナルを開き直す |
| 'claude' is not recognized as an internal or external command（CMD） claude : The term 'claude' is not recognized as the name of a cmdlet（PowerShell） |
Windowsで同じくPATHの問題 |
| Native installation exists but … is not in your PATH | インストールはできているがPATHが通っていない |
| The token '&&' is not a valid statement separator | PowerShellでCMD用のインストールコマンドを実行している。PowerShell用（irm …）を使う |
| 'irm' is not recognized as an internal or external command | CMDでPowerShell用のコマンドを実行している |
| syntax error near unexpected token '<' curl: (22) The requested URL returned error: 403 |
インストール用スクリプトではなくWebページなどを受け取っている。ネットワークやプロキシを確認する |
| EACCES: permission denied | 権限エラー。npmで入れる場合も sudo は使わない |
| unable to get local issuer certificate SELF_SIGNED_CERT_IN_CHAIN TLS connect error |
会社のプロキシや証明書が原因。プロキシのCA証明書を設定し、HTTPS_PROXY・HTTP_PROXY を設定する |
| Claude Code on Windows requires either Git for Windows (for bash) or PowerShell | Git for WindowsかPowerShellが必要 |
| Claude Code does not support 32-bit Windows | 32ビット版Windowsは非対応 |
インストール手順そのものはClaude Codeのインストール方法で解説している。
3. ログイン・権限のエラー
| エラーメッセージ | 意味と対処 |
|---|---|
| OAuth error: Invalid code. Please make sure the full code was copied | ログイン用のコードが途中までしかコピーされていない。コードを全部コピーし直す |
| API Error: 403 Request not allowed | アカウントや組織の設定で許可されていない。/logout してから入り直す。会社のアカウントなら管理者に確認する |
| Claude Code access has not been granted for this account | Enterpriseなどで、そのアカウントにClaude Codeの利用が許可されていない。管理者に権限を付けてもらう |
| API Error: 400 … "This organization has been disabled" | 環境変数 ANTHROPIC_API_KEY の古いキーがログインより優先されている。unset ANTHROPIC_API_KEY で外す |
unset ANTHROPIC_API_KEY
4. 利用上限のエラー
| エラーメッセージ | 意味と対処 |
|---|---|
| You've hit your session limit · resets 3:45pm | 5時間ごとの使用量の上限に達した。表示された時刻まで待つ。週の上限やモデル別の上限でも同じ形の表示が出る |
| API Error: Usage credits required for 1M context · run /usage-credits … | 100万トークンの長い文脈を使うには使用量クレジットが必要 |
| API Error: Request rejected (429) · this may be a temporary capacity issue… | APIキー・クラウド経由で使っているときのレート制限。既定で最大10回自動で再試行される（回数は CLAUDE_CODE_MAX_RETRIES で変更可） |
| API Error: Server is temporarily limiting requests (not your usage limit) | 自分の上限ではなく、サーバー側が一時的に制限している |
プランごとの上限の考え方はClaude Codeの料金と使えるプランを参照してほしい。
5. 混雑・モデルのエラー
| エラーメッセージ | 意味と対処 |
|---|---|
| API Error: Repeated 529 Overloaded errors. The API is at capacity… | APIが混雑している。多くは一時的なので時間をおく |
| Opus is experiencing high load, please use /model to switch to Sonnet | Opusが混雑している。/model でSonnetに切り替える |
| Model … not found／Model … is not a recognized model id | 指定したモデル名が違うか、そのアカウントで使えない。/model の一覧から選び直す |
6. 会話が長すぎるときのエラー
| エラーメッセージ | 意味と対処 |
|---|---|
| Prompt is too long | 入力が長すぎる |
| Input is too long for requested model | モデルの上限を超えた |
| Context limit reached · /compact or /clear to continue | 会話がたまりすぎた。/compact で要約するか、/clear でリセットする |
長い作業では、区切りのよいところで /compact を使うと止まりにくくなる。/context で今どれだけ文脈を使っているかも確認できる。
Claude Codeの関連記事
Claude Codeを社内で使いこなしたい方へ
環境構築・セキュリティ設計から実践研修、社内への定着まで、Claude Codeの法人導入を支援しています。無料相談では、開発体制をうかがったうえで「導入PoC設計書」をお渡ししています。
よくある質問
Q. 「You've hit your session limit」と出たら？
A. 5時間ごとの使用量の上限に達した表示。表示されたリセット時刻まで待つか、有料プランなら使用量クレジットを買い足す。/usage で使用状況を確認できる。
Q. 「429」のエラーが続くときは？
A. APIキーやクラウド経由で使っているときのレート制限。Claude Codeは既定で最大10回まで自動で再試行する。続く場合は status.claude.com で障害が出ていないか確認する。
Q. 「Repeated 529 Overloaded errors」の意味は？
A. APIの処理能力が一時的にいっぱいになっている状態で、多くは一時的なもの。時間をおくか、/model で別のモデルに切り替える。
Q. 「This organization has been disabled」と出るのはなぜ？
A. 環境変数 ANTHROPIC_API_KEY に古いAPIキーが残っていて、ログインより優先されていることが多い。unset ANTHROPIC_API_KEY で外すと解消する。
Q. 会話が長くなって止まったら？
A. 「Context limit reached」などと出たら、/compact で会話を要約して文脈を圧縮するか、/clear でリセットする。
