Anthropic описала, как в Claude Code работает prompt caching. Без кэша API переобрабатывал бы всю историю на каждом шаге: системный промпт, контекст проекта, все прошлые сообщения и результаты вызовов. Кэш переиспользует уже обработанный префикс и считает заново только изменения.
Матч идёт по точному совпадению начала запроса. Claude Code сортирует контент по слоям: системный промпт и инструменты, затем контекст проекта (CLAUDE.md, память), затем сам диалог. Изменение в раннем слое сбрасывает всё, что идёт после.
Кэш инвалидируют смена модели, смена effort level, включение fast mode, подключение MCP-сервера в prefix, компакт и апгрейд Claude Code. TTL по умолчанию пять минут, на подписке запрашивается часовой. Включить его на API-ключе можно через ENABLE_PROMPT_CACHING_1H=1.