Source: https://aiprimetech.io/ja/claude-code/errors/ [ホーム](/ja/) › [Claude Code](/ja/claude-code/) › エラー [概要](/ja/claude-code/)[インストール](/ja/claude-code/install/)[CLIリファレンス](/ja/claude-code/cli/)[料金と制限](/ja/claude-code/pricing/)[Agent SDK](/ja/claude-code/sdk/)[スキルとプラグイン](/ja/claude-code/skills/)[GitHub](/ja/claude-code/github/)[ウェブ、デスクトップ、IDE](/ja/claude-code/web-and-desktop/)[モデル](/ja/claude-code/models/)[エラー](/ja/claude-code/errors/)[オープンソース？](/ja/claude-code/open-source/)[チュートリアル](/ja/claude-code/tutorial/)[学生向け](/ja/claude-code/for-students/)[QA自動化](/ja/claude-code/qa-automation/)[Cursorとの比較](/ja/claude-code/vs-cursor/)[Codex・OpenCodeとの比較](/ja/claude-code/vs-codex/)[サブエージェント](/ja/claude-code/subagents/)[フック](/ja/claude-code/hooks/)[MCP](/ja/claude-code/mcp/)[エコシステム](/ja/claude-code/ecosystem/)[VS Code](/ja/claude-code/vscode/)[OpenRouter](/ja/claude-code/openrouter/)[レート制限](/ja/claude-code/rate-limits/)[中国語ガイド](/claude-code/zh/) 最終更新：2026年10月11日 # Claude Codeのエラーと修正方法 Claude Codeはメッセージ内にHTTPステータスを含めてAPIエラーを表示するため、その番号から状況の大部分がわかります。ここでは、エージェントのセッションで各エラーが何を意味するかと、実際に有効な解決方法を説明します。 ## TLDR - 500 / 529 — モデル側で障害が発生しているか、処理能力が飽和しています。待機時間を延ばしながら再試行するか、モデルを切り替えてください。設定を修正する必要はありません。 - 400 — 通常はモデルのコンテキスト上限を超えています。/compactまたは/clearを使うか、1Mコンテキスト対応のバリアントに切り替えてください。 - 429 — レート制限です。Claude Codeの並列ストリームは、まず同時実行数の上限に達します。 - 401 — エンドポイントに対応しないキーです。ゲートウェイURLにコンソールのキーを使っているか、その逆です。 - 利用上限 / 週間上限 — APIエラーではなく、サブスクリプションの利用期間に対する制限です。自動的にリセットされ、API経由の利用にはこのような期間制限はありません。 ## 各エラーの詳しいガイド - [APIエラー：500（内部サーバーエラー）](/ja/claude-code/errors/api-error-500/) — サービス停止、モデルごとの障害、0%でのコンテキスト圧縮。 - [過負荷 / APIエラー529](/ja/claude-code/errors/overloaded-529/) — 処理能力、再試行、サブエージェントによるリクエストの急増。 - [APIエラー400](/ja/claude-code/errors/api-error-400/) — プロンプトが長すぎる問題、ツール利用の同時実行、その他の拒否されたリクエスト。 - [OAuthエラー](/ja/claude-code/errors/oauth-error/) — 15000msのタイムアウト超過、ログイン時のステータスコード500。 - [プロセスがコード1で終了](/ja/claude-code/errors/process-exited-code-1/) — VS Code拡張機能とデスクトップアプリのクラッシュ。 - [レート制限に到達 / 429](/ja/claude-code/rate-limits/) — 3種類の制限と、その上限を引き上げる方法。 - [プロンプトが長すぎる / コンテキスト上限に到達](/ja/claude-code/errors/prompt-too-long/) — コンテキストウィンドウを埋める要因、誤検知、圧縮の失敗、claude.aiの長さ制限。 - [利用上限に到達](/ja/claude-code/errors/usage-limit-reached/) — セッション、週間、Opusの利用期間、「指定されたAPI利用上限」、「クレジット残高が不足しています」。 - [401 / 403の認証](/ja/claude-code/errors/auth-401-403/) — 無効な認証情報、無効なAPIキー、「ログインしていません」、host_not_allowed。 - [接続エラー](/ja/claude-code/errors/connection-lost/) — ECONNRESET、「APIの応答を待機中」、証明書、プロキシ、再試行用の変数。 - [フリーズ、停止、応答なし](/ja/claude-code/errors/claude-code-hangs/) — 停止している箇所、エスケープキー、既知のフリーズの不具合、メモリ。 - [claude.aiが動かない](/ja/claude-code/errors/claude-ai-not-working/) — 「問題が発生しました」、処理能力の制約、5時間の上限、ログインエラー。 ## APIエラー500（および529の過負荷） 500はアップストリーム側の障害です。529はAnthropicが「モデルの処理能力が上限に達した」ことを明示するコードです。どちらもプロンプトが原因ではありません。Claude Codeは自動で数回再試行します。再試行を断念した場合は、少し待ってから次のコマンドで再開してください： claude -c。モデルの階層を切り替えるコマンド： /model は、多くの場合すぐに効果があります。処理能力はモデルごとに割り当てられているためです。このゲートウェイでは、アップストリームのアカウントが飽和すると自動的に別のアカウントへ切り替わるため、単一のアカウントを利用する場合よりも529エラーが発生しにくくなっています。 ## APIエラー400 — 不正なリクエスト / コンテキスト超過 Claude Codeで400が発生する場合、ほぼ常に、会話と読み込んだファイルの合計がモデルのコンテキストウィンドウに収まらなくなったことを意味します。 /compact は履歴を要約します。 /clear は新しい状態から開始します。または、次のバリアントに切り替えてください： (1M) 対応のモデルです。その他の400エラーには、アップグレード後にパラメーターがサポートされなくなった場合（次を実行： claude update）、またはモデルが受け付けられない画像やファイルが含まれている場合があります。 ## APIエラー429 — レート制限 / レート超過 適用される制限は、毎分のリクエスト数、毎分のトークン数、同時リクエスト数の3種類です。エージェントを使うセッションでは、まず同時実行数の上限に達します。各サブエージェントは並列のストリーミングリクエストであり、完了まで枠を占有するためです。並列数を減らし、retry-afterで指定された時間が経過するまで待ってください。継続的に作業する場合は、ゲートウェイアカウントの同時実行数の上限引き上げを依頼してください。 ## OAuthエラー：15000msのタイムアウトを超過 /loginフローが15秒以内にAnthropicの認証サービスへ接続できませんでした。これはアカウントではなくネットワークの問題です。企業のプロキシ、コールバックを遮断するVPN、認証エンドポイントの応答が遅い地域などが原因として考えられます。一度再試行してください。問題が続く場合は、ネットワークに合わせてHTTPS_PROXYを設定するか、APIキーを使ってOAuthを完全に省略してください。ANTHROPIC_API_KEY（ゲートウェイの場合はANTHROPIC_BASE_URLも）を設定すると、Claude Codeはログインフローを一切開始しません。 ## OAuthエラー：リクエストがステータスコード500で失敗 ログイン中またはトークンの更新中に、認証サービスがサーバーエラーを返しました。ユーザー側に原因はありません。数分待ってから/loginを再実行してください。今すぐ作業する必要がある場合は、上記のAPIキーを使う方法でOAuthを回避できます。また、 claude setup-token をログインできるマシンで実行すると、長期間有効なトークンが生成され、ログインできないマシンへ移せます。 ## エラー：Claude Codeのプロセスがコード1で終了 これは、IDE拡張機能またはデスクトップアプリが、起動したCLIが起動時にクラッシュしたことを報告しています。本当のエラーは、その下の層にあります。ターミナルを開いて、次を実行してください： claude を直接実行すると、実際のメッセージが表示されます。原因はほぼ常に、Node.jsのバージョンが18未満、npmインストール後のPATHの破損、ネイティブインストールの破損、またはsettings.json内の無効なJSONです（hooksブロック内の余分なカンマは典型的な例です）。 claude doctor で最初の3つを確認できます。4つ目はJSONリンターで検出できます。残りの問題の大半は、ネイティブインストーラーで再インストールすると解決します。 ## 401 / 認証エラー invalid x-api-key または authentication_error は、キーがそのエンドポイントに対応していないことを意味します。ANTHROPIC_BASE_URLがゲートウェイを指している場合、ゲートウェイキーが必要です。Anthropicのコンソールキーは拒否され、その逆も同様です。 /status で、有効なエンドポイントとキーを確認できます。/loginとAPIキーを同時に使う場合は、キーが優先されます。トークン更新のループや、 Not logged in がログイン成功後に発生する問題、プロキシから返される403エラーについては、 [401 / 403のページ](/ja/claude-code/errors/auth-401-403/). ## 「正常なアップストリームがない」 これはAPIエラーではありません。サービスの前段にあるロードバランサーが、利用可能なバックエンドがないことを報告しています。公式エンドポイントではサービス停止を意味し、ゲートウェイではアップストリームのプール全体が停止しているか、リクエストが制限されていることを意味します。待ってから再試行してください。設定は変更しないでください。 ## Claude Codeがまったく動かない - 起動後、何も表示せずに終了する → 次を実行： claude /doctor。通常はNodeのバージョンまたはPATHの問題です。 - 起動時またはセッション途中でフリーズする → 参照： [フリーズと停止したセッション](/ja/claude-code/errors/claude-code-hangs/) と [接続エラー](/ja/claude-code/errors/connection-lost/). - command not found → インストールガイドを参照してください。 - ツールが権限エラーで失敗する → /permissions、または --allowedTools をスクリプト内で使用してください。 ## この問題への対処に疲れましたか？ 代わりにAI Prime Techのゲートウェイ経由でClaude Codeを実行してください。ゲートウェイ独自のアップストリームアカウントで同じClaudeモデルを利用でき、環境変数を2つ変更するだけで切り替えられます。新規アカウントには $5分の無料APIクレジット を、コード FIXIT が付与されます。カードは不要です。 ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [コードFIXITでアカウントを作成](/register?promo=FIXIT) ## よくある質問 Claude CodeがAPIエラー500を繰り返し返すのはなぜですか？ モデルのバックエンドで障害が発生しているか、過負荷になっています（529はそれを明示するコードです）。少し待ってから再試行するか、/modelでモデルの階層を切り替えるか、claude -cで再開してください。設定が原因ではありません。Claude Codeのエラー400（コンテキスト長）はどうすれば解消できますか？ /compactでセッションを要約するか、/clearでリセットするか、コンテキスト長が1Mのモデルバリアントに切り替えてください。Claude CodeでAPIキーが無効と表示されるのはなぜですか？ キーがANTHROPIC_BASE_URLのエンドポイントと一致していません。ゲートウェイのURLにはゲートウェイ用のキーが、AnthropicのURLにはコンソール用のキーが必要です。 ## ゲートウェイでClaude Codeを実行 同じモデルを環境変数の設定だけで利用できます。額面の7.69231倍のクレジット、または定額無制限プランを選べます。 新規アカウント：コードFIXITで$5分の無料APIクレジット。[APIキーを取得](/register?promo=FIXIT) [無制限プランを見る](/ja/plans/) AI Prime Techは独立したAPIゲートウェイであり、Anthropicとの提携関係はなく、同社の推奨や支援も受けていません。「Claude」と「Claude Code」はAnthropicの商標です。ここで説明するClaude Codeの機能は、執筆時点のAnthropicの公開ドキュメントに基づいており、頻繁に変更されます。このページの料金とモデル一覧は、このゲートウェイの現在の設定から取得しています。 ## その他のClaude Codeガイド [Claude Code：完全ガイド](/ja/claude-code/)[Claude Codeのインストール方法](/ja/claude-code/install/)[Claude Code CLIドキュメント：コマンドとフラグ](/ja/claude-code/cli/)[Claude Codeの料金と制限を解説](/ja/claude-code/pricing/)[Claude Code SDKからClaude Agent SDKへ](/ja/claude-code/sdk/)[Claude Codeのスキルとプラグイン](/ja/claude-code/skills/)[GitHubでのClaude Code：App、Action、@claude](/ja/claude-code/github/)[Claude Codeにウェブインターフェースはある？ウェブ、デスクトップ、IDEを解説](/ja/claude-code/web-and-desktop/)[Claude Codeが使用するモデルと変更方法](/ja/claude-code/models/)[Claude Codeはオープンソースですか？](/ja/claude-code/open-source/)[Claude Codeチュートリアル：初めての実践セッション](/ja/claude-code/tutorial/)[学生向けClaude：Claude Code、API、教育向け提供で実際に得られるもの](/ja/claude-code/for-students/)[QA自動化にClaude Codeを使う方法](/ja/claude-code/qa-automation/)[Claude CodeとCursorの比較：どちらをいつ使うか、そして両方を併用する方法](/ja/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode：ターミナルエージェントの比較](/ja/claude-code/vs-codex/)[Claude Codeのサブエージェント：仕組み、定義方法、エージェントチーム](/ja/claude-code/subagents/)[Claude Codeのフック：エージェントの動作を決定論的に制御する](/ja/claude-code/hooks/)[Claude CodeのMCP：サーバー接続、スコープ、リモートMCPと実例](/ja/claude-code/mcp/)[Claude Codeのエコシステム：ルーター、フレームワーク、プラグインと、それらをまとめたリスト](/ja/claude-code/ecosystem/)[VS Codeで使うClaude Code：拡張機能、ターミナル経由の利用、エラー](/ja/claude-code/vscode/)[Claude CodeでOpenRouterを使う方法（使わないほうがよい場合も）](/ja/claude-code/openrouter/)[Claudeのレート制限エラー：「API error: rate limit reached」の意味と解決方法](/ja/claude-code/rate-limits/)[Claude Codeの使い方：インストールから日常的な利用まで](/claude-code/zh/)