Claude Code に API Error: Rate limit reached が出たら、最初にプラン変更を考えるのではなく、制限の owner を特定します。認証経路、現在の usage/reset 表示、API key やクラウド provider の制限、コンテキスト肥大、ツールの再試行、誤検知状態を分けることが先です。
先に答え
- ClaudeアカウントまたはEnterpriseでログインしているなら、現在のアカウント/組織の usage/reset 表示を基準にします。
- API keyを使っているなら、
/costを実行し、Claude Console、Bedrock、Vertex、Microsoft Foundry の現在の limit、spend、retry-afterを確認します。 - タスクが大きい場合は、
/compact、/clear、狭いファイル範囲、/modelに出る軽い経路で圧を下げます。 - 使用量表示とエラーが合わない場合は、認証を更新し、セッションを再起動し、証拠を集めてからエスカレーションします。
制限の owner を確認する
Claude Code の制限面は少なくとも三つあります。Claudeアカウント/Enterpriseの使用量ウィンドウ、API key またはクラウド provider の rate/spend limit、そしてローカルセッション状態です。
bash/model /cost claude --version
/model は今日そのアカウントで使える model route を示します。/cost は API 課金経路で有効です。古い時間表、価格表、他人のスクリーンショットを現在の契約として使わないでください。
すぐ戻る手順
使える軽い route に切り替える。 フォーマット、短い編集、構文質問、要約は最重 route である必要はありません。高リスクの多ファイル変更や設計判断に強い route を残します。
コンテキストを整理する。 タスクが終わったら /clear。長い会話を残す必要があるなら /compact。別タスクを同じ古い会話で続けないことが重要です。
ファイル範囲を狭める。 リポジトリ全体ではなく、関係するディレクトリやファイルだけを指定します。検索、ファイル読み込み、ログ、テスト出力は後続の context になります。
retry-after を守る。 APIやクラウド経路では、headers と dashboard が古い記事の数字より信頼できます。
短い利用でも制限に当たる理由
Claude chat は直接の質問応答に近いです。Claude Code は agentic tool system で、ファイルを読み、検索し、コマンドを実行し、変更を書き、テストを走らせます。一つの見える依頼が複数の tool steps と model calls を生みます。
見るべきなのは利用分数ではなく、session が作った context と tool output です。大きい CLAUDE.md、広い検索、長いログ、失敗の再試行、subagents、古い thread の継続が後続 call を重くします。
使用量を下げる
CLAUDE.md は短く安定させます。現在の Anthropic route が prompt caching の恩恵を受ける場合でも、数値計画は最新ドキュメントで確認してからにします。
関連する質問は一つの構造化 prompt にまとめます。小さな質問を連続させると同じ context を何度も送ります。
長い説明はローカルファイルに保存し、次回はそのファイルを参照します。同じコードを毎回再解析させないでください。
タスクのリスクで route を選びます。低リスク編集は軽い route、高リスク変更は強い route。利用可能性は /model で確認します。
誤検知とエスカレーション
usage 表示とエラーが一致しない場合は、CLI version、auth route、/model、APIなら/cost、usage/reset screen、exact error、timestamp を残します。logout/login と fresh session を試してから、現在の issue tracker または support に持ち込みます。
待っている間にできること
テストを書く、ログを短くする、次のタスクを分割する、clean context packet を作る、PRを読む、ドキュメントを更新するなど、blocked route を使わない作業を進めます。別の coding tool を使うなら、現在の quota、model route、data policy、billing を先に確認してください。
FAQ
いつ回復しますか？
owner によります。Claude Code/アカウント表示の reset、API headers、Console、provider dashboard、Enterprise 管理設定を使います。
アップグレードすべきですか？
context cleanup、model routing、誤検知除外をしても実作業が止まる場合だけ検討します。今日の価格、待ち時間の損失、APIやEnterprise routeとの比較で判断します。
なぜ chat より重いのですか？
Claude Code は tool calls を実行するためです。file reads、searches、commands、writes、tests が context と calls を増やします。chat は通常もっと直接的な request-response です。