⬡ API & SDK/2026-10-14中級
retry-after が 120 秒の 429 を受けると、Anthropic SDK の自動リトライは 120 秒待とうとしました
Anthropic SDK の自動リトライを模擬サーバーで12通り確かめました。既定は2回まで、retry-after は上限なしで従い、上限到達の429は待っても通りません。待ち時間と総時間に上限を持つ呼び出し口のコードと実測ログを載せます。
⬡ API & SDK/2026-06-16上級
予約実行が始まる前に、使うモデルが本当に応答するか1回だけ確かめる
設定したモデルが、夜間ジョブが動き出す前に消えていることがあります。引退・撤回・地域制限の3つを起動時の1回のプローブで見分け、適格なモデルへ実行設定を自動で書き換える設計を TypeScript の動くコードでまとめました。
⬡ API & SDK/2026-06-15上級
Anthropic API のベータヘッダを一元管理し、機能の引退でバッチを止めない設計
anthropic-beta ヘッダを散らばったまま使うと、ベータ機能の引退や GA 昇格でバッチ全体が 400 で落ちます。ケイパビリティ登録簿と起動時プリフライトで、機能の世代交代に耐える小さな抽象化を実装します。
⬡ API & SDK/2026-04-20上級
Claude API のストリーミングで詰まる3つの落とし穴——実装してわかった本当の難しさ
ReadableStreamが非同期イテラブルでないというエラーに2時間悩んだ経験から、Claude APIストリーミング実装の3つの落とし穴を整理しました。ランタイム環境によるストリーム非互換、エラーハンドリングのタイミング、トークン見積もりミスによるコスト超過を動くTypeScriptで解説します。
⬡ API & SDK/2026-03-21初級
Claude API 初めてのリクエストが失敗する？よくあるエラー FAQ
Claude API 初心者向けエラー解決ガイド。401認証エラー、429レート制限、400不正リクエスト、空レスポンス、ストリーミング失敗、tool_use、context window超過、tool_result submission、Spanner temporarily unavailable など9つのよくあるエラーの原因と解決法を網羅。