> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Автоматическое кэширование Claude без меток cache_control

> RuAPI автоматически ставит метки cache_control в запросы к Claude, где клиент их не поставил, и повторный контекст в продолжающемся диалоге оплачивается по цене кэша. 18–20.11.2026 в запросах, где метки поставил RuAPI, около 90% входных токенов читалось из кэша.

Автокэш RuAPI сам ставит метки `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 минут. Цены — по [странице цен](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=ru-claude-auto-cache) на 20.11.2026; цена в вашем аккаунте может быть ниже.

| | Стоимость ввода за 30 ходов |
| - | - |
| Без кэша (ввод \$2,40 за 1 млн токенов) | около \$4,30 |
| С автокэшем (чтение \$0,12, запись \$3,00 за 1 млн токенов; первый ход по полной цене) | около \$0,55 |

У Sonnet 5.5 чтение из кэша в 20 раз дешевле обычного ввода; запись на 25% дороже обычного ввода, но окупается первым же чтением на следующем ходу. У Opus 5.5 и Fable 5.2 чтение из кэша стоит \$0,24 за 1 млн токенов — в 20 и в 40 раз дешевле обычного ввода соответственно.

## Почему в OpenAI-совместимом формате кэша часто нет

* Собственный OpenAI-совместимый слой Anthropic кэширование промптов не поддерживает ([документация Anthropic](https://docs.anthropic.com/en/api/openai-sdk), проверено 15.10.2026).
* Многие инструменты для программирования и самописные агенты с провайдером «OpenAI Compatible» не отправляют `cache_control`. Для Cline мы проверили это по исходному коду (16.10.2026). Без меток кэш не работает, даже если шлюз его поддерживает.
* Наши данные это подтверждают: за 30 дней до запуска автокэша 4 ноября 2026 года ни один запрос к Claude в OpenAI-формате не прочитал ничего из кэша.

## Как RuAPI ставит метки кэша автоматически

Если клиент не поставил ни одной метки, RuAPI ставит за вас не больше двух меток с кэшем на 5 минут:

1. **Системный промпт (вместе с описаниями инструментов)** — если точно такие же уже приходили с тем же ключом к той же модели за последние 5 минут. Так системный промпт может читаться из кэша даже на первом ходу нового диалога и в сериях одиночных запросов (например, при пакетной обработке).
2. **Последнее сообщение пользователя или результат инструмента** — если диалог продолжается и прошлый ход был, как правило, не больше 5 минут назад. Тогда в кэш попадает вся история.

Если запись в кэш три раза подряд не окупилась, автокэш ставится на паузу — обычно на 1 час и только для этого диалога или этого системного промпта. Кроме того, на ключ и модель действуют два общих ограничения: по сумме переплаты за запись и по изменениям ранней части переписки. Если клиент поставил метки сам, работают его метки; RuAPI добавляет одну метку в конце, только если клиент поставил 1–2 метки далеко от конца переписки, после них остаётся большой кусок без кэша и диалог продолжается в пределах 5 минут.

Работает в обоих форматах: OpenAI-совместимом (`/v1/chat/completions`) и нативном (`/v1/messages`). Все правила — в разделе [Кэширование промптов](https://docs.ruapi.ai/ru/prompt-caching.md#автокэш-ruapi).

## Сколько экономит автокэш на деле

С вечера 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 — выбирайте его**: в нативном формате кэшем управляет сам инструмент, это надёжнее всего.

Примеры кода — в разделе [Кэширование промптов](https://docs.ruapi.ai/ru/prompt-caching.md).

## Чем это отличается от OpenRouter

Согласно документации OpenRouter, для кэша Claude метки `cache_control` должен ставить клиент: одну метку на верхнем уровне запроса (работает у перечисленных в документации провайдеров Claude) или до четырёх меток в блоках содержимого. О том, что OpenRouter ставит метки сам, если клиент их не поставил, в документации не сказано.

| | RuAPI | OpenRouter |
| - | - | - |
| Доступ из России без VPN | Да | Нет: без VPN — ошибка 403 (наша проверка 09.11.2026) |
| Запрос без меток от клиента | Метки ставятся автоматически, оплата по цене кэша | Метки должен ставить клиент (об автоматической расстановке в документации не сказано) |
| Клиент поставил метки сам | Работают метки клиента; если они далеко от конца, добавляется одна | Работают метки клиента |

Сведения об OpenRouter — по его [официальной документации](https://openrouter.ai/docs/features/prompt-caching) (проверено 20.11.2026).

## Частые вопросы

> [accordion] Нужно ли включать автокэш?
>
> Нет, автокэш работает для всех ключей.

> [accordion] Не выйдет ли с автокэшем дороже?
>
> Запись в кэш на 25% дороже обычного ввода, поэтому RuAPI ставит метку, только когда кэш, скорее всего, будет прочитан. Если записи раз за разом не окупаются, автокэш сам ставится на паузу.

> [accordion] Нужен ли автокэш для GPT и DeepSeek?
>
> Нет. У них кэш срабатывает сам: если начало запроса достаточно длинное и совпадает с прошлым запросом, оно обычно берётся из кэша.

> [accordion] Влияет ли автокэш на Claude Code?
>
> Нет. Claude Code сам ставит метку на последнее сообщение, и RuAPI ничего не добавляет.

> [accordion] Почему автокэш не сработал?
>
> Частые причины:
>
> * больше 5 минут не было запросов, и кэш истёк;
> * это первый ход нового диалога: из кэша читаются только системный промпт и инструменты, если такие же приходили за последние 5 минут;
> * клиент каждый ход меняет начало переписки — например, добавляет в системный промпт текущее время;
> * записи несколько раз подряд не окупились, и автокэш на паузе;
> * запрос слишком короткий: меньше минимальной длины кэша для этой модели.

## Дальше

* [Кэширование промптов](https://docs.ruapi.ai/ru/prompt-caching.md): все правила и примеры кода.
* [Как платить за Claude Code и Cline в разы меньше](https://docs.ruapi.ai/ru/claude-code-cline-costs.md): что сбрасывает кэш.
* [Формат OpenAI или Anthropic](https://docs.ruapi.ai/ru/openai-vs-anthropic-format.md): чем отличаются два формата.
* [Цены](https://docs.ruapi.ai/ru/pricing.md): цены ввода, вывода и кэша для каждой модели.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.