Claude API の 429 レート制限エラーを正しく処理する実装手順 — RPM・トークンバケツ・retry-after の3つのハマりどころ
Hiroba による自動要約
Claude API の 429 エラーは RPM だけでなく ITPM・OTPM というトークン単位の制限が別枠で存在するため、リクエスト数に余裕があっても発生する。レスポンスの retry-after ヘッダーに従うリトライと、SDK の自動リトライ設定の併用に注意が必要。実装例を交えて、レート制限ヘッダー確認・適切な待機時間・max_tokens 指定の落とし穴を解説。
読んで良かったら、シェアしてみてください。
同じタグの記事が他に 4191 件あります。
関連する記事
同じタグの記事
Claude Code on Bedrock の利用料金を個人単位で可視化・制御する仕組み
QiitaAWS Bedrock 環境を複数ユーザーで共有する際、CUR 2.0 と Athena、Lambda を組み合わせ、個人単位でのコスト可視化・日次通知・予算超過時の自動停止機能を実装した方式を紹介。設計選定から本番運用の落とし穴まで整理。
Ory Lumen で Claude Code を高速化・低コスト化—ローカル埋め込みで最大 53% の実行時間削減
HNOry Lumen はコードベースをローカル埋め込みでインデックス化し、Claude Code の実行時間を最大 53%、API コストを最大 39% 削減できる。SWE スタイルベンチマークで効果が検証済み。
Claude Code v2.1.267 リリース - maxEffortLevel 追加とプロンプトキャッシュ周辺の一括修正
DevIOClaude Code v2.1.267（53件の変更）がリリース。新機能では effort level に上限を設定できる maxEffortLevel、および --system-prompt-snapshot off フラグが追加された。修正は39件で、プロンプトキャッシュや thinking の破棄に関わる8件が主要。5MB超セッション再開時の並列ツール呼び出し欠落や管理設定読み込み失敗時の許可判定も修正。
Claude API の Files API で同じファイルを使い回す実装手順 — beta ヘッダー2箇所・ブロック型の対応・ダウンロード不可の3つのハマりどころ
QiitaClaude API の Files API を使うと、PDF や画像を毎回 base64 で送り直さず file_id で参照でき、転送量とコードの効率が改善される。client.beta.files.upload() でアップロード後、client.beta.messages.create() で file_id を指定する際、beta ヘッダーを両方に付けること・content block の型（document/image）をファイル種別と一致させること・アップロード済みファイルは再ダウンロード不可という3つのハマりどころがある。