settings.json

subagentPromptCacheTtl

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

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

既定値: 未設定の場合、これらの各リクエストは既定のライフタイムを取得します。

取りうる値

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

記述例

{
  "subagentPromptCacheTtl": "1h"
}

使い方・用途

  • メイン会話の外部リクエスト(サブエージェント、ワークフロー、圧縮・セッションタイトル等のヘルパーリクエスト)のプロンプトキャッシュ有効期間を 5m / 1h から選択します。promptCacheTtl がカバーしないリクエストを担当するため、両方を設定すると Claude Code が発行する全リクエストの TTL を指定できます。
  • デフォルトは未設定(各リクエストが既定のライフタイムを使用)。エージェントチームの in-process チームメイトはデフォルトで5分のキャッシュになるため、1時間保持したい場合は 1h に設定します(1時間のキャッシュ書き込みは高レートで課金)。v2.1.242 以降が必要です。
  • 以前は API キーやクラウドプロバイダー利用時、すべてのキャッシュがデフォルトで5分で期限切れでした。
英語原文(公式ドキュメントより)

Choose how long the [prompt cache](/docs/en/prompt-caching) holds the requests Claude Code makes outside the main conversation. This key applies to [subagents](/docs/en/sub-agents), [workflows](/docs/en/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件)

Added
Settings
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 キーやクラウドプロバイダーを使用している場合、すべてのキャッシュがデフォルトで 5 分の TTL で期限切れになっていました

変更後

現在は promptCacheTtl と subagentPromptCacheTtl 設定を使用して、メイン会話とサブエージェントで異なるキャッシュ有効期間を設定できます

ユーザーへの恩恵

開発者はキャッシュの有効期間を調整することで、コストとパフォーマンスのバランスを最適化できます

関連ドキュメント