環境変数

FORCE_PROMPT_CACHING_5M

1を設定すると、本来なら1時間の TTL が適用される場合でも5分のプロンプトキャッシュ TTL を強制する。CLAUDE_CODE_PROMPT_CACHE_TTL、CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL、ENABLE_PROMPT_CACHING_1H、および promptCacheTtl と subagentPromptCacheTtl の設定より優先される。

使い方・用途

  • 1時間 TTL を他の設定や環境変数で有効にしていても、一時的に 5 分 TTL に戻したい場合に上書きとして使える。
  • キャッシュ書き込みが 1 時間 TTL より高い課金率で請求されるのを避けたい場合に、TTL を 5 分に強制できる。
  • CLAUDE_CODE_PROMPT_CACHE_TTL や promptCacheTtl など複数の TTL 関連設定が混在している環境で、この環境変数が最優先で適用されるため確実に 5 分 TTL を強制できる。
英語原文(公式ドキュメントより)

Set to 1 to force the 5-minute prompt cache TTL even when 1-hour TTL would otherwise apply. Overrides CLAUDE_CODE_PROMPT_CACHE_TTL, CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, ENABLE_PROMPT_CACHING_1H, and the promptCacheTtl and subagentPromptCacheTtl settings

関連ドキュメント

関連する変更履歴

v2.1.108(1件)

Added
APIキーやBedrock、Vertex、Foundryにおいて、プロンプトキャッシュの保持期間(TTL)を1時間に延長できる環境変数を追加
英語原文を表示
Added ENABLE_PROMPT_CACHING_1H env var to opt into 1-hour prompt cache TTL on API key, Bedrock, Vertex, and Foundry (ENABLE_PROMPT_CACHING_1H_BEDROCK is deprecated but still honored), and FORCE_PROMPT_CACHING_5M to force 5-minute TTL

変更後

キャッシュのヒット率が向上し、長時間の開発セッションにおけるAPIコストの削減とレスポンスの高速化が期待できます。

関連ドキュメント