プロンプトキャッシュは、同じコンテンツをClaudeに繰り返し送信する際に、リクエストをより安く、より速くする強力な最適化機能です。最初のリクエストがキャッシュへの書き込みを行い、それに続くリクエストはそこから読み取ることができます。キャッシュは5分間保持され、多くのアプリケーションが同じツールスキーマ、システムプロンプト、またはメッセージ履歴を繰り返し送信するため、非常に役立ちます。

プロンプトキャッシュの仕組み
コンテンツをキャッシュ対象としてマークすると、Claudeはそれを一度だけ処理し、結果を保存します。まったく同じコンテンツを含む後続のリクエストは、処理ステップをスキップしてキャッシュから直接読み取ることができます。これはキャッシュされたコンテンツが完全に同一である場合にのみ機能します。1文字の変更であってもキャッシュは無効になります。
1つのリクエスト内で複数のキャッシュブレークポイントを設定できます。キャッシュの順序は次のシーケンスに従います。
- ツールスキーマ
- システムプロンプト
- メッセージ履歴
ツールスキーマのキャッシュを設定する
ツールスキーマをキャッシュするには、ツールリストの最後のツールに cache_control フィールドを追加する必要があります。元のツールスキーマを変更せずにこれを行う適切な方法は次のとおりです。
if tools:
tools_clone = tools.copy()
last_tool = tools_clone[-1].copy()
last_tool["cache_control"] = {"type": "ephemeral"}
tools_clone[-1] = last_tool
params["tools"] = tools_cloneこのアプローチでは、キャッシュ制御フィールドを追加する前に、ツールリストと最後のツールスキーマの両方のコピーを作成します。これにより、元のツール定義を誤って変更してしまうことを防ぎます。後でツールの順序を変更した場合に問題が発生する可能性があるためです。
システムプロンプトのキャッシュ
システムプロンプトについては、system パラメータを、キャッシュ制御フィールドを含むテキストブロックのリストとして構成する必要があります。
if system:
params["system"] = [
{
"type": "text",
"text": system,
"cache_control": {"type": "ephemeral"}
}
]キャッシュの動作を理解する
キャッシュ可能なコンテンツを含む最初のリクエストを行うと、usage フィールドに cache_creation_input_tokens が表示されます。これは、Claudeがキャッシュに書き込んだトークン数を示しています。同一のコンテンツを含む後続のリクエストでは、代わりに cache_read_input_tokens が表示されます。
同じリクエスト内にキャッシュされたコンテンツと新しいコンテンツの両方がある場合、キャッシュの読み取りと書き込みの両方が表示されることがあります。例えば、同じツールスキーマを維持しながらシステムプロンプトを変更した場合、ツールはキャッシュから読み取られる一方で、新しいシステムプロンプトはキャッシュに書き込まれます。この部分的な読み取りが発生するのは、ツール単独が最小長に達している場合のみです。なぜなら、そこまでのコンテンツが最小長に満たないキャッシュブレークポイントは何も書き込まないためです。
キャッシュの無効化
キャッシュは変更に対して非常に敏感です。ツールスキーマの説明、システムプロンプト、またはキャッシュされたコンテンツの1文字でも変更すると、そのキャッシュエントリは無効になります。これが発生すると、Claudeはそれを完全に新しいコンテンツとして扱い、新しいキャッシュエントリを作成します。
この敏感さは、何をキャッシュするかを慎重に検討すべきであることを意味します。多くのリクエストにわたって安定したままのツールスキーマやシステムプロンプトは、理想的な候補です。頻繁に変化する動的なコンテンツは、キャッシュの恩恵を受けられません。
実践的な実装
実際には、デフォルトでチャット機能にキャッシュを組み込むことが望ましいでしょう。ほとんどのアプリケーションは、複数のリクエストにわたって同じツールスキーマとシステムプロンプトを使用するため、キャッシュに最適です。類似したコンテンツで多数のリクエストを行う場合、パフォーマンスとコストの両面で大きなメリットがあります。
キャッシュは、同じコンテンツを繰り返し送信する場合に最も価値を発揮することを覚えておいてください。実際のアプリケーション、特にツールスキーマやシステムプロンプトでは、これが非常に頻繁に発生するため、開発プロセスの早い段階でキャッシュを実装しておくことで、アプリケーションの規模が拡大するにつれてその効果が報われることになります。