存在チェックが通っても書けない — 無人実行の前提を能力プローブで測る
ディレクトリが存在することと、そこへ書けることは別の問題です。無人で走るClaude Codeのセッションが静かに止まる原因を実測し、存在チェックの代わりに実際の読み書きを試す能力プローブ方式のプリフライトを設計しました。書けるのに消せない場所やシェルの落とし穴も扱います。
Message Batches に2万件投げたら41件だけ静かに欠けていたとき — 部分失敗を照合して再投入する運用メモ
Message Batches API の processing_status: ended は全件成功を意味しません。errored・expired が結果に静かに混ざる仕組みと、custom_id 台帳で欠落を照合し二重処理なく再投入する実装を、実運用の計測値とともに整理します。
自己修復ループに「諦める条件」を設計する — エラーを4分類して再試行予算を割り当てる
LLMの自己修復ループは「直し続ければいつか通る」という前提で組むと破綻します。エラーを4つのクラスに分類し、クラスごとに再試行予算を割り当てて諦める条件を明示する設計を、動くTypeScriptの分類器実装、コスト天井の置き方、構造化した試行ログ、フォールバックの段構えとともに解説します。
サブエージェントの並列実行で、1つの失敗が全体を巻き込まない設計
複数のサブエージェントを並列に走らせる fan-out / fan-in 構成を、トークン予算・結果コントラクト・部分失敗の扱いまで含めて設計します。1つのブランチが落ちても全体を止めない実装と実測値を共有します。
Claude API のストリーミングで詰まる3つの落とし穴——実装してわかった本当の難しさ
ReadableStreamが非同期イテラブルでないというエラーに2時間悩んだ経験から、Claude APIストリーミング実装の3つの落とし穴を整理しました。ランタイム環境によるストリーム非互換、エラーハンドリングのタイミング、トークン見積もりミスによるコスト超過を動くTypeScriptで解説します。
Claude API × Webhook・非同期処理のエラーとリカバリー戦略
Claude API をWebhookや非同期処理に組み込む際のエラーパターンを網羅。タイムアウト・重複処理・冪等性・デッドレターキューまで、本番環境で求められるリカバリー戦略を実装例つきで徹底解説します。
Claude API エラーハンドリングとリトライ戦略
Claude APIのHTTPステータスコードとエラータイプ、レート制限の仕組みを整理し、本番で安定した連携を実現するリトライ戦略を解説します。SDKの自動リトライ機能、サーキットブレーカーパターンの実装、ストリーミング時のエラー処理まで、堅牢な統合のための実践をまとめました。