環境変数
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL
サブエージェント、ワークフロー、バックグラウンド作業など、メイン会話以外のリクエストのプロンプトキャッシュ有効期間を設定します。5分または1時間のみを受け付けます。
使い方・用途
- サブエージェントやワークフローでのキャッシュ効率を最適化する場合に「1h」を設定する
- 課金を抑えたい場合や、頻繁に実行されないバックグラウンド処理には「5m」を設定する
- FORCE_PROMPT_CACHING_5Mが優先されるため、そちらが優先度順位の最上位であることを理解する
英語原文(公式ドキュメントより)
Set 5m or 1h, the only values Claude Code accepts, to choose the prompt cache TTL for requests outside the main conversation, such as subagents, workflows, and background work. Takes precedence over the subagentPromptCacheTtl setting and over ENABLE_PROMPT_CACHING_1H, and FORCE_PROMPT_CACHING_5M overrides it. The API bills 1-hour cache writes at a higher rate. Requires Claude Code v2.1.242 or later