{"name":"promptCacheTtl","slug":"promptcachettl","family":"setting","title":"Settings keys","noun":"settings key","description":"Choose the [prompt cache lifetime](\/docs\/en\/prompt-caching.md#cache-lifetime) for the main conversation","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.242","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.309","builds":33,"mined_builds":150,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.248","anchor":"agents-can-set-their-own-prompt-cache-lifetime-in-frontmatte","heading":"Agents can set their own prompt cache lifetime in frontmatter","line":"An agent file can set its own prompt cache lifetime under experimental cacheTtl.","released_at":"2026-08-27 20:35:36","reason":"found in this entry's text"},{"version":"2.1.242","anchor":"prompt-cache-lifetime-is-now-configurable","heading":"Prompt cache lifetime is now configurable","line":"You can pin the prompt cache to five minutes or an hour, separately for subagents.","released_at":"2026-08-24 19:16:14","reason":"named in this entry, found in this entry's text"}],"entries_total":2,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"agent-sdk\/cost-tracking","title":"Track cost and usage","documented":false},{"source":"claude-code","path":"agent-teams","title":"Orchestrate teams of Claude Code sessions","documented":false},{"source":"claude-code","path":"claude-apps-gateway-config","title":"Claude apps gateway configuration","documented":false},{"source":"claude-code","path":"plugins\/mods\/api","title":"Use the mods API","documented":false},{"source":"claude-code","path":"prompt-caching","title":"How Claude Code uses prompt caching","documented":false},{"source":"claude-code","path":"whats-new\/2026-w35","title":"Week 35 \u00b7 August 24\u201328, 2026","documented":false},{"source":"claude-code","path":"workflows","title":"Orchestrate subagents at scale with dynamic workflows","documented":false}],"docs_total":8,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/promptcachettl","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}