Claude API の Message Batches API で大量リクエストのコストを半額にする実装手順

自作の Claude ベースのエージェントツール（タスク分割・自動レビュー方式）で実装フェーズの請求が想定外に膨張した事例。出力は全コストの 21% に過ぎず、92.1M トークンのコンテキスト読み直しが 51% を占めた。原因は `claude -p` の毎回起動による cold start の cache_write（×1.25 倍課金）で、チャット利用時の「warm session 再利用」と異なり、タスクごとに固定コンテキストを×1.25 で焼き直していた。

Claude APIのweb検索ツールで、response_inclusionパラメータを「excluded」に設定することで、同一ターン内でコード実行により消費された検索結果ブロックをAPI応答から削除できるようになった。ダイナミックフィルタリングと組み合わせることで、長時間動作するリサーチエージェントのトークン消費を削減できる。

Claude Haiku 5.5 に306問の9択分類を3回解かせ、自己申告の確信度の安定性を検証。同一問題の確率は中央値0.10ぶれ、19%で回答が変化。一方、0.8以上と書いた問題の正解率は3回とも8割強で安定。「3回一致なら信じる」は確率より弱い結果。LLM の確信度を自動判定の閾値に使う開発者向けの実測データ。

Shopifyが公開したリモートMCPサーバー「Shop MCP」とClaude APIを組み合わせ、商品検索からShop Payによる決済までをチャット内で完結させるエージェントの構築記録。17個のツールをサーバー側で7個に再構成した設計判断、OAuth認可と支払い予算の設定手順、店舗によって`requires_escalation`となり決済を完了できない制約まで実装視点で整理。Agentic Commerceを検証する開発者向け。