Claude API Cache Diagnostics（Public Beta）— `cache_miss_reason`でプロンプトキャッシュミスの原因を自動診断

Summary

Claude Developer Platformが5月13日にCache Diagnosticsをパブリックベータとしてローンチ。Messages APIリクエストに`diagnostics.previous_message_id`を渡すと、レスポンスに`cache_miss_reason`が含まれ、プロンプトキャッシュプレフィックスがどこで前ターンから乖離したかを説明する。ベータヘッダー`cache-diagnosis-2026-04-07`が必要。マルチターン会話では各ターンのレスポンス`id`を次ターンの`previous_message_id`として引き継ぐ。ミス理由は`system_changed`・`tool_config_changed`等の判別共用体で返され、`cache_missed_input_tokens`でキャッシュミスしたトークン数を定量把握可能。フィンガープリントはハッシュとトークン数推定のみを含み、生のプロンプト内容は保持しない。プロンプトキャッシュのコスト最適化に取り組む開発者にとって、キャッシュミスの根本原因を可視化する初のツール。