Claude Code や claude.ai を使っていると、英語のエラーや警告がいきなり出てきます。メッセージの多くは原因の候補がだいたい決まっていて、やることも数手で済みます。このページでは、よく出るメッセージを原文のまま並べ、それぞれ「何が起きているか」と「まず何をすればいいか」を一行で書きました。
ブラウザの検索(Mac は Cmd + F、Windows は Ctrl + F)で、画面に出た英文の一部を貼り付けて探してください。
確認環境: Claude Code 2.1.310(macOS)、claude.ai(Web)、2026-10-25 時点。Claude Code はバージョンごとに文言がよく変わります。表の
<time>や<n>は、実際の画面では時刻や数字に置き換わります。
どのエラーでも、先にこの3つを確認すると切り分けが早くなります。
Due to unexpected capacity constraints...(混雑による一時拒否)は、ステータスページに出ないことがあると公式ヘルプに書かれています。(not your usage limit) と書いてあるかを見る。書いてあれば、サーバ側が一時的に絞っているだけで、自分の使用量の枠とは関係ありません。claude auth status を実行する(セッション中なら /status)。"authMethod" が "api_key" になっていたら、サブスクではなく API キーで動いています。課金・認証系のエラーの多くはここが原因です(詳しくは下の「課金・認証」)。表の中から、手順まで詳しく書いた記事です。新しい順。
Credit balance is too low:Max/Pro 契約なのに Claude Code で『Credit balance is too low』が出るのは、環境に残った ANTHROPIC_API_KEY のせい(Qiita)Pro / Max の使用量は、claude.ai・Claude Code・IDE 拡張で共通です。どこで使っても同じ枠から減ります。
| 画面に出る原文 | 何が起きているか | こうする |
|---|---|---|
You've hit your session limit · resets <time>(旧版: You've hit your limit · resets <time>) |
5時間ごとの枠を使い切った | 表示の時刻まで待つ。/usage で残りを確認。急ぐなら /usage-credits で追加購入 |
5-hour limit reached - resets <time>(claude.ai) |
同上 | 同上。Settings → Usage で確認 |
You've hit your weekly limit · resets <time> / You've reached your weekly limit. It resets <day> at <time>. |
週の枠を使い切った。全モデル共通なので、モデルを変えても戻らない | 5時間待っても戻りません。リセット日まで待つか、追加購入・上位プラン |
You've hit your Opus limit · resets <time> |
Opus だけの枠を使い切った | /model で Sonnet に切り替えれば続けられる |
You've used <n>% of your session limit · resets <time> / Approaching your 5-hour usage limit |
上限が近いという予告 | 区切りのいいところで作業をまとめる |
Usage credits required for 1M context |
1M コンテキストのモデルは追加課金でしか使えない。枠切れではない | /model で [1m] の付かないモデルを選ぶ |
You're out of usage credits / You've hit your monthly spend limit. |
追加購入分の残高、または自分で決めた月の上限に達した | /usage-credits で上限を見直すか、翌月まで待つ |
Server is temporarily limiting requests (not your usage limit) |
サーバ側の一時的な絞り込み。自分の枠は関係ない | 少し待ってから再実行 |
どれも「自分のせいではない」系です。待つのが基本で、モデルを変えると通ることがあります。
| 画面に出る原文 | 何が起きているか | こうする |
|---|---|---|
API Error: 529 ... "overloaded_error" / Repeated 529 Overloaded errors. The API is at capacity |
API 全体が混んでいる。使用量の枠は減らない | 数分待つ。/model で別のモデルに切り替える |
Opus is experiencing high load, please use /model to switch to Sonnet |
Opus が混んでいる | 指示どおり Sonnet に切り替える |
Due to unexpected capacity constraints, Claude is unable to respond to your message. Please try again soon.(claude.ai) |
一時的な混雑 | 数分後に送り直す。別のモデルを選ぶ |
API Error: 500 ... "Internal server error" |
API 側の障害 | status.claude.com を確認して待つ |
Claude will return soon.(claude.ai) |
障害で止まっている | status.claude.com を見て待つ |
... · Retrying in <n>s · attempt <a>/<max> |
自動で再試行している途中 | そのまま待つ。最後まで失敗したら上の各項目へ |
ここに並ぶエラーは、原因が同じことがよくあります。Pro / Max を契約しているのに、シェルに古い ANTHROPIC_API_KEY が残っていて、API キーの側で動いているというものです。Claude Code は環境変数の API キーをサブスクのログインより優先して使います。claude -p で実行したときは、キーがあれば確認なしで必ずそちらを使います。
詳しい確認方法と直し方は Qiita にまとめました:サブスク契約なのに Credit balance is too low が出るとき
| 画面に出る原文 | 何が起きているか | こうする |
|---|---|---|
Credit balance is too low / Credit balance too low · Add funds: ... |
API キーの側の残高がない。サブスク契約者なら、たいてい API キーが紛れ込んでいる | claude auth status で確認。サブスクで使うなら unset ANTHROPIC_API_KEY してシェルの設定ファイルからも消し、/login |
This organization has been disabled. / Your ANTHROPIC_API_KEY belongs to a disabled organization |
無効になった組織(前の職場・昔のプロジェクトなど)のキーが残っている | 同上 |
Request rejected (429) |
API キーのレート制限。紛れ込んだ低い等級のキーで動いていることがある | /status で使っている認証を確認 |
Invalid API key · Fix external API key |
環境変数のキーが無効 | env で ANTHROPIC を含む変数を探し、外すか正しいキーにする |
claude.ai connectors are disabled because ANTHROPIC_API_KEY or another auth source is set |
API キーがあるため、claude.ai のコネクタが読み込まれない | サブスクで使うならキーを外す |
Not logged in · Please run /login / Login expired · Please run /login / OAuth token revoked · Please run /login |
ログインが切れた | /login。直らなければ /logout してから /login |
OAuth error: timeout of 15000ms exceeded |
ログイン処理がタイムアウトした | 障害を確認し、ターミナルから claude auth login をやり直す |
Unable to send verification code to this number. |
電話番号の認証が通らない | 別の番号を試す。だめなら公式サポートに問い合わせる |
| 画面に出る原文 | 何が起きているか | こうする |
|---|---|---|
Prompt is too long |
会話と添付の合計が上限を超えた | /compact で要約する。だめなら /clear で新しく始める |
Context low (<n>% remaining) · Run /compact to compact & continue / <n>% until auto-compact |
上限が近い | 次に何をするかを書いてから /compact すると、要約後も話が通じやすい |
Context limit reached · /compact or /clear to continue |
上限に達した | 同上 |
Error during compaction: ... Conversation too long. |
長すぎて要約すらできない | Esc を2回押して(/rewind)数手前に戻ってから /compact |
Claude's response exceeded the <n> output token maximum. |
一度の返答が長すぎた | 「ファイルごとに分けて書いて」のように分割を指示する |
Your message will exceed the length limit for this chat.(claude.ai) |
添付が大きすぎる | 添付を減らす・分ける。新しいチャットで始める |
Claude hit the maximum length for this conversation.(claude.ai) |
会話が上限に達した | 要点をまとめて新しいチャットに貼り、続きを頼む |
次のエラーは、一度出ると、それ以降どんな入力をしても同じエラーが返ってくることがあります。会話の記録の中に、API が受け付けない形が残ってしまった状態です。
API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.`thinking` or `redacted_thinking` blocks in the latest assistant message cannot be modifiedThe model's tool call could not be parsed (retry also failed).(日本語・中国語の会話で多いという報告が複数あります)Error: No assistant message foundCould not process imageRequest too large (max 20MB) / PDF too large上から順に試してください。
Esc を2回押す(または /rewind)。エラーが出る前の地点まで戻り、そこから言い直す/compact で会話を要約し直す/model で別のモデルに切り替える/clear で新しく始める(必要な前提は改めて書く)claude update で更新する画像のエラーは、画像を長辺 2000px 以下に縮めてから送ると通りやすくなります。
| 画面に出る原文 | 何が起きているか | こうする |
|---|---|---|
API Error: Stream idle timeout - partial response received |
返答の途中で通信が止まった | 長い出力は分けて書かせる。環境変数 CLAUDE_STREAM_IDLE_TIMEOUT_MS を長めにすると収まったという報告がある |
The response stopped arriving. The response above may be incomplete.(旧版: Connection closed mid-response) |
返答の途中で接続が切れた | 同上。ルーターの再起動や別の回線で試す |
Unable to connect to API (ECONNRESET) |
接続が途中で切られた | 別のネットワークで試す。VPN を切る |
Request timed out |
応答が返ってこない | 回線とプロキシの設定を確認 |
Self-signed certificate detected / unable to get local issuer certificate |
会社のプロキシが通信を検査していて、その証明書を信用できない | 社内の証明書を NODE_EXTRA_CA_CERTS で指定する。プロキシは HTTPS_PROXY で指定する(ターミナルは macOS のシステムのプロキシ設定を引き継がない) |
Network error / Failed to fetch(claude.ai) |
ブラウザ側の通信が失敗した | VPN や拡張機能を切る。シークレットウィンドウで試す |
| 画面に出る原文 | 何が起きているか | こうする |
|---|---|---|
Claude Code is unable to respond to this request, which appears to violate our Usage Policy / Claude is unable to respond to this request, ... |
安全フィルタに引っかかった。正当な作業でも誤って止まることがある | Esc を2回押して言い換える。何のための作業かを具体的に書く。新しいセッションにする |
Output blocked by content filtering policy |
著作物をそのまま出力しようとして止められた | 全文の書き出しではなく、要約や解説を頼む |
| 画面に出る原文 | 何が起きているか | こうする |
|---|---|---|
claude: command not found / Native installation exists but ~/.local/bin is not in your PATH |
claude の置き場所に PATH が通っていない |
~/.local/bin を PATH に追加してターミナルを開き直す |
Auto-update failed |
自動更新の失敗。npm で入れた古い版でよく起きる | npm 版を消してネイティブ版を入れ直す |
Raw mode is not supported on the current process.stdin |
パイプや CI など、キー入力のない環境で対話画面を開こうとした | claude -p "..." で実行する |
--dangerously-skip-permissions cannot be used with root/sudo privileges |
root で権限確認を飛ばそうとした | 一般ユーザで実行する |
| 画面に出る原文 | 何が起きているか | こうする |
|---|---|---|
MCP error -32000: Connection closed / Could not attach to MCP server <name> / MCP server <name> disconnected |
MCP サーバが起動直後に落ちた | サーバを手で起動して確かめる。ログを標準出力に出していないか確認する(標準エラーに出す)。command はフルパスで書く |
spawn <cmd> ENOENT(Claude Desktop) |
コマンドが見つからない。Desktop はターミナルの PATH を引き継がない | npx なども含め、フルパスで指定する |
<イベント名>:<ツール名> hook error |
フックがエラーを返した。成功しているのに error と表示されるバグも報告されている | フックを手で実行し、終了コードを確認する |
次のメッセージは、Claude が自分のために受け取っている作業メモです。画面やログで見かけても、あなたが何かする必要はありません。
File has not been read yet. Read it first before writing to it.File has been unexpectedly modified. Read it again before attempting to write it.Unchanged since last read