subagentPromptCacheTtl

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

プロンプトキャッシュが、メイン会話の外で Claude Code が実行するリクエストを保持する期間を選択する。このキーは、サブエージェント、ワークフロー、およびコンパクションやセッションタイトルなど Claude Code 自身のバックグラウンド・ヘルパーリクエストに適用される。1 時間のライフタイムはより長い空白の間もキャッシュを温かく保ち、その代わりに API は 5 分のライフタイムより高いレートで各キャッシュ書き込みを課金する。Claude Code v2.1.242 以降が必要。

既定値未設定の場合、これらのリクエストのそれぞれは既定のライフタイムを用いる。

取りうる値

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

記述例

{
  "subagentPromptCacheTtl": "1h"
}

使い方・用途

  • サブエージェントやワークフロー、コンパクション・セッションタイトル生成などの会話外のリクエストで、5分より長くプロンプトキャッシュを維持したい場合に subagentPromptCacheTtl を 1h に設定する
  • 長めの作業中断の後でもサブエージェントのキャッシュを温めたまま保ち、再実行時のキャッシュミスを避けたい場合に使う
  • メイン会話を1時間キャッシュにしつつサブエージェントは5分のまま課金を抑えたい、といった TTL の使い分けをしたい場合に設定する
英語原文

Choose how long the prompt cache holds the requests Claude Code makes outside the main conversation. This key applies to subagents, workflows, and Claude Code's own background and helper requests, such as compaction and session titles. 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 を必要な範囲だけに絞り込める。

関連ドキュメント