エラーリファレンス

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 カウントダウンを表示します。

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

サーバーエラー

これらのエラーは、アカウントまたはリクエストではなく、Anthropic インフラストラクチャから発生します。

API Error: 500 Internal server error

Claude Code は、5xx ステータスの生の API レスポンスボディを表示します。以下の例は 500 レスポンスを示しています。

API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}} · check status.claude.com

これは 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 · check status.claude.com

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 フィールドをカスタムステータスラインに追加するか、デスクトップアプリでモデルピッカーの横にある使用量リングをクリックしてください。

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

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 status.claude.com.

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

対応方法：

• /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 キーチェーンの修正を確認してください。

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 に関連付けられているものです。サポートに連絡するか、別のアカウントでサインインしてください。

Routines are disabled by your organization's policy

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

Routines are disabled by your organization's policy.

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

対応方法：

• 管理者に 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 ゲートウェイ設定を参照してください。
• ファイアウォールがネットワークアクセス要件に記載されているホストを許可していることを確認してください
• 一時的な障害は自動的にリトライされます。永続的な障害はローカルネットワークの問題を指しています

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

画像はエラー後も会話履歴に残るため、削除するまで後続のすべてのメッセージは同じエラーで失敗します。

対応方法：

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

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

There's an issue with the selected model

設定されたモデル名が認識されなかったか、アカウントがそれへのアクセスを持っていません。

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

対応方法：

• /model を実行して、アカウントで利用可能なモデルから選択してください
• 完全なバージョン ID ではなく、sonnet や opus などのエイリアスを使用してください。エイリアスは最新リリースを追跡するため、古くなりません。モデル設定を参照してください。
• 間違ったモデルが戻り続ける場合は、古い 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を参照して、各プランに含まれるモデルを確認してください

thinking.type.enabled is not supported for this model

Claude Code バージョンが Opus 4.7 の最小値より古いです。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 を実行して v2.1.111 以降にアップグレードしてから、Claude Code を再起動してください
• アップグレードできない場合は、/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 が期待するものと一致しなくなりました。

対応方法：

• /rewind を実行するか、Esc を 2 回押して、破損したターンの前のチェックポイントに戻り、そこから続行してください。チェックポイントを参照して、チェックポイントがどのように作成および復元されるかを確認してください。

Responses seem lower quality than usual

Claude の回答がエラーなしで予想より能力が低いように見える場合、原因は通常、モデル自体ではなく会話状態です。Claude Code はモデルバージョンを静かに変更しません。Opus クォータに達した場合や Bedrock または Vertex AI リージョンがモデルを欠いている場合など、特定の場合にはフォールバックモデルに切り替えることができます。以下のモデル選択チェックはその両方をキャッチし、モデル設定はフォールバックが適用される場合を説明しています。

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

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

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

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

エラーを報告する

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

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

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

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