キャッシュ書き込み

キャッシュは書き込み時に課金されます。Anthropic の API（2026年9月時点）では、デフォルト5分の有効期間でプレフィックスを書き込むと基本入力価格の1.25倍、1時間の場合は2倍の費用がかかり、読み戻しはほとんどのモデルで基本価格の10分の1です。レスポンスは書き込まれた部分を cache_creation_input_tokens として別途報告します。

この計算式がキャッシュの採算性を決めます。Anthropic の価格設定では、5分書き込みの場合は1回の読み取りで、1時間書き込みの場合は2回の読み取りでブレークイーブンとなります。書き込んだが一度も読まれないプレフィックスは、キャッシュせずに送るより高コストになり、モデルの最小トークン数（モデルにより512〜4,096トークン、2026年9月時点）未満のプレフィックスは全くキャッシュされません。

エージェントセッションでは、書き込みは予測可能なタイミングで発生します。最初のリクエスト、各ターンで新たに追加された部分（次のターンで読み取れるように）、およびプレフィックスを破壊する要因（モデル切替、ツールリスト変更、システムプロンプト編集、キャッシュ有効期間を超える休止）後の全コンテキストです。

したがって、健全なセッションは書き込みよりもはるかに多く読み取ります。cache_creation_input_tokens がターンごとに高いままの場合、リクエストの冒頭が頻繁に変わり、各ターンで書き込みプレミアムを支払うだけで割引が得られません。