実際のメッセージとそれぞれの意味
API Error: 429 {"type":"rate_limit_error", ...}/ 「レート制限に達しました」 — 時間枠内のリクエスト数、トークン数、または同時実行数の上限を超えました。次の指定に従って待ってください：retry-after.rate limit reached for <model>にモデル別の注記がある場合 — 制限はモデルごとに設定されています。ティアを切り替えるために/modelを使うと、多くの場合すぐに解消します。- 「使用量の上限に達しました」 /「上限は…にリセットされます」— レート制限ではなく、Pro/Maxサブスクリプションのローリング方式の使用量上限です。リセットを待つか、APIキーを使ってください。
529 overloaded_error— ユーザー側ではなく、処理能力の問題です。待機時間を延ばしながら再試行してください。詳しくはエラーガイドで説明しています。400 … tool use concurrency— 一つのターン内で並列のツール呼び出しが多すぎます。429ではありませんが、同じセッションで発生します。
Claudeのレート制限：三つの上限
Anthropicは、毎分のリクエスト数（RPM）、毎分の入力・出力トークン数（ITPM/OTPM）、処理中の同時リクエスト数に制限を設けています。制限はモデルごと、組織ごとに適用され、利用ティアに応じて変わります。累積利用金額が増えると、ティアは自動的に上がります。ゲートウェイは、アカウントごとに同様の独自制限を適用します。数値はAnthropicのドキュメントで公開され、コンソールにも表示されます。Claude Codeで重要なのは同時実行数とOTPMです。エージェントセッションでは、長く、出力の多いリクエストが並列に連続して実行されるためです。
チャットクライアントでは制限に達しないのに、Claude Codeでは達する理由
チャットクライアントは、一度に一つのリクエストを送信します。Claude Codeは各ターンをストリーミングし、その間ずっと同時実行枠を占有します。また、サブエージェントを並列実行し、それぞれが追加の枠を使います。さらに、ターンごとに会話全体を再送信するため、セッションが長くなるほど毎分のトークン数が増えます。大規模なリポジトリで十個のサブエージェントを動かすと、十本の同時ストリームと毎分数十万トークンが発生します。これが429です。
効果があることが多い順に並べた対処法
- 1. 再試行を待ちましょう。Claude Codeは次の指定に従います：
retry-after。ほとんどの429エラーは数秒で解消します。 - 2. 並列実行するサブエージェントを減らし、重いタスクは一斉に分散実行せず、順番に実行してください。
- 3.
/compact— コンテキストが小さくなると、ターンごとのトークン数が減ります。これがTPMを抑える手段です。 - 4. ティアを切り替えるには
/modelを現在のタスクに対して使ってください。制限はモデルごとに設定されています。 - 5. バックグラウンド処理をHaikuに移し、メインの処理ループにはSonnet/Opusを使ってください。
- 6. 制限の引き上げを依頼してください。Anthropicでは、利用金額のティアを上げるか、営業に依頼します。このゲートウェイでは、アカウント情報とワークロードを添えてサポートにメールしてください。新規アカウントの同時実行数は、一つの暴走したエージェントがプールを使い切らないよう、意図的に控えめに設定されており、依頼に応じて引き上げられます。
/compact focus on the current task
/model claude-sonnet-5
# in scripts: cap the loop and let retries happen
claude -p "..." --max-turns 20このゲートウェイのレート制限
リクエストの費用は残高から差し引かれるか、定額プランに含まれます。レート制限はアカウントごとに設定され、料金とは独立しています。ゲートウェイは複数の上流アカウントをプールしているため、あるアカウントでモデルごとの429が発生しても、別のアカウントに余裕があれば、エラーを表示せずそちらへフェイルオーバーします。これは、ここでのセッションが単一のコンソールキーより429エラーに遭遇しにくい理由の一つです。最も達しやすいのは同時実行数の制限です。並列実行するエージェント数を添えてサポートに連絡すれば、調整されます。
| 計画 | 期間 | 料金 |
|---|---|---|
| 1時間使い放題 | 1時間 | $1 |
| 24時間使い放題 | 24時間 | $10 |
| 1週間使い放題 | 1週間 | $49 |
| 15日間使い放題 | 15日間 | $89 |
まずは無料で試す
新規アカウントには $5分の無料APIクレジット を、コード CLAUDECODE で提供します。SonnetでClaude Codeを一晩試すのに十分な額です。その後は額面の7.69231倍のクレジットを利用できます。
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyよくある質問
Claude Codeの「APIエラー：レート制限に達しました」はどういう意味ですか？
HTTP 429を意味します。そのモデルの毎分のリクエスト数、トークン数、または同時リクエスト数の上限を超えています。Claude Codeはretry-afterに従って待機し、再試行します。解消しない場合は、並列実行するサブエージェントを減らし、/compactを実行してください。
Claudeにはどのようなレート制限がありますか？
毎分のリクエスト数、毎分の入力・出力トークン数、同時リクエスト数です。モデルごとに適用され、Anthropicでは利用ティアに応じて、ゲートウェイではアカウントごとに設定されます。エージェントセッションで達しやすいのは、同時実行数と出力トークン数の制限です。
Claudeのレート制限を引き上げるにはどうすればよいですか？
Anthropicでは、利用金額を増やすとティアが自動的に上がります。または営業に問い合わせてください。このゲートウェイでは、ワークロードを添えてサポートにメールしてください。同時実行数は依頼に応じて引き上げられます。
「使用量の上限に達しました」はレート制限と同じですか？
いいえ。これはPro/Maxサブスクリプションのローリング方式の上限です。レート制限は毎分の制限で、自動的に解消します。使用量の上限は、決められたスケジュールでリセットされます。
ゲートウェイでClaude Codeを実行
同じモデルを環境変数の設定だけで利用できます。額面の7.69231倍のクレジット、または定額無制限プランを選べます。 新規アカウント：コードCLAUDECODEで$5分の無料APIクレジット。
APIキーを取得 無制限プランを見るAI Prime Techは独立したAPIゲートウェイであり、Anthropicとの提携関係はなく、同社の推奨や支援も受けていません。「Claude」と「Claude Code」はAnthropicの商標です。ここで説明するClaude Codeの機能は、執筆時点のAnthropicの公開ドキュメントに基づいており、頻繁に変更されます。このページの料金とモデル一覧は、このゲートウェイの現在の設定から取得しています。