会話の途中でツールを差し替える — プロンプトキャッシュを守るツールレジストリの設計
ターン間でツールを追加・削除できるようになった一方、ツール定義はキャッシュプレフィックスの最前列にあります。12種類の変更を指紋で実測し、安定コアと揮発テールに分けるレジストリ設計とガード実装をまとめました。
本番で観測した引数分布からツールスキーマを締め直す
Claudeのツール呼び出しが渡してくる引数を本番で丸ごと記録し、その分布からJSON Schemaにenumやpatternを足して締め直す運用手法を整理しました。緩いスキーマが生む意味のドリフトの実例、段階的に締める手順、締め直し前後の実測値、状況別の推奨まで計測コード付きで紹介します。
ツールが返す画像を Claude に「見せる」 — tool_result を画像ブロックにしてトークンを約10分の1にする
ツールが返した画像を tool_result に文字列で詰めると、同じ画像が約10〜20倍のトークンを消費します。image コンテンツブロックとして返す正しい組み立て方と、SDK 実装・コスト見積もり・落とし穴を実コードでまとめました。
Claudeの構造化出力を本番で信頼する — 検証ゲートと修復ループの設計
Claude APIの構造化出力が「たまに」壊れる本番環境で、tool useによる強制・スキーマ検証ゲート・一度だけの修復ループ・劣化フォールバックを組み合わせ、壊れたJSONを運用から消すための設計をコード付きで解説します。
Claude Vision API 実装パターン — 画像解析・PDF 処理・OCR を本番品質で動かすまで
Claude API のビジョン機能を本番投入するための実装パターンをまとめました。Base64・URL・Files API の使い分け、ネイティブ PDF 処理、Tool Use による壊れない構造化抽出、Batch API でのコスト削減、エラー対処まで動くコードで解説します。
Claude API のストリーミングで tool_use の引数が JSON パースに失敗する原因と対処
Claude API のストリーミングで tool_use を受け取ると、なぜか JSON.parse が SyntaxError を返す。input_json_delta の正しい組み立て手順と、再接続時の取りこぼし対策をまとめます。
Claude API × Tauri 2 で本番デスクトップ AI アプリを構築する — Rust ブリッジ・SSE ストリーミング・配布までの実装
Tauri 2 と Claude API を組み合わせて、軽量で安全な本番デスクトップ AI アプリを構築する方法を解説。Rust 側でのキー保管、SSE ストリーミング、Tool Use 実装、コード署名と配布までを実装コード付きで体系的にまとめます。
Claude API で作る GitHub PR レビューボット — Webhook統合からセキュリティスキャン・品質スコアリングまで実装
Claude API × GitHub Webhook で PR レビューボットを実装します。Tool Use で構造化スコアリング・セキュリティ検査・改善提案を自動化し、署名検証・デバウンス・レート制限・コスト管理まで実運用で得た知見をまとめました。
Claude MCP ハイブリッドアーキテクチャ入門 — 決定論的ツールとAI推論を組み合わせる設計パターン
決定論的ツールとAI推論を組み合わせるClaude MCPハイブリッドアーキテクチャの設計パターンを解説します。MCPサーバーをゼロから構築する前提知識、3層構成での役割分担、Andrew Ng提唱のTool Useパターンの実装への活かし方を、売上分析エージェントの実践例とともに紹介します。
Claude API Programmatic Tool Calling（PTC）本番実装ガイド — マルチツール連携を10倍高速化する新手法
Claude APIのProgrammatic Tool Calling（PTC）を活用し、マルチツール連携のレイテンシを大幅削減する実装パターンを解説。Tool Search・Input Examplesとの組み合わせで本番級AIエージェントを構築する方法を紹介します。
Claude API 高度なツール使用：Tool Search・Programmatic Tool Calling・Tool Use Examples で大規模エージェントを構築する
Claude API の Tool Search Tool・Programmatic Tool Calling・Tool Use Examples を、ベータヘッダーの指定から実装まで通しでまとめました。Anthropic が公表した削減率の読み方と、この3機能を使わない方がよい場面も併せて記録しています。