DevOps / CI/CD

Claude 3.5 Sonnet退役後、Cursor 429はどう切り分ける?(2026)

Claude 3.5 Sonnet退役後、Cursor 429はどう切り分ける?(2026)

Cursorで429が表示され、Anthropic側かCursor側か判断できない状態です。
最短の切り分けは、429を返した層を特定し、応答本文・限流ヘッダー・LiteLLMログを順に照合することです。Claude 3.5 SonnetのAnthropic APIモデルは2025年10月28日に退役しています。旧モデルIDへの呼び出しは、再試行で直る限流とは分けて扱ってください。退役日はAnthropicのモデル退役記録で確認できます。

Cursorから自分のAPIキーで接続している開発者は、上流とクライアントの境界を確認してください。
LiteLLMを使う担当者は、ゲートウェイの制限と上流の応答を分けて記録してください。
古いClaude 3.5 Sonnet連携を保守するチームは、モデルIDが現行かどうかを先に確かめてください。

Claude 3.5 Sonnet APIの429切り分けは、まず呼び出し経路を分けます

HTTP 429は応答の状態を示しますが、それだけで原因がAnthropic APIだとは断定できません。Cursorが表示したエラー、LiteLLMが受け取った要求、モデル提供元が返した応答は、別々の境界で記録します。

障害対応では、最初に「どの層がクライアントへ429を返したか」を押さえます。クライアント側の表示しか残っていない場合、上流の応答ヘッダーや具体的な制限値まで推測しないことが重要です。

Cursor直結と内蔵モデルサービスでは、確認できる証拠が異なります

自分のAPIキーで接続している場合

CursorのAPI Key設定で、自分のAnthropicキーを使う経路か、Cursorの内蔵モデルサービスを使う経路かを確認します。CursorのAPI Key設定説明では、独自キーを設定する経路が案内されています。キーの有無だけでなく、選択中のモデルと実際の呼び出し経路を照合してください。

CursorからClaude APIへ送った要求がAnthropicの限流か、どう見分けますか。
上流の応答を取得できる場合は、ステータスに加えて応答本文とretry-after、anthropic-ratelimit-*系ヘッダーを確認します。Anthropicの限流はRPM、ITPM、OTPMなど複数の軸で管理されます。特定の軸が残っていても、別の軸が上限に達している場合があります。AnthropicのAPI rate limitsには、429と関連ヘッダーの説明があります。

Anthropicのエラー仕様も併せて確認し、本文に含まれるエラー種別と応答コードを記録します。Claude APIのエラー応答に関する公式説明を参照し、クライアントの短いエラー表示だけで原因を決めないでください。

  • 利点:自分のAPIキー経由なら、自分の提供元アカウントに対応する応答を調べやすくなります。
  • 注意点:Cursor内蔵サービスの使用量や障害と、自分のキーに対する提供元の制限は同じものではありません。

Cursorの内蔵モデルサービスを使う場合

まず、モデル選択と利用経路を確認し、クライアントに表示された文面とアカウント側のサービス状態を記録します。上流の生の応答ヘッダーが見えない場合、画面上の429だけからRPM、トークン上限、アカウント固有の上限を特定することはできません。

上流の応答ヘッダーが見えないとき、何を確認できますか。
利用者側で確認できるのは、選択モデル、エラー表示、発生時刻、同じ操作で再現するかなどです。提供元に照会する必要があるのは、実際にどの制限が適用されたか、上流側で要求が拒否されたかといった情報です。確認できない値を推定して再試行間隔や上限を決めないでください。

LiteLLM経由では、入側ログと上流応答を照合します

LiteLLMの429は、ゲートウェイ側の制限と上流モデル提供元からの応答のどちらでも起こり得ます。仮想キー、チーム設定、デプロイメントの並行数など、ゲートウェイ側の制御と、モデル提供元の限流を切り分けます。

LiteLLMの429がゲートウェイ由来か、上流由来かをどう確認しますか。
同じ要求時刻の入側ログと上流要求の記録を照合してください。上流呼び出しが記録されていなければ、仮想キーやゲートウェイの制限を調べます。上流への要求と応答が記録され、提供元から429が返っているなら、その応答本文とヘッダーを起点に確認します。LiteLLMのProxyリクエスト処理の構成とユーザー単位の制限設定は、境界を把握する際の参考になります。

モデルグループ、再試行記録、フォールバックが実際に発生したかもログで確認します。LiteLLM Routerのルーティングと再試行の説明を参照し、設定上の予定と、今回の要求で起きた処理を混同しないでください。ここでは新規構築やフォールバック設定ではなく、発生箇所の特定に絞ります。

旧モデルIDと現行モデルのエラーを混同しないでください

設定ファイル、Cursorのモデル選択、LiteLLMのモデルマッピングを検索し、Claude 3.5 Sonnetの旧IDが残っていないか調べます。Anthropicの退役記録に照らし、退役済みIDへの要求と、現行モデルへの限流を別々に扱ってください。

退役済みモデルや無効なモデル指定に関するエラーは、429と同じ意味ではありません。ステータスコード、応答本文、モデルIDの有効性を照合し、現行モデルへ変更した後に同じ経路で応答とゲートウェイログを取り直します。モデルを変更しただけで、以前の429の発生源まで特定できたと考えないようにします。

再試行より先に、記録した証拠で次の手を選びます

切り分けでは、まず次の順に事実を記録します。

  1. Cursorのエラー表示と発生時刻を記録します。
  2. 自分のAPIキー直結、Cursor内蔵サービス、LiteLLM経由のどれかを確認します。
  3. 上流応答が取得できる場合は、本文、retry-after、限流ヘッダーを確認します。
  4. LiteLLM経由なら、入側ログ、上流要求、応答、再試行・フォールバックの記録を照合します。
  5. 使用中のモデルIDを退役記録と照らし、現行のIDかを確認します。
  6. 原因に応じて、待機、キーや制限設定の確認、モデルIDの修正、提供元への照会に進みます。

retry-afterが見当たらない場合も、すぐ再試行してよいですか。
ヘッダーが確認できないなら、まず上流応答を取得できているか、モデルが有効か、ゲートウェイ側の制限に達していないかを調べます。明示された待機時間がある場合は、その指示に従います。原因を確かめずに再試行を増やすと要求数が増え、復旧を遅らせることがあります。異なるモデルへのフォールバックも、同じ応答や挙動を保証するものではありません。

判定用チェックリスト:条件に合う対応を選びます

以下を上から確認し、最初に当てはまる条件の対応へ進んでください。

  • [ ] 上流応答に429と限流情報がある:提供元が示す待機指示と該当する制限軸を確認し、その指示に従ってから再試行します。
  • [ ] LiteLLMの入側記録はあるが、上流呼び出しの記録がない:再試行を増やさず、仮想キー、チーム設定、デプロイメントの制限を確認します。
  • [ ] 退役済み、または無効なモデルIDが設定に残っている:再試行ではなく、現行モデルIDへ修正し、同じ経路で応答を確認します。
  • [ ] Cursor内蔵サービスを使い、上流の応答を取得できない:モデル名、発生時刻、画面のエラー表示をまとめて、サービス提供元へ照会します。
  • [ ] 発生層もモデルIDの有効性も確認できていない:フォールバックや追加の再試行を決めず、先に呼び出し経路とログを確認します。

問題がモデルAPIではなく、開発機とゲートウェイの運用境界にあるなら、開発環境そのものも分けて考えます。ローカル環境ではスリープやネットワーク変化が作業継続に影響し、チームごとの環境差も切り分けを複雑にします。一方、クラウドMacは開発環境の選択肢であって、モデルAPIの限流を解除する手段ではありません。

APIの障害原因が解消した後も、開発機の状態維持やアクセス管理が負担なら、ProxyMacのMacレンタルを検討できます。利用環境の管理はコンソールから確認でき、手続きで不明点があればヘルプ案内を参照できます。API限流の解決には提供元とゲートウェイの確認が必要ですが、開発環境を分離したい場合はMac環境を別途用意する価値があります。

Cursorの検証環境を、専用のクラウドMacに

429の発生経路を落ち着いて確認できるよう、ProxyMacの専用Mac mini M4で開発環境を分けて運用できます。
SSHとブラウザからのVNCに対応しており、手元のMacに依存せずリモートで作業できます。