Claude API の同時実行を束ねる — シングルフライトで重複推論とキャッシュ・スタンピードを防ぐ
同一プロンプトが同時に何度も Claude へ飛ぶ重複推論を、シングルフライト（request coalescing）で束ねる設計です。プロセス内・分散環境の実装、ジッター付きリトライ、負のキャッシュまで実測付きでまとめました。
Claude API の metadata.user_id は何のために送るのか — abuse 検知とプライバシーの折り合いを設計する
Claude API の metadata.user_id は abuse 検知の精度を上げるためのフィールドですが、生のメールアドレスをそのまま渡すとプライバシー上の問題が出ます。HMAC で安定した擬似 ID を作る具体的な実装と、渡すべき/渡さない場面の判断基準をまとめました。
Claude API のリトライを書いたらレート制限が悪化した話 — Retry-After を読まないリトライの罠
Claude API でリトライを実装したのに 429 エラーがむしろ増えた、という相談をよく受けます。原因のほとんどは Retry-After ヘッダーの無視と、ジッターのない指数バックオフです。診断と修正手順をまとめました。
Claude APIをCloudflare Queuesで非同期処理する：障害復旧と優先度制御を含めた本番設計
Claude APIをCloudflare Queuesで非同期処理する本番グレードのパイプライン設計を、Producer/Consumer両方の動作コード・障害時のリトライ戦略・優先度制御・コスト制御まで含めて解説します。
Claude APIストリーミングが途中で切れる — 症状別の診断と修正パターン
Claude APIのストリーミングが途中で止まるとき、まず「エラーか無音か」で切り分けます。ネットワークタイムアウト、429や529のレート制限、コンテキストウィンドウ超過、max_tokens到達、クライアント実装のバグという5つの原因別に診断手順と修正コードを示し、本番で使える実装に仕上げます。
Claude の「Powerup」の正体 — Pro・Max・API を実運用から使い分ける
「Claude Powerup」は公式の機能名ではなく、コミュニティの造語です。Pro・Max・API のどれを選べば自分の使い方に合うのか、複数サイトの自動運用を続けてきた立場から、制限との付き合い方を含めて整理します。
Claude API の429・503エラーとタイムアウトを完全解決する対処法
Claude APIで発生する429レート制限・503サービス利用不可・タイムアウトエラーの原因と解決策を徹底解説。指数バックオフ実装からTier別上限の確認方法まで、現場で使える対処法を網羅します。