Claude API の 200K コンテキストをどう割り振るか — システム・ツール・メモリ・履歴の予算枠を実運用で決めた話
Claude API の 200K コンテキストを「無制限の置き場」ではなく予算として扱い、システム・ツール定義・メモリ・履歴・回答ヘッドルームに枠を切る設計を、TypeScript の実装コードと壁紙アプリ運用で得た数値とともに記録しました。
Claude API の tool_result could not be submitted が再発しないための回復ハンドラ設計
Claude API でエージェントを長時間動かしていると、ある日突然 'tool_result could not be submitted' が連発し始めることがあります。再試行しても直らない、ストリーミング途中で死ぬ、そして次のセッションでもまた出る — 個人開発で運営している6サイトの自動投稿パイプラインで実際に踏み抜いた4種類の原因と、TypeScript で書いた回復ハンドラの実装を整理しました。
Claude API のトークンコストを月初3日間データから±10%精度で月末予測する
月初の3日間トークン消費データから月末コストを±10%精度で予測するEWMA＋季節性分解モデルの実装と、しきい値超過時に自動的にプロンプトキャッシュやモデルルーティングを切り替える本番設計を解説します。
Claude エージェントのツール返り値を圧縮する — 巨大レスポンスを文脈に積まずに集約する設計
データベースの数千行、Webスクレイプ後のHTML、ファイル読み込みの数MBといった巨大なツール出力をそのまま Claude に渡すと文脈が破裂し、コストも品質も同時に悪化します。スキーマ縮約・サマリ・参照渡しの3層で圧縮する本番アーキテクチャを実装パターン付きで整理しました。
Claude API のチャット履歴を階層サマライズする：3 段階圧縮でトークンを 70 % 削減した設計
壁紙アプリのインアプリ AI チャットで増え続ける履歴トークンを抑えるため、直近ターン・中期エピソード・長期エンティティの 3 層に分けて圧縮する設計を、TypeScript の動くコードと 7 週間の運用データつきで記録しました。月額 API 費用を $480 から $145 まで下げています。
Claude エージェントに安全弁を仕込む：個人運営で暴走を止める三層キルスイッチ設計
個人運営の Claude エージェントで実際に経験したリトライ暴走 3 時間で $32 の損失を起点に、プロセス内ガード・プラットフォーム停止フラグ・観察層の三層キルスイッチを Cloudflare Workers + KV で組む設計記録。TypeScript の動くコードと運用メトリクス付き。
Claude API の metadata.user_id は何のために送るのか — abuse 検知とプライバシーの折り合いを設計する
Claude API の metadata.user_id は abuse 検知の精度を上げるためのフィールドですが、生のメールアドレスをそのまま渡すとプライバシー上の問題が出ます。HMAC で安定した擬似 ID を作る具体的な実装と、渡すべき/渡さない場面の判断基準をまとめました。
Claude API のプレフィルで『JSON 出力が必ず通る』本番設計 — 個人 SaaS で辿り着いた4層防御
Claude API のプレフィル機能だけでは JSON パースが落ちる本番ケースを、4層防御パイプラインで月数千リクエスト・パース成功率 100% に持っていった実装記録です。TypeScript と Python の両方の動くコード付き。
Claude API の 400/422/529 を“呼ぶ前”に消す5層プリフライト設計 — 月数百件の失敗呼び出しをゼロにした実装
Claude API の 400/422/529 エラーを“呼ぶ前”に止める5層プリフライト設計を、TypeScript の完全実装と運用1ヶ月分の数値でまとめました。失敗呼び出しのコスト・リトライ・通知ノイズを同時に削減できます。
Claude Agent SDKでサーガパターンを実装する — 補償トランザクションと冪等性の設計
Claude Agent SDKで複数ステップのワークフローを安全に組み立てる実践ガイド。補償トランザクション・冪等性キー・部分失敗時の状態復元を、本番環境で動かしてきた構成パターンとともに紹介します。
Claude Agent SDK の Transactional Outbox 実装 — 「副作用の取りこぼし」を本番でゼロにする設計
Claude Agent SDK で発生する「DBには書かれたのにメール/決済/通知が飛ばなかった」事故を防ぐため、Transactional Outbox パターンを Postgres と Cloudflare Queues を例に本番品質で実装する手順をまとめます。
「営業チームが欲しがる」AI自動化 — Claude Agent SDK で構築するマルチエージェント営業支援システム
Claude Agent SDK を使ってリード管理・提案書生成・フォローアップを自動化するマルチエージェント営業支援システムを本番レベルで構築する完全ガイド。コスト最適化・人間レビューゲート・CRM連携の実装例も詳細に解説します。