1 を設定すると、既定の 5 分ではなく 1 時間のプロンプトキャッシュ TTL を要求する。API キー、Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry、Claude Platform on AWS の利用者を対象としている。提供利用枠内のサブスクリプション利用者には、メイン会話について Claude Code が 1 時間 TTL を自動的に要求する。利用クレジットを消費するサブスクリプション利用者は、この変数を設定することで 1 時間 TTL を維持できる。1 時間キャッシュの書き込みはより高いレートで課金される。メイン会話とそれ以外のリクエストに対して TTL を別々に選ぶには、この変数より優先される CLAUDE_CODE_PROMPT_CACHE_TTL と CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL を使用する。
Set to 1 to request a 1-hour prompt cache TTL instead of the default 5 minutes. Intended for API key, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, and Claude Platform on AWS users. For subscription users within included usage, Claude Code requests the 1-hour TTL automatically on the main conversation. Subscription users drawing on usage credits can set it to keep the 1-hour TTL. 1-hour cache writes are billed at a higher rate. To choose the TTL separately for the main conversation and for requests outside it, use CLAUDE_CODE_PROMPT_CACHE_TTL and CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, which take precedence over this variable
ENABLE_PROMPT_CACHING_1H が設定されている場合に Amazon Bedrock と Google Vertex AI で発生していた 400 エラーを修正しましたENABLE_PROMPT_CACHING_1H is set変更後
サードパーティプロバイダーを通じた利用でも、プロンプトキャッシュによるコスト削減と高速化の恩恵を安定して受けられるようになります。
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コストの削減とレスポンスの高速化が期待できます。