メインコンテンツへスキップ
エラー原文

Claude Code のエラーメッセージ一覧:原文・原因の所在・対処法

表示されたメッセージを入力するか貼り付けると絞り込めます。各項目に、原因が手元の環境・アカウント・サービス側・途中のゲートウェイのどこにあるかを示し、対処手順の記事へリンクしています。
  • メッセージ 63 件
  • 対処記事 15 本
  • 2026年11月15日 確認

ログイン・アカウント・認証

  • Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh

    この記事で扱うほかのメッセージ

    • Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh)
      • 原因:手元の環境・設定
      • CLI
    • EPERM: operation not permitted, mkdir

    ログインの拒否ではなく、別のClaude Codeが更新用ロックを残して止まった状態です。1分待って再実行し、続くなら他のプロセスを閉じて空のロックフォルダを確かめます。

  • Failed to authenticate. API Error: 403 Your account can't receive replies from Claude right now

    • 原因:アカウント・プラン
    • CLI
    • HTTP 403

    この記事で扱うほかのメッセージ

    • Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
      • 原因:アカウント・プラン
      • CLI
    • Replies from Claude are unavailable on your account. You can complete the verification now in the Anthropic Verification Portal
      • 原因:アカウント・プラン
      • Web
    • Complete verification to continue
      • 原因:アカウント・プラン
      • デスクトップアプリ

    Claude Codeの「can't receive replies」は本人確認の要求で、再試行や/loginでは消えません。対応地域なら身分証の原本で受けられます。

モデルが見つからない・使えない

  • There's an issue with the selected model (claude-fable-5.2)

    • 原因:複数の可能性
    • CLI

    この記事で扱うほかのメッセージ

    • You've reached your Fable limit.
      • 原因:アカウント・プラン
      • CLI
    • Fable 5.2's safeguards flagged this message
    • Claude Code doesn't recognize the model "claude-fable-5-2", so it assumes a context window of 200k tokens
      • 原因:手元の環境・設定
      • CLI
      • デスクトップアプリ
      • Issue #108785
    • Fable is experiencing high load, please use /model to switch to Sonnet
      • 原因:サービス側
      • CLI
    • Invalid signature in thinking block. The block is bound to a different conversation.
      • 原因:手元の環境・設定
      • API
      • HTTP 400

    Claude Fable 5.2が使えない時は、Claude Codeを2.1.321以降に更新し、/modelに出なければclaude-fable-5-2を直接指定します。

レート制限と混雑

  • API Error: Rate limit reached

    • 原因:複数の可能性
    • CLI
    • HTTP 429

    この記事で扱うほかのメッセージ

    • You've hit your session limit · resets 3:45pm
      • 原因:アカウント・プラン
      • CLI
    • You've hit your weekly limit · resets Mon 12:00am
      • 原因:アカウント・プラン
      • CLI
    • API Error: Server is temporarily limiting requests (not your usage limit)
      • 原因:サービス側
      • CLI
    • API Error: Request rejected (429) · this may be a temporary capacity issue
      • 原因:アカウント・プラン
      • CLI
      • HTTP 429
    • API Error: Usage credits required for 1M context
      • 原因:アカウント・プラン
      • CLI

    Claude Code の Rate limit reached は、サブスク上限・API の 429・1M 利用権・支出上限で対処が違います。原文と /usage で見分けます。

  • API Error: Repeated 529 Overloaded errors

    • 原因:サービス側
    • CLI
    • HTTP 529

    この記事で扱うほかのメッセージ

    • Opus is experiencing high load, please use /model to switch to Sonnet
      • 原因:サービス側
      • CLI
    • Opus is experiencing high load. Switch to Sonnet.
      • 原因:サービス側
      • デスクトップアプリ
    • API Error: Server error mid-response. The response above may be incomplete.
      • 原因:サービス側
      • CLI

    529 Overloadedは利用上限ではなくモデルの混雑で、表示前に最大10回再試行済みです。急ぐなら/modelで別モデルへ、次に備えるならフォールバックモデルを設定します。

サーバーエラーと接続切れ

  • API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}}

    • 原因:複数の可能性
    • HTTP 403

    この記事で扱うほかのメッセージ

    • App unavailable in region
      • 原因:複数の可能性
    • No available accounts
      • 原因:ゲートウェイ・中継
      • HTTP 503
    • No available channel for model X under group Y
      • 原因:ゲートウェイ・中継
      • HTTP 503
      • Issue #6915
    • API Error: 503 Bedrock is unable to process your request

    403や503は、社内プロキシ、アカウント権限、中継サービス、Bedrockのどれが返したかで直し方が変わります。529はAnthropic側の混雑で、利用上限ではありません。

  • API Error: 500 Internal server error

    • 原因:サービス側
    • HTTP 500

    この記事で扱うほかのメッセージ

    • OAuth error: Request failed with status code 500
    • API Error: 500 status code (no body)
    • No conversation found with session ID
      • 原因:手元の環境・設定

    Claude Codeの500は稼働状況を見て1回再試行します。作業途中なら完了済みの処理を確かめて残りだけ続け、ログイン中や特定の会話だけで出続けるときは別に切り分けます。

  • Unable to connect to API

    • 原因:手元の環境・設定
    • CLI

    この記事で扱うほかのメッセージ

    • ECONNREFUSED
      • 原因:手元の環境・設定
      • CLI
    • ECONNRESET
      • 原因:複数の可能性
      • CLI
    • ETIMEDOUT
      • 原因:手元の環境・設定
      • CLI
    • fetch failed
      • 原因:手元の環境・設定
      • CLI

    Claude Code を起動した shell から API host を確認し、network、proxy、CA、実行環境、gateway のうち失敗した経路だけを修正します。

リクエストが拒否される

  • top_p deprecated

    • 原因:複数の可能性
    • HTTP 400

    Claude Code の top_p deprecated は、実際に呼び出すモデルへ古いサンプリング指定が送られていないかを調べるのが出発点です。設定ファイルだけでなく、アダプタが組み立てた最後のリクエストから指定を省き、同じ作業が完了するか確認します。

アプリ・IDE・起動

ファイル・セッション・ローカルの状態

  • Error compacting conversation

    • 原因:複数の可能性
    • CLI
    • デスクトップアプリ

    この記事で扱うほかのメッセージ

    • Conversation too long. Press esc twice to go up a few messages and try again.
      • 原因:手元の環境・設定
      • CLI
      • デスクトップアプリ
      • Issue #7530
    • Prompt is too long · automatic compaction failed:
      • 原因:複数の可能性
      • CLI
      • デスクトップアプリ
    • Autocompact is thrashing: the context refilled to the limit within 3 turns of the previous compact, 3 times in a row.
      • 原因:手元の環境・設定
      • CLI
      • デスクトップアプリ
      • 2.1.89 から発生
    • Compaction failed · attached media exceeds size limits
      • 原因:手元の環境・設定
      • CLI
      • デスクトップアプリ
    • Compaction failed · conversation could not be reduced below the context limit
      • 原因:手元の環境・設定
      • CLI
      • デスクトップアプリ

    赤い「Error compacting conversation」は外枠で、原因は一緒に出る行にあります。claude update で更新し、その行に合った復旧手順を選びます。

  • Error writing file

    この記事で扱うほかのメッセージ

    • File has been modified since read, either by the user or by a linter. Read it again before attempting to write it.
    • EPERM: operation not permitted
      • 原因:手元の環境・設定
    • InputValidationError: Write failed due to the following issues: The required parameter `file_path` is missing
    • Error editing file

    Claude Code の Error writing file は要約です。Ctrl+O で原文を読めば、権限・文字コード・外部の変更・出力切れ・誤表示のどれか判別できます。

この一覧の作り方

  • 掲載するのは、当サイトの記事で扱っているメッセージだけです。原文はその記事から一字ずつ写しています。
  • バージョン、HTTP ステータス、GitHub の issue 番号は、リンク先の記事が示しているものです。記事に記載がない項目は空欄にしています。
  • 原因のラベルは、最初にどこを見るかを示します。確かめ方は記事に書いています。

一覧の最終確認日:2026年11月15日。