Claude Code APIエラー 429 レート制限: 修正方法

エラーテキスト

API Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"..."}}

意味

従量課金API利用には5時間または週次の許容量はありませんが、レート制限と同時実行制限はあります。リクエストのバーストが制限を超えると、超過したリクエストに429が返り、少し後に再試行できます。

手順別の修正

1. 1. 並列度を下げる

   余分なClaude Codeセッションを閉じ、並列サブエージェントを減らします。同じキーを共有するスクリプトやCIジョブもカウントされます。

2. 2. 待って再試行

   少し待ってから、メッセージを再度送信します。

3. 3. キーを分割する

   各チームメンバーまたはパイプラインに独自のキーを付与すると、利用履歴でビジーなジョブを特定しやすくなります。

4. 4. 残高と上限を確認する

   代わりに残高や利用上限についてのエラーが表示される場合は、チャージするかキーの上限を上げてください。

回避方法

• •同時実行エージェントの数を控えめに保つ。
• •スクリプトとCIにバックオフ付きの再試行を追加する。
• •/compact と /clear を使い、各ターンで送信するコンテキストを減らす。

失敗したリクエストは課金されますか？

失敗したリクエスト（4xx/5xx、タイムアウト、切断された接続）は課金されません。課金されるのは正常に完了したリクエストのみです。上流の失敗が自動的に再試行されて成功した場合、課金は1回です。

まだ失敗しますか？

• •aicodewithのモデルページを確認してください。各チャネルの最近の状態が表示されます。
• •ダッシュボードの利用履歴でリクエストを検索し、モデル、ステータス、コストを確認してください。
• •エラー発生時刻、モデル、エラーテキストを support@aicodewith.com までメールしてください（完全なAPIキーは決して送らないでください）。

モデルのステータスと価格サポートに問い合わせるドキュメント

FAQ