エラーリファレンス

Claude Code のランタイムエラーメッセージを検索し、各エラーの意味と修正方法を確認できます。

このページでは、Claude Code が表示するランタイムエラーと各エラーからの復旧方法、および応答がエラーなしで異常に見える場合に確認すべき内容を一覧表示しています。セットアップ中の command not found や TLS エラーなどのインストールエラーについては、トラブルシューティング インストールとログインを参照してください。

これらのエラーと復旧コマンドは、CLI、デスクトップアプリ、およびウェブ上の Claude Code全体に適用されます。これら 3 つはすべて同じ Claude Code CLI をラップしているためです。サーフェス固有の問題については、そのサーフェスのページのトラブルシューティングセクションを参照してください。

エラーを検索する

ターミナルに表示されるメッセージを以下のセクションと照合してください。

自動リトライ

Claude Code は、エラーを表示する前に一時的な障害をリトライします。サーバーエラー、オーバーロードレスポンス、リクエストタイムアウト、一時的な 429 スロットル、および接続の切断はすべて、指数バックオフで最大 10 回リトライされます。リトライ中、スピナーは Retrying in Ns · attempt x/y カウントダウンを表示します。

{/* min-version: 2.1.185 */}リクエストがまだ保留中の状態で、レスポンスストリームで 20 秒間データが到着しない場合、スピナーは Waiting for API response · will retry in … · check your network を表示します。これはリトライが開始される前です。リクエストはまだ失敗していません。カウントダウンは Claude Code が停止した接続を中止してリトライする時点まで実行されるため、データが再開されるか、リトライが成功するとバナーは自動的にクリアされます。v2.1.185 以降、閾値は 20 秒です。それより前のバージョンでは、異なる表現でバナーが 10 秒後に表示されます。すべての試行で再度表示される場合は、ネットワークの問題として扱ってください。

このページのエラーの 1 つが表示されている場合、これらのリトライはすでに使い果たされています。これらの環境変数で動作をチューニングできます。

サーバーエラー

これらのエラーは、アカウントまたはリクエストではなく、推論プロバイダーから発生します。Anthropic API では Anthropic インフラストラクチャを意味します。Bedrock、Vertex AI、Foundry、またはカスタムゲートウェイでは、そのプロバイダーのインフラストラクチャを意味します。

API Error: 500 Internal server error

Claude Code は、5xx レスポンスに対してステータスコードと API のエラーメッセージを表示します。以下の例は Anthropic API での 500 レスポンスを示しています：

API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

末尾の文は、サービスヘルスを確認する場所を示し、プロバイダーによって異なります。Bedrock、Vertex AI、および Foundry の設定は、そのプロバイダーのサービスステータスを示します。カスタム ANTHROPIC_BASE_URL はゲートウェイホストを示します。

これは API 内の予期しない障害を示しています。プロンプト、設定、またはアカウントが原因ではありません。

対応方法：

• status.claude.com またはメッセージに示されているプロバイダーのステータスページで、アクティブなインシデントを確認してください
• 1 分待ってからメッセージを再度送信してください。元のメッセージはまだ会話に残っているため、長いプロンプトの場合は全体を貼り付ける代わりに try again と入力できます。
• エラーが投稿されたインシデントなしで続く場合は、/feedback を実行して、Anthropic がリクエスト詳細で調査できるようにしてください。環境で /feedback が利用できない場合は、エラーを報告する を参照してください。

API Error: Repeated 529 Overloaded errors

API は、すべてのユーザー全体で一時的に容量に達しています。Claude Code は、このメッセージを表示する前に既に数回リトライしています：

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

末尾の文は、500 エラーと同じ方法でプロバイダーによって異なります。529 は使用制限ではなく、クォータに対してカウントされません。

対応方法：

• status.claude.com またはメッセージに示されているプロバイダーのステータスページで、容量に関する通知を確認してください
• 数分後に再度試してください
• /model を実行して別のモデルに切り替えて、容量がモデルごとに追跡されるため、作業を続けてください。Claude Code は、1 つのモデルが特に高い負荷を受けている場合、たとえば Opus is experiencing high load, please use /model to switch to Sonnet のようにこれを行うようにプロンプトを表示します。

Request timed out

API は接続期限前に応答しませんでした。

Request timed out

これは、高負荷期間中または非常に大きなレスポンスが生成されている場合に発生する可能性があります。デフォルトのリクエストタイムアウトは 10 分です。

対応方法：

• リクエストを再試行してください
• 長時間実行されるタスクの場合は、作業をより小さいプロンプトに分割してください
• 遅いネットワークまたはプロキシが原因の場合は、自動リトライ で説明されているように API_TIMEOUT_MS を上げてください
• タイムアウトが頻繁で、ネットワークが正常な場合は、以下のネットワークと接続エラー を参照してください

Auto mode cannot determine the safety of an action

auto mode がアクションを分類するために使用するモデルが決定を生成できなかったため、auto mode はアクションを自動的に承認しませんでした。表示されるメッセージは、分類器が失敗した理由によって異なります。

読み取り、検索、および作業ディレクトリ内の編集は分類器をスキップするため、これらすべてのケースで機能し続けます。

分類器モデルがオーバーロードされている場合：

<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.

対応方法：

• 数秒後に再試行してください。Claude は同じメッセージを見て、通常は自動的に再試行します
• リトライが失敗し続ける場合は、読み取り専用タスクを続行し、後でブロックされたアクションに戻ってください
• これは一時的であり、auto mode 適格性 とは無関係です。設定を変更する必要はありません

分類器が解析不可能なレスポンスを返した場合：

Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details

対応方法：

• アクションを再試行してください。これは通常、次の試行で成功します
• claude --debug を実行してアクションを繰り返し、デバッグログで基になる分類器レスポンスを確認してください

会話が分類器のコンテキストウィンドウより大きくなった場合：

Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

インタラクティブセッションでは、auto mode はそのアクションに対して通常の権限プロンプトにフォールバックするため、手動で承認または拒否できます。非インタラクティブモード では、トランスクリプトのみが増加し、リトライが成功できないため、実行が中止されます。

対応方法：

• 表示されるプロンプトでアクションを承認または拒否してください
• /compact を実行して会話サイズを削減し、後続のアクションが分類器ウィンドウ内に収まるようにしてください

使用制限

これらのエラーは、アカウントまたはプランに関連するクォータに達したことを意味します。これらは、すべてに影響するサーバーエラーとは異なります。

セッション制限に達しました

サブスクリプションプランには、ローリング使用許容量が含まれています。使い果たされると、次のいずれかのメッセージが表示されます。

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm

Claude Code は、メッセージに表示されているリセット時刻までさらなるリクエストをブロックします。

対応方法：

• エラーに表示されているリセット時刻を待ってください
• /usage を実行して、プランの制限とリセット時刻を確認してください
• /usage-credits を実行して、Pro および Max で追加使用量を購入するか、Team および Enterprise で管理者にリクエストしてください。有料プランの使用量クレジットを参照して、これがどのように請求されるかを確認してください。
• プランをアップグレードしてより高いベース制限を取得するには、claude.com/pricingを参照してください

制限に達する前に残りの許容量を監視するには、rate_limits フィールドをカスタムステータスラインに追加するか、デスクトップアプリでモデルピッカーの横にある使用量リングをクリックしてください。

1M コンテキストに使用量クレジットが必要です

選択されたモデルは 1M トークンの拡張コンテキストウィンドウを使用しており、お客様のプランではこれを使用量クレジットを通じてのみ含めています。

API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

これはクォータ枯渇ではなく、エンタイトルメントチェックです。セッションおよび週間許容量に容量が残っている場合でも発火します。拡張コンテキストを参照して、どのプランが 1M コンテキストを直接含めており、どのプランが使用量クレジットを必要とするかを確認してください。

{/* min-version: 2.1.172 */}このエラーがコンテキストが 200K トークンを超えて成長したために会話の途中で表示される場合、Claude Code は自動的に会話を標準コンテキスト制限の下に圧縮し、その後セッションをその制限に保つため、アクションは不要です。v2.1.172 より前のバージョンでは、エラーは /compact を含むその後のすべてのリクエストで繰り返されました。これらのバージョンで復旧するには /clear を実行してください。以下の手順は、明示的に [1m] モデルを選択した場合に適用されます。

対応方法：

• /model を実行して、[1m] サフィックスのないバリアントを選択して、標準コンテキストウィンドウにフォールバックしてください
• /usage-credits を実行して、Pro および Max で 1M バリアントのメーター制課金をオンにするか、Team および Enterprise で管理者にリクエストしてください
• /model の後もエラーが続く場合は、1M モデル ID が他の場所に設定されている可能性があります。優先順位順に確認する設定場所については、選択されたモデルに問題がありますを参照してください。
• モデルピッカーから 1M バリアントを完全に削除するには、CLAUDE_CODE_DISABLE_1M_CONTEXT=1を設定してください

サーバーが一時的にリクエストを制限しています

API は、プランクォータとは無関係の短期的なスロットルを適用しました。

API Error: Server is temporarily limiting requests (not your usage limit)

これは、表示される前に自動的にリトライされます。

対応方法：

• 少し待ってから再度試してください
• 続く場合は status.claude.comを確認してください

リクエストが拒否されました（429）

API キー、Amazon Bedrock プロジェクト、または Google Vertex AI プロジェクト用に設定されたレート制限に達しました。

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

末尾の文は、サービスの健全性を確認する場所を示し、プロバイダーによって異なります。Bedrock および Vertex AI 設定では、Anthropic ステータスページの代わりにそのプロバイダーのサービスステータスを示します。カスタム ANTHROPIC_BASE_URL はゲートウェイホストを示します。

対応方法：

• /status を実行して、アクティブな認証情報が予想されるものであることを確認してください。環境内の迷走した ANTHROPIC_API_KEY は、サブスクリプションではなく低層キーを通じてリクエストをルーティングできます。
• プロバイダーコンソールでアクティブな制限を確認し、必要に応じてより高い層をリクエストしてください
• Anthropic API キーについては、レート制限リファレンスを参照して、層がどのように機能し、ワークスペースごとのキャップを設定する方法を確認してください
• 同時実行性を削減します。CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCYを低くするか、多くの並列サブエージェントの実行を避けるか、高ボリュームのスクリプト実行用に /model で小さいモデルに切り替えてください

クレジット残高が不足しています

Console 組織は、プリペイドクレジットを使い果たしました。

Credit balance is too low

対応方法：

• platform.claude.com/settings/billingでクレジットを追加し、そこで自動リロードを有効にして、残高がゼロに達する前に補充されるようにすることを検討してください
• Pro、Max、Team、または Enterprise プランがある場合は、/login でサブスクリプション認証に切り替えてください
• Console でワークスペースごとの支出キャップを設定して、単一のプロジェクトが組織の残高を枯渇させるのを防いでください。コストを効果的に管理するを参照してください。

認証エラー

これらのエラーは、Claude Code が API に対して身元を証明できないことを意味します。いつでも /status を実行して、現在アクティブな認証情報を確認してください。

Not logged in

このセッションで有効な認証情報は利用できません。

Not logged in · Please run /login

対応方法：

• /login を実行して、Claude サブスクリプションまたは Console アカウントで認証してください
• 環境変数で認証されることを期待していた場合は、ANTHROPIC_API_KEY が設定され、claude を起動したシェルでエクスポートされていることを確認してください
• インタラクティブログインが不可能な CI または自動化の場合は、起動時にキーをフェッチするapiKeyHelperスクリプトを設定してください
• 認証の優先順位を参照して、複数の認証情報が存在する場合にどの認証情報が優先されるかを理解してください

ログインを繰り返しプロンプトされている場合は、ログインしていないまたはトークンの有効期限が切れているを参照して、システムクロックと macOS キーチェーンの修正を確認してください。

Could not resolve authentication method

セッションが認証情報なしで API クライアントに到達しました。これはバックグラウンドセッション、クラウドセッション、および最初のリクエストの前にインタラクティブログインチェックが実行されない Agent SDK コンテキストに表示されます。

Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

{/* min-version: 2.1.174 */}v2.1.174 より前では、バックグラウンドまたはクラウドセッションがアイドル状態の事前初期化ワーカーに割り当てられている場合、有効な認証情報が設定されていても、このように失敗する可能性がありました。アップグレードして復旧してください。現在のバージョンでは、エラーはワーカープロセスで認証情報が利用できなかったことを意味します。

対応方法：

• バックグラウンドまたはクラウドセッションでこれが表示され、認証情報が既に設定されている場合は、v2.1.174 以降にアップグレードしてください
• ANTHROPIC_API_KEY、CLAUDE_CODE_OAUTH_TOKEN、またはクラウドプロバイダーの認証情報が、インタラクティブシェルだけでなく、ワーカーを起動する環境で設定されていることを確認してください
• Agent SDK については、認証セットアップを参照してください
• 同じ環境のインタラクティブセッションで /status を実行して、どの認証情報ソースが解決されるかを確認してください

Invalid API key

ANTHROPIC_API_KEY 環境変数または apiKeyHelper スクリプトが、API が拒否したキーを返しました。

Invalid API key · Fix external API key

対応方法：

• タイプミスを確認し、キーが Console で取り消されていないことを確認してください
• 同じシェルで env | grep ANTHROPIC を実行してください。direnv、dotenv シェルプラグイン、IDE ターミナルなどのツールは、明示的に設定せずにプロジェクト内の .env ファイルから古いキーをロードできます。
• ANTHROPIC_API_KEY をアンセットして /login を実行し、代わりにサブスクリプション認証を使用してください
• キーがapiKeyHelperスクリプトから来ている場合は、スクリプトを直接実行して、stdout に有効なキーを出力することを確認してください
• /status を実行して、Claude Code が実際に使用している認証情報ソースを確認してください

This organization has been disabled

無効な Console 組織からの古い ANTHROPIC_API_KEY がサブスクリプションログインをオーバーライドしています。

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials
API Error: 400 ... This organization has been disabled.

環境変数は /login より優先されるため、シェルプロファイルでエクスポートされたキーまたは .env ファイルからロードされたキーは、機能する Pro または Max サブスクリプションがある場合でも使用されます。非インタラクティブモード（-p）では、キーが存在する場合は常に使用されます。

対応方法：

• 現在のシェルで ANTHROPIC_API_KEY をアンセットし、シェルプロファイルから削除してから、claude を再起動してください
• その後 /status を実行して、アクティブな認証情報がサブスクリプションであることを確認してください
• 環境変数が設定されておらず、エラーが続く場合、無効な組織は /login に関連付けられているものです。サポートに連絡するか、別のアカウントでサインインしてください。

Your organization has disabled API key authentication

Console 組織の管理者が API キー認証をオフにしているため、API が Claude Code が送信しているキーを拒否しています。· の後の復旧ヒントは、キーがどこから来たかによって異なります。

Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

環境変数と apiKeyHelper は /login より優先されるため、どちらかがキーを供給している間は /login を実行するだけでは役に立ちません。認証の優先順位を参照してください。

対応方法：

• メッセージが ANTHROPIC_API_KEY に言及している場合は、現在のシェルでアンセットし、シェルプロファイルまたは .env ファイルから削除してから、claude を再起動してください
• メッセージが apiKeyHelper に言及している場合は、settings.json からapiKeyHelper設定を削除してください
• /login を実行して、claude.ai アカウントでサインインしてください
• その後 /status を実行して、アクティブな認証情報が API キーではなくサブスクリプションであることを確認してください
• 自動化に API キー認証が必要な場合は、組織の管理者に Console で再度有効にするよう依頼してください

Your organization has disabled Claude subscription access

Claude 組織がサブスクリプションログインで Claude Code にサインインすることを許可していません。同じアカウントで /login を再度実行すると、同じエラーが返されます。

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

これはサーバー側の組織設定であるため、ローカル設定、環境変数、または CLI フラグからオーバーライドすることはできません。Agent SDK および -p 非インタラクティブモードは、これを oauth_org_not_allowed エラーコードとして表示します。

対応方法：

• 管理者に組織の Claude Code アクセスを有効にするよう依頼してください
• サブスクリプションの代わりに Console API キーで認証してください。セットアップについては、Claude Console 認証を参照してください。
• 管理者であり、アクセスを有効にするオプションが表示されない場合は、Anthropic サポートに連絡してください

Routines are disabled by your organization's policy

チームまたはエンタープライズ組織の Owner が、組織レベルでルーチンをオフにしています。エラーは、/schedule および claude.ai/code の Routines UI を含め、ルーチンを作成または実行しようとするときに表示されます。

Routines are disabled by your organization's policy.

これはサーバー側の設定であるため、ローカル設定、環境変数、または CLI フラグからオーバーライドすることはできません。

対応方法：

• 組織の Owner に claude.ai/admin-settings/claude-code で Routines トグルを有効にするよう依頼してください
• 組織レベルのルーチンを必要としない 1 回限りのスケジュール済み作業については、スケジュール済みタスクを参照してください

OAuth token revoked or expired

保存されたログインは有効ではなくなりました。取り消されたトークンは、どこかでサインアウトしたか、管理者がアクセスを削除したことを意味します。期限切れのトークンは、自動リフレッシュがセッション中に失敗したことを意味します。

OAuth token revoked · Please run /login
OAuth token has expired · Please run /login
API Error: 401 ... authentication_error

対応方法：

• /login を実行して再度サインインしてください
• 再認証後、同じセッション内でエラーが返される場合は、最初に /logout を実行して保存されたトークンを完全にクリアしてから、/login を実行してください
• 起動全体でログインを繰り返しプロンプトされている場合は、トラブルシューティングのシステムクロックと macOS キーチェーンチェックを参照してください
• 403 Forbidden や OAuth ブラウザの問題を含む他の障害については、ログインと認証を参照してください

OAuth scope requirement

保存されたトークンは、新しい機能が必要とする権限スコープより前のものです。これは、/usage とステータスラインの使用量インジケーターから最も頻繁に表示されます。

OAuth token does not meet scope requirement: user:profile

対応方法：

• /login を実行して、現在のスコープで新しいトークンを作成してください。ログアウトする必要はありません。

ネットワークと接続エラー

これらのエラーは、Claude Code がネットワークリクエストで API に到達できなかったことを意味します。これらは通常、ローカルネットワーク、プロキシ、またはファイアウォール、あるいはクラウド環境のネットワークポリシーから発生します。

API に接続できない

API への TCP 接続に失敗したか、完了しませんでした。

Unable to connect to API. Check your internet connection
Unable to connect to API (ECONNREFUSED)
Unable to connect to API (ECONNRESET)
Unable to connect to API (ETIMEDOUT)
fetch failed
Request timed out. Check your internet connection and proxy settings

一般的な原因には、インターネットアクセスがない、api.anthropic.com をブロックする VPN、または設定されていない必須の企業プロキシが含まれます。

対応方法：

• 同じシェルから curl -I https://api.anthropic.com を実行して、API ホストに到達できることを確認してください。Windows PowerShell では、組み込みの Invoke-WebRequest エイリアスが使用されないように curl.exe -I https://api.anthropic.com を使用してください。
• 企業プロキシの背後にある場合は、Claude Code を起動する前に HTTPS_PROXY を設定し、ネットワーク設定を参照してください
• LLM ゲートウェイまたはリレーを通じてルーティングする場合は、ANTHROPIC_BASE_URLをそのアドレスに設定してください。セットアップについては、LLM ゲートウェイに Claude Code を接続するを参照してください。
• ファイアウォールがネットワークアクセス要件に記載されているホストを許可していることを確認してください
• 一時的な障害は自動的にリトライされます。永続的な障害はローカルネットワークの問題を指しています

curl は成功しても Claude Code が失敗する場合、原因は通常、ネットワーク自体ではなく、ランタイムとネットワークの間にあります。

• Linux および WSL では、/etc/resolv.conf で到達不可能なネームサーバーを確認してください。特に WSL はホストから壊れたリゾルバーを継承できます。
• macOS では、切断または削除された VPN クライアントがトンネルインターフェースまたはルーティングルールを残す可能性があります。ifconfig で古い utun インターフェースを確認し、システム設定で VPN のネットワーク拡張を削除してください。
• Docker Desktop および同様のコンテナランタイムは、アウトバウンドトラフィックをインターセプトできます。それらを終了して再試行し、これを除外してください。

SSL 証明書エラー

ネットワーク上のプロキシまたはセキュリティアプライアンスが、独自の証明書で TLS トラフィックをインターセプトしており、Claude Code がそれを信頼していません。

Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
Unable to connect to API: Self-signed certificate detected

対応方法：

• 組織の CA バンドルをエクスポートし、NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem で Claude Code をポイントしてください
• 完全なセットアップ手順については、ネットワーク設定を参照してください
• 証明書検証を完全に無効にする NODE_TLS_REJECT_UNAUTHORIZED=0 を設定しないでください

クラウドセッションでホストが許可されていない

クラウドセッションまたはルーチンからのアウトバウンド HTTP リクエストが、環境のネットワークポリシーによってブロックされました。

HTTP 403
x-deny-reason: host_not_allowed

宛先の実際の証明書と一致しない TLS 証明書が表示される場合もあります。クラウド環境はアウトバウンドトラフィックをプロキシを通じてルーティングしてネットワークポリシーを適用するため、証明書の不一致は宛先ではなくプロキシが接続を終了したことを意味します。

これはクライアント側のネットワーク問題ではありません。クラウドセッションとルーチンは、アウトバウンドトラフィックが環境のアローリストにフィルタリングされるサンドボックス環境内で実行されます。デフォルト環境は信頼済みアクセスを使用し、パッケージレジストリ、クラウドプロバイダー API、コンテナレジストリ、および一般的な開発ドメインのデフォルトアローリストを許可しますが、その他すべてをブロックします。

対応方法：

• ルーチンを編集用に開くか、クラウドセッションを開始してください。デフォルトなどの環境名を表示しているクラウドアイコンを選択して、セレクターを開いてください。環境にマウスを置き、設定アイコンをクリックしてください。
• クラウド環境を更新ダイアログで、ネットワークアクセスを信頼済みからカスタムに変更し、ブロックされたドメインを許可されたドメインに追加してください。1 行に 1 つのドメインを入力してください。デフォルトリストの一般的なパッケージマネージャーも含めるをチェックして、カスタムドメインと共にデフォルトアローリストを保持してください。無制限アクセスが必要な場合は、代わりにフルを選択してください。
• 変更を保存をクリックしてください。次の実行は更新されたアローリストを使用します。

アクセスレベルとデフォルトアローリストについては、ネットワークアクセスを参照してください。ローカル CLI セッションはこのポリシーの影響を受けません。

リクエストエラー

これらのエラーは、API がリクエストを受け取ったが、その内容を拒否したことを意味します。

Prompt is too long

会話と添付ファイルがモデルのコンテキストウィンドウを超えています。

Prompt is too long

対応方法：

• /compact を実行して以前のターンを要約し、スペースを解放するか、/clear を実行して新しく開始してください
• /context を実行して、ウィンドウを消費しているものの内訳を確認してください。システムプロンプト、ツール、メモリファイル、およびメッセージです
• /mcp disable <name> で使用していない MCP サーバーを無効にして、コンテキストからツール定義を削除してください
• 大きな CLAUDE.md メモリファイルをトリミングするか、関連する場合にのみロードされるパススコープルールに指示を移動してください
• サブエージェントは親セッションからすべての MCP ツール定義を継承します。これにより、最初のターンの前にコンテキストウィンドウが満杯になる可能性があります。サブエージェントを生成する前に、使用していない MCP サーバーを無効にしてください。
• 自動コンパクトはデフォルトで有効になっており、通常このエラーを防ぎます。DISABLE_AUTO_COMPACTを設定している場合は、再度有効にするか、ウィンドウが満杯になる前に /compact を手動で実行してください。

コンテキストウィンドウを探索するを参照して、コンテキストがどのように満杯になるかのインタラクティブビューを確認してください。

Error during compaction: Conversation too long

/compact 自体が失敗しました。これは、生成される要約を保持するのに十分な空きコンテキストがないためです。

Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

これは、ウィンドウが自動コンパクトがトリガーされる時点で既に満杯の場合、または Prompt is too long を見た後に /compact を実行する場合に発生する可能性があります。

対応方法：

• Esc を 2 回押してメッセージリストを開き、数ターン戻ってください。これにより、最新のメッセージがコンテキストから削除されます。その後、/compact を再度実行してください。
• 戻ることで十分なスペースが解放されない場合は、/clear を実行して新しいセッションを開始してください。以前の会話は保存され、/resume で再度開くことができます。

Request too large

生のリクエストボディが、トークン化前に API のバイト制限を超えました。通常、大きく貼り付けられたファイルまたは添付ファイルが原因です。

Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.

これは、コンテキストウィンドウ制限とは別の HTTP リクエストのサイズ制限です。

対応方法：

• Esc を 2 回押して、サイズを超えたコンテンツを追加したターンを過ぎて戻ってください
• 大きなファイルをパスで参照して、内容を貼り付けるのではなく、Claude がチャンク単位で読み取ることができるようにしてください
• 画像については、以下の画像が大きすぎましたを参照してください

Image was too large

貼り付けられた、または添付された画像が API のサイズまたは寸法制限を超えています。

Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size

{/* min-version: 2.1.142 */}Claude Code は処理できない画像をテキストプレースホルダーに置き換えて再試行するため、後続のメッセージは成功します。v2.1.142 より前のバージョンでは、貼り付けられた画像は会話に残る可能性があり、後続のすべてのメッセージで同じエラーが繰り返される可能性があります。これらのバージョンで復旧するには、Esc を 2 回押して、画像が追加されたターンを過ぎて戻ってください。

対応方法：

• 貼り付ける前に画像をリサイズしてください。API は、単一の画像の場合は最長辺で最大 8000 ピクセル、またはコンテキストに多くの画像がある場合は 2000 ピクセルの画像を受け入れます。
• 全画面ではなく、関連する領域のより厳密なスクリーンショットを撮ってください

Unable to resize image

Claude Code は、API に送信する前に添付された画像をダウンスケールできませんでした。

Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.

Claude Code は通常、大きな画像を自動的にリサイズします。これらのエラーは、ネイティブ画像プロセッサーがロードに失敗したか、エラーを返したため、画像を API 制限内に収まるようにリサイズできなかったことを意味します。

対応方法：

• メッセージが画像の変換を求めている場合は、PNG、JPEG、GIF、または WebP に変換して、再度添付してください。Claude Code はこれらの形式の寸法を画像プロセッサーなしで検証できます。
• メッセージが寸法またはサイズ制限を報告している場合は、その制限以下に画像をリサイズまたは再圧縮してから添付してください。

PDF errors

添付した PDF を処理できませんでした。

PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.
PDF is password protected. Try removing protection or extracting text first.
The PDF file was not valid. Try converting to a different format first.

対応方法：

• サイズの大きい PDF の場合は、ファイル全体を添付する代わりに Read ツールでページ範囲を読み取るよう Claude に依頼するか、pdftotext などのツールでテキストを抽出し、パスでファイルを参照してください
• 保護されたまたは無効な PDF の場合は、パスワードを削除するか、ソースアプリケーションからファイルを再度エクスポートしてから、再度試してください

Extra inputs are not permitted

Claude Code と API の間のプロキシまたは LLM ゲートウェイが anthropic-beta リクエストヘッダーをストリップしたため、API はそれに依存するフィールドを拒否しました。

API Error: 400 ... Extra inputs are not permitted ... context_management
API Error: 400 ... Extra inputs are not permitted ... tools.0.custom.input_examples
API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header

Claude Code は、context_management、effort、ツール input_examples などのベータのみのフィールドを、それらを有効にする anthropic-beta ヘッダーと共に送信します。ゲートウェイがボディを転送しますがヘッダーをドロップすると、API は認識しないフィールドを見ます。

対応方法：

• anthropic-beta ヘッダーを転送するようにゲートウェイを設定してください。機能パススルーを参照して、ゲートウェイが転送する必要があるものを確認してください。
• フォールバックとして、起動前にCLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1を設定してください。これにより、ベータヘッダーが必要な機能が無効になり、リクエストはそれを転送できないゲートウェイを通じて成功します。

There's an issue with the selected model

設定されたモデル名が認識されなかったか、アカウントがそれへのアクセスを持っていません。v2.1.160 以降、表示される末尾のヒントはサーフェスによって異なります。

There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.

対応方法：

• インタラクティブ CLI：/model を実行して、アカウントで利用可能なモデルから選択してください。
• 非対話型モード（-p）：--model に有効なエイリアスまたは ID を渡すか、ANTHROPIC_MODELを設定してください。エラーテキストはこのサーフェスで Run --model を表示します。
• Agent SDK：モデルがプログラムで設定されているため、エラーテキストはヒントを省略します。TypeScript でOptions の modelを設定するか、Python でClaudeAgentOptions(model=...)を設定し、構造化された model_not_found エラーを処理して、独自の再試行またはモデルピッカーを表示してください。
• sonnet や opus などのエイリアスを完全なバージョン ID ではなく使用してください。エイリアスは最新リリースを追跡するため、古くなりません。モデル設定を参照してください。
• 間違ったモデルが戻り続ける場合は、古い ID がどこかに設定されています。優先順位順で確認してください。--model フラグ、ANTHROPIC_MODEL 環境変数、その後 .claude/settings.local.json、プロジェクトの .claude/settings.json、および ~/.claude/settings.json の model フィールド。古い値を削除すると、Claude Code はアカウントのデフォルトにフォールバックします。
• Vertex AI デプロイメントについては、Vertex AI トラブルシューティングを参照してください。

Claude Opus is not available with the Claude Pro plan

アクティブなサブスクリプションプランには、選択したモデルが含まれていません。

Claude Opus is not available with the Claude Pro plan · Select a different model in /model

対応方法：

• /model を実行して、プランに含まれるモデルを選択してください
• 最近プランをアップグレードしてもこれが表示される場合は、/logout を実行してから /login を実行してください。保存されたトークンはサインイン時のプランを反映しているため、ウェブでアップグレードしても既存のセッションで有効になるまで再認証する必要があります。
• claude.com/pricingを参照して、各プランに含まれるモデルを確認してください

Model is restricted by your organization's settings

組織の管理者が Claude Console でこのモデルを無効にしたか、管理設定の availableModels 許可リストで除外されています。制限されたモデルが --model、ANTHROPIC_MODEL、または model 設定で設定された場合、Claude Code は許可されたモデルに置き換えて続行します。制限されたモデルに対して /model <name> を入力すると、Run /model to choose a different model. で拒否され、セッションは現在のモデルを保持します。

Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

対応方法：

• /model を実行して、組織が許可するモデルから選択してください。制限されたモデルはピッカーから非表示になります。
• 制限されたモデルが --model、ANTHROPIC_MODEL、または設定ファイルの model フィールドで設定された場合は、その値を削除または更新して、起動するたびに通知が繰り返されないようにしてください
• 制限されたモデルへのアクセスが必要な場合は、組織の管理者に有効にするよう依頼してください。組織モデル制限を参照してください。

thinking.type.enabled is not supported for this model

Claude Code バージョンが Opus 4.7 または Opus 4.8 の最小値より古いです。CLI は、モデルが受け入れなくなった思考設定を送信しました。

API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

対応方法：

• claude update を実行して Claude Code を再起動してください。Opus 4.7 は v2.1.111 以降が必要です。Opus 4.8 は v2.1.154 以降が必要です
• アップグレードできない場合は、/model を実行して Opus 4.6 または Sonnet を選択してください
• Agent SDK でこれに遭遇した場合は、SDK トラブルシューティングを参照してください

Thinking budget exceeds output limit

設定された拡張思考予算が最大レスポンス長を超えているため、実際の回答用のスペースが残っていません。

API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

Claude Code は Anthropic API でこれらの値を自動的に調整します。通常、Amazon Bedrock または Google Vertex AI でこのエラーが表示されるのは、MAX_THINKING_TOKENSがプロバイダーの出力制限より高く設定されている場合、またはプランモードが思考予算を上げる場合です。

対応方法：

• MAX_THINKING_TOKENS を低くするか、CLAUDE_CODE_MAX_OUTPUT_TOKENSを思考予算より上に上げてください
• 拡張思考を参照して、予算が出力長とどのように相互作用するかを確認してください

Tool use or thinking block mismatch

会話履歴が矛盾した状態で API に到達しました。通常、ツール呼び出しが中断されたか、ターンがストリーム中に編集された後です。

API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
API Error: 400 ... thinking blocks ... cannot be modified

3 つのバリアントはすべて同じことを意味します。履歴内の tool_use、tool_result、および thinking ブロックのシーケンスが、API が期待するものと一致しなくなりました。

対応方法：

• {/* max-version: 2.1.155 */}Opus 4.7 または Opus 4.8 を使用している場合は、まず claude update を実行してください。v2.1.156 より前のバージョンは、通常のツール使用中にこのエラーをトリガーでき、/rewind はそれをクリアしません。
• /rewind を実行するか、Esc を 2 回押して、破損したターンの前のチェックポイントに戻り、そこから続行してください。チェックポイントを参照して、チェックポイントがどのように作成および復元されるかを確認してください。

Usage Policy refusal

API は、会話内のコンテンツが利用規約チェックをトリガーしたため、応答を拒否しました。メッセージには、拒否が正しくないと思われる場合にサポートに引用できるリクエスト ID が含まれています。

API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

チェックは最新のプロンプトだけでなく、会話全体を評価するため、同じセッションで新しいメッセージを送信すると、通常は同じ拒否が再度トリガーされます。--continue または --resume でセッションを終了して再度開いた後も同じことが当てはまります。ディスク上のトランスクリプトにはまだトリガーコンテンツが含まれているためです。

対応方法：

• Esc を 2 回押すか /rewind を実行して、拒否をトリガーしたターンの前のチェックポイントに戻り、その後、別の方法で言い換えるか、別のアプローチを取ってください。チェックポイントを参照してください。
• どのターンが原因かを特定できない場合は、/clear を実行して同じプロジェクト内で新しい会話を開始してください。以前の会話はディスクに保存され、/resume で利用可能なままです。
• 非対話型モード（-p）では、巻き戻しが利用できないため、言い換えたプロンプトで再試行するか、--continue なしで新しいセッションを開始してください。ポリシーチェックはモデルによって異なるため、--model で別のモデルに切り替えると、場合によっては拒否が解決される可能性があります。

Responses seem lower quality than usual

Claude の回答がエラーなしで予想より能力が低いように見える場合、原因は通常、モデル自体ではなく会話状態です。Claude Code はモデルバージョンを静かに変更しません。3 つの特定のケースでフォールバックモデルに切り替えることができます。

• 設定された --fallback-model は可用性エラーの後にそのターンのみ引き継ぎ、トランスクリプトに通知が表示されます
• Bedrock または Vertex AI スタートアップチェックがデフォルトモデルが利用不可であることを検出します
• Automatic model fallback on Fable 5 はセッションをデフォルト Opus モデルに移動し、トランスクリプトに通知を表示します

以下のモデル選択チェックは 2 番目と 3 番目のケースをキャッチします。最初のケースはトランスクリプト通知として表示され、/model 変更ではなく表示されます。Model configuration はそれぞれのフォールバックが適用される場合を説明しています。

最初にこれらを確認してください。

• モデル選択：/model を実行して、予想されるモデルにいることを確認してください。以前の /model 選択または ANTHROPIC_MODEL 環境変数により、意図したより小さいモデルにいる可能性があります。
• 努力レベル：/effort を実行して、現在の推論レベルを確認し、難しいデバッグまたは設計作業のためにそれを上げてください。デフォルトはモデルによって異なるため、最大値より下にあると仮定する前に確認してください。Adjust effort level を参照して、モデルごとのデフォルトと ultrathink ショートカットを確認してください。
• コンテキスト圧力：/context を実行して、ウィンドウがどの程度満杯かを確認してください。容量に近い場合は、自然な区切り点で /compact を実行するか、/clear を実行して新しく開始してください。Explore the context window を参照して、自動コンパクトが以前のターンにどのように影響するかを確認してください。
• 古い指示：大きなまたは古い CLAUDE.md ファイルと MCP ツール定義はコンテキストを消費し、レスポンスを操作できます。/doctor は大きなメモリファイルとサブエージェント定義にフラグを立てます。/context は MCP ツールトークン使用量を表示します。

レスポンスが間違っている場合、修正で返信するより、巻き戻しの方が通常うまくいきます。Esc を 2 回押すか、/rewind を実行して悪いターンの前に戻り、より詳細なプロンプトで言い換えてください。スレッド内で修正すると、間違った試みがコンテキストに残り、後の回答をそれに固定できます。Checkpointing を参照してください。

上記を確認した後も品質が異常に見える場合は、/feedback を実行して、期待したものと得たものを説明してください。このように送信されたフィードバックには会話トランスクリプトが含まれており、Anthropic が実際の回帰を診断する最速の方法です。環境で /feedback が利用できない場合は、Report an error を参照してください。

エラーを報告する

このページでは Claude API からのエラーについて説明しています。Claude Code の他のコンポーネントからのエラーについては、関連するガイドを参照してください。

• MCP サーバーが接続または認証に失敗しました：MCP
• フックスクリプトが失敗したか、ツールをブロックしました：フックをデバッグする
• インストール中に権限が拒否されたか、ファイルシステムエラーが発生しました：インストールとログインのトラブルシューティング

エラーがここに記載されていない場合、または提案された修正が役に立たない場合：

• Claude Code 内で /feedback を実行して、トランスクリプトと説明を Anthropic に送信してください。コマンドは、事前入力された GitHub イシューを開くことも提供します。Bedrock、Vertex AI、Foundry、およびその他のサードパーティプロバイダーでは、/feedback はローカルアーカイブを保存し、Anthropic アカウント担当者に送信できます。
• /doctor を実行してローカル設定の問題を確認してください
• status.claude.com でアクティブなインシデントを確認してください
• GitHub の既存のイシューを検索してください