promptCacheTtl

settings.json型string記述場所どの設定ファイルでも可

プロンプトキャッシュがメインの会話を保持する期間を選択する。このキーは、対話セッション、-p、Agent SDK のターン、およびそれらとインラインで実行されるヘルパーに適用される。1 時間のライフタイムはより長い空白の間もキャッシュを温かく保ち、その代わりに API は 5 分のライフタイムより高いレートで各キャッシュ書き込みを課金する。Claude Code v2.1.242 以降が必要。

既定値未設定の場合、メイン会話の各リクエストは既定のライフタイムを用いる。

取りうる値

5mキャッシュは 5 分間保持される。
1hキャッシュは 1 時間保持される。

記述例

{
  "promptCacheTtl": "1h",
  "subagentPromptCacheTtl": "5m"
}

使い方・用途

  • API キー利用で 1 時間のプロンプトキャッシュを使いたいが、サブエージェントは 5 分 TTL のままにしたい場合に、メイン会話の TTL を個別に指定するために使う
  • 長めの作業休止を挟んでもキャッシュを温存して再読ヒットを増やしたいが、キャッシュ書き込みが高料金になることと引き換えにすることを自分で選びたい場合に使う
  • ENABLE_PROMPT_CACHING_1H による全体一括指定ではなく、メイン会話とそれ以外のバケットで別々の TTL を選びたい場合に使う
英語原文

Choose how long the prompt cache holds the main conversation. This key applies to your interactive, -p, and Agent SDK turns, together with the helpers Claude Code runs inline with them. The one-hour lifetime keeps the cache warm across longer breaks, and the API bills each cache write at a higher rate than at the five-minute lifetime. Requires Claude Code v2.1.242 or later.

関連ドキュメント

関連する変更履歴

v2.1.243(1件)

promptCacheTtl と subagentPromptCacheTtl 設定を追加した。API キーやクラウドプロバイダーのユーザーは、メインの会話で 1 時間のプロンプトキャッシュを維持しつつ、サブエージェントは 5 分のままにできる。
英語原文を表示
Added promptCacheTtl and subagentPromptCacheTtl settings so API-key and cloud-provider users can keep a 1-hour prompt cache on the main conversation while subagents stay at 5 minutes

変更後

API キーやクラウドプロバイダーを利用している場合でも、メインの会話では 1 時間のプロンプトキャッシュを選択できるようになり、5 分以上間隔を空けたセッションでもキャッシュが失効せず、入力コストの増加を抑えられる。サブエージェント側は 5 分のままにできるため、書き込みコストが高い 1 時間 TTL を必要な範囲だけに絞り込める。

関連ドキュメント