cache_control в запросы к Claude, где клиент их не поставил, поэтому, если между ходами меньше 5 минут, повторно отправленный контекст оплачивается по цене чтения из кэша — у Claude Sonnet 5.5 это в 20 раз дешевле обычного ввода. Настраивать ничего не нужно. Не путайте его с «автоматическим кэшированием» Anthropic: там клиент сам ставит одну метку cache_control на верхнем уровне запроса, а автокэш RuAPI в основном срабатывает, когда клиент не поставил ни одной метки.
Зачем это нужно: кэширование промптов у Claude включает клиент — Anthropic считает повторно отправленный контекст по цене кэша, только если в запросе стоит метка cache_control. Claude Code и многие другие инструменты, работающие в нативном формате Anthropic, ставят метки сами. А инструменты, которые вызывают Claude в OpenAI-совместимом формате, часто меток не ставят — и тогда с каждым новым ходом вся история диалога заново оплачивается по полной цене.
Сколько стоит диалог с Claude с кэшем и без
Инструмент для программирования на каждом ходу заново отправляет весь диалог: системный промпт, содержимое файлов, прошлые ответы и результаты инструментов. Чем длиннее диалог, тем больше входных токенов на каждом ходу. Грубый расчёт: диалог на 30 ходов с Claude Sonnet 5.5, контекст постепенно растёт с 20 тыс. до 100 тыс. токенов, между ходами меньше 5 минут. Цены — по странице цен на 20.11.2026; цена в вашем аккаунте может быть ниже.
У Sonnet 5.5 чтение из кэша в 20 раз дешевле обычного ввода; запись на 25% дороже обычного ввода, но окупается первым же чтением на следующем ходу. У Opus 5.5 и Fable 5.2 чтение из кэша стоит $0,24 за 1 млн токенов — в 20 и в 40 раз дешевле обычного ввода соответственно.
Почему в OpenAI-совместимом формате кэша часто нет
- Собственный OpenAI-совместимый слой Anthropic кэширование промптов не поддерживает (документация Anthropic, проверено 15.10.2026).
- Многие инструменты для программирования и самописные агенты с провайдером «OpenAI Compatible» не отправляют
cache_control. Для Cline мы проверили это по исходному коду (16.10.2026). Без меток кэш не работает, даже если шлюз его поддерживает. - Наши данные это подтверждают: за 30 дней до запуска автокэша 4 ноября 2026 года ни один запрос к Claude в OpenAI-формате не прочитал ничего из кэша.
Как RuAPI ставит метки кэша автоматически
Если клиент не поставил ни одной метки, RuAPI ставит за вас не больше двух меток с кэшем на 5 минут:- Системный промпт (вместе с описаниями инструментов) — если точно такие же уже приходили с тем же ключом к той же модели за последние 5 минут. Так системный промпт может читаться из кэша даже на первом ходу нового диалога и в сериях одиночных запросов (например, при пакетной обработке).
- Последнее сообщение пользователя или результат инструмента — если диалог продолжается и прошлый ход был, как правило, не больше 5 минут назад. Тогда в кэш попадает вся история.
/v1/chat/completions) и нативном (/v1/messages). Все правила — в разделе Кэширование промптов.
Сколько экономит автокэш на деле
С вечера 18.11.2026, когда вышла новая версия автокэша, до утра 20.11.2026:- в запросах к Claude, где метки поставил RuAPI, около 90% входных токенов прочитано из кэша. Это доля токенов: запись в кэш на 25% дороже ввода, поэтому в деньгах доля экономии немного ниже. Запросы, где RuAPI меток не ставил (например, ход после долгого перерыва), в эту цифру не входят;
- чем длиннее диалог и чем реже перерывы больше 5 минут, тем больше экономия.
Где посмотреть свою экономию
- Главная страница консоли: как только за последние 7 дней накопится экономия, на главной появится карточка «Кэш сэкономил вам» с суммой за сегодня и за последние 7 дней (данные обновляются примерно каждые 5 минут).
- Журнал запросов: откройте запись — строка «Экономия на кэше» показывает, на сколько этот запрос обошёлся дешевле, чем без кэша (она есть, только если экономия действительно была); «Токены из кэша» — сколько прочитано из кэша.
- Ответ API: в OpenAI-формате —
usage.prompt_tokens_details.cached_tokens, в формате Anthropic —usage.cache_read_input_tokens.
Когда всё же лучше ставить метки самому
- Между ходами часто большие перерывы: поставьте метки сами и используйте кэш на час (
"ttl": "1h", запись вдвое дороже обычного ввода). - Свой код: в OpenAI-совместимом формате достаточно одной метки
cache_controlна верхнем уровне запроса — RuAPI, как и нативный API Anthropic, перенесёт её на последнее сообщение. - Если инструмент позволяет выбрать провайдер Anthropic — выбирайте его: в нативном формате кэшем управляет сам инструмент, это надёжнее всего.
Чем это отличается от OpenRouter
Согласно документации OpenRouter, для кэша Claude меткиcache_control должен ставить клиент: одну метку на верхнем уровне запроса (работает у перечисленных в документации провайдеров Claude) или до четырёх меток в блоках содержимого. О том, что OpenRouter ставит метки сам, если клиент их не поставил, в документации не сказано.
Сведения об OpenRouter — по его официальной документации (проверено 20.11.2026).
Частые вопросы
Нужно ли включать автокэш?
Нужно ли включать автокэш?
Нет, автокэш работает для всех ключей.
Не выйдет ли с автокэшем дороже?
Не выйдет ли с автокэшем дороже?
Запись в кэш на 25% дороже обычного ввода, поэтому RuAPI ставит метку, только когда кэш, скорее всего, будет прочитан. Если записи раз за разом не окупаются, автокэш сам ставится на паузу.
Нужен ли автокэш для GPT и DeepSeek?
Нужен ли автокэш для GPT и DeepSeek?
Нет. У них кэш срабатывает сам: если начало запроса достаточно длинное и совпадает с прошлым запросом, оно обычно берётся из кэша.
Влияет ли автокэш на Claude Code?
Влияет ли автокэш на Claude Code?
Нет. Claude Code сам ставит метку на последнее сообщение, и RuAPI ничего не добавляет.
Почему автокэш не сработал?
Почему автокэш не сработал?
Частые причины:
- больше 5 минут не было запросов, и кэш истёк;
- это первый ход нового диалога: из кэша читаются только системный промпт и инструменты, если такие же приходили за последние 5 минут;
- клиент каждый ход меняет начало переписки — например, добавляет в системный промпт текущее время;
- записи несколько раз подряд не окупились, и автокэш на паузе;
- запрос слишком короткий: меньше минимальной длины кэша для этой модели.
Дальше
- Кэширование промптов: все правила и примеры кода.
- Как платить за Claude Code и Cline в разы меньше: что сбрасывает кэш.
- Формат OpenAI или Anthropic: чем отличаются два формата.
- Цены: цены ввода, вывода и кэша для каждой модели.