Разбор стоимости · по состоянию на 2026-11-20

Стоимость кэширования промптов в Claude Code: 5 минут или 1 час зависит от способа оплаты

По состоянию на 20 ноября 2026 года ответ зависит от способа тарификации: подписка Claude в рамках включённого в тариф использования запрашивает кэш на 1 час, а API-ключи, кредиты использования и облачные провайдеры по умолчанию получают 5 минут. На пути с API-ключом можно перевести основной диалог на час, задав promptCacheTtl в значение 1h (Claude Code v2.1.242 или новее), и официальные множители Anthropic по-прежнему действуют: запись в кэш на 5 минут стоит 1.25x цены ввода, запись на 1 час — 2x, а чтение кэша — 0.1x на большинстве моделей.

Обновлено 2026-11-20

Цены меняются: в QCode Claude, GPT и китайские модели оплачиваются по токенам, актуальные цены — на /models.

#5 минут vs 1 час#чтение кэша 0.1x#запись в кэш 1.25x / 2x#promptCacheTtl=1h

Четыре числа, которые стоит запомнить

5 минут

Стандартное время жизни кэша на пути с API-ключом

API-ключи, кредиты использования и облачные провайдеры получают 5 минут на каждый запрос; подписка получает 1 час только в рамках включённого в тариф использования, и основной диалог возвращается к 5 минутам, как только вы выходите за пределы тарифа и переходите на кредиты использования.

1.25x

Запись в кэш на 5 минут: 1.25x цены ввода

Запись в кэш стоит дороже, чем отправка тех же токенов как обычного ввода, но последующие попадания тарифицируются по ставке чтения кэша; на странице цен Anthropic запись на 5 минут указана как 1.25x базовой цены ввода, а запись действительна 5 минут.

2x

Запись в кэш на 1 час: 2x цены ввода

Запись на 1 час тарифицируется как 2x базового ввода и сохраняет запись тёплой в течение часа. Это подходит для сессий, где вы отходите на несколько минут или на час, а при коротких всплесках, которые никогда не простаивают дольше 5 минут, надбавка не используется.

0.025x

Чтение кэша Fable 5.2 стоит всего 0.025x

Fable 5.2, Mythos 5.2, Fable 5.1 и Mythos 5.1 тарифицируют попадания по 0.025x цены ввода, что даёт для Fable 5.2 $0.20 за миллион токенов; Opus 5.5 и Sonnet 5.5 находятся на 0.05x, а все остальные модели — на 0.1x.

Какие запросы получают 5 минут, а какие — час

По состоянию на 20 ноября 2026 года документация делит каждый запрос на две категории: основной диалог (интерактивные ходы, неинтерактивные запуски с -p, ходы Agent SDK, а также вспомогательные запросы, которые Claude Code выполняет внутри) и всё остальное (субагенты, workflows, внутрипроцессные teammates, форки, компакция, заголовки сессий).

Claude Code выбирает TTL для каждого запроса: если вы не задали его сами, час запрашивается только для подписки Claude в пределах лимита тарифа, тогда как API-ключи, кредиты за использование и облачные провайдеры получают 5 минут для основного диалога. На подписке остальное по-прежнему получает 5 минут, за исключением небольшого набора вспомогательных запросов, которые Anthropic контролирует на стороне сервера, — им достаётся час; на API-ключах, кредитах за использование или облачных провайдерах обе категории получают 5 минут.

Официальная формулировка: Unless you choose a TTL yourself, Claude Code requests the one-hour TTL only on a Claude subscription within your plan's included usage. Именно здесь и возникает путаница в сообществе, и один разработчик написал на форуме: I still don't understand if cache lasts for 5 minutes or one hour.

Что изменилось: управление TTL, панель кэша и те же надбавки за запись

Три вещи в документации по состоянию на 20 ноября 2026 года напрямую влияют на итоговую сумму.

  1. 1TTL можно выбрать самостоятельно: promptCacheTtl или CLAUDE_CODE_PROMPT_CACHE_TTL охватывают основной диалог, subagentPromptCacheTtl или CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL — всё остальное, и все четыре параметра требуют Claude Code v2.1.242 или новее; FORCE_PROMPT_CACHING_5M=1 имеет приоритет над всеми ними, затем идёт переменная окружения соответствующей категории, а затем настройка этой категории.
  2. 2Состояние кэша видно: начиная с v2.1.251 блок Session в /usage добавляет строку Prompt cache (main) с долей попаданий, числом промахов, признаком того, тёплый ли кэш, и действующим TTL; с v2.1.260 он также называет вероятную причину последнего промаха, например изменение определений инструментов.
  3. 3Множители не изменились: 1.25x за запись на 5 минут, 2x за запись на 1 час и от 0.025x до 0.1x за чтение в зависимости от модели. В обсуждениях сообщества от 2026-11-15 и 2026-11-17 один пользователь выяснил, что сломанные кэши сделали workflow дороже, а другой всё ещё спрашивал, длится ли кэш 5 минут или 1 час. Для сравнения: официальная таблица OpenAI для gpt-6.2-sol делит запись в кэш на 30m write и 12h write ($2.00 ввод, $10.00 вывод, $0.10 кэшированный ввод, $2.50 за 30m write, $5.00 за 12h write) — названия уровней, которые не совпадают с 5 минутами и 1 часом у Claude.

Три даты: два обсуждения в сообществе и одна официальная проверка

2026-11-15

Пользователь публикует разбор: сломанные кэши сделали часть workflow в Claude Code дороже. В обсуждении указывают на смену модели посреди сессии, изменение определений инструментов и первое сообщение после перерыва дольше времени жизни кэша (сообщения сообщества, а не официальный вывод; сумма здесь не приводится).

2026-11-17

В другом обсуждении разработчик пишет, что всё ещё не может понять, длится ли кэш 5 минут или 1 час. Официальная документация отвечает на это таблицей из двух строк: подписка в рамках включённого в тариф использования получает 1 час для основного диалога, а API-ключи, кредиты использования и облачные провайдеры — 5 минут.

2026-11-20

Официальные правила по состоянию на 20 ноября 2026 года: подписки в рамках включённого в тариф использования по умолчанию получают 1 час, API-ключи и облачные провайдеры — 5 минут, изменение TTL требует v2.1.242 или новее, а множители остаются 1.25x за запись на 5 минут, 2x за запись на 1 час и от 0.025x за чтение.

Подтверждённые правила тарификации против неверных толкований сообщества

Подтверждено (документ о кэшировании Claude Code и страница цен Anthropic)

Проверяемо по состоянию на 20 ноября 2026 года

  1. 1Значения по умолчанию: подписка в пределах лимита тарифа получает 1 час для основного диалога и 5 минут для всего остального, кроме вспомогательных запросов, управляемых на стороне сервера, которые получают час; API-ключи, кредиты за использование или облачные провайдеры получают 5 минут для обеих категорий.
  2. 2Множители: запись на 5 минут — 1.25x базовой цены ввода, запись на 1 час — 2x, а чтение — 0.1x на большинстве моделей.
  3. 3Цены попадания по моделям: Fable 5.2 и Mythos 5.2 — 0.025x ($0.20 за миллион токенов), Fable 5.1 и Mythos 5.1 — 0.025x ($0.25), Opus 5.5 — 0.05x ($0.20), Sonnet 5.5 — 0.05x ($0.10), все остальные модели — 0.1x.
  4. 4Цены в той же строке: Fable 5.2 — $8 за ввод и $40 за вывод при записи на 1 час $16; Opus 5.5 — $4 и $20 при записи на 1 час $8; Sonnet 5.5 — $2 и $10 при записи на 1 час $4.
  5. 5Проверка: запустите claude -p "hello" --output-format json, где ephemeral_1h_input_tokens означает запись на 1 час, а ephemeral_5m_input_tokens — запись на 5 минут.
  6. 6Время и минимумы: каждое попадание обновляет запись без дополнительных затрат, срок жизни отсчитывается от запроса, а минимальный кэшируемый промпт — 512 токенов для Fable 5.2, Mythos 5.2, Fable 5.1, Mythos 5.1, Opus 5.5, Sonnet 5.5 и Haiku 5.5.

Неверные толкования сообщества и то, что пока не опубликовано

  1. 1«С API-ключом можно получить час даром». По умолчанию нет: это делает только promptCacheTtl со значением 1h, а запросы вне основного диалога остаются на 5 минутах, пока вы не зададите TTL и для них.
  2. 2«Час всегда дешевле». Документация описывает обратное для коротких всплесков, которые никогда не простаивают дольше 5 минут: там применяется более высокая ставка записи, а более долгий срок не используется.
  3. 3«Попадание в кэш ничего не стоит». Попадания тарифицируются от 0.025x до 0.1x в зависимости от модели, ниже стандартной ставки ввода, но не по нулю.
  4. 4«Изменение effort всегда пересобирает кэш». На Fable 5.1 и новее, Opus 5.5, Sonnet 5.5 и Haiku 5.5 кэш по умолчанию остаётся целым с API-ключом или подпиской; на большинстве других моделей у каждого уровня effort свой кэш.
  5. 5«Субагент читает родительский кэш». Его первый запрос — нет, потому что префиксы различаются; форк — да, поскольку он полностью наследует родителя.
  6. 6Единого официального ответа нет: то, насколько 1 час доступен на каждой облачной платформе и в каждом шлюзе, зависит от документации этой платформы, а собственный документ Anthropic говорит лишь, что на Amazon Bedrock это зависит от модели.

Оставить стандартные 5 минут или задать 1 час для основного диалога

Стандартные 5 минут: непрерывная работа с паузами меньше 5 минут

Кэш на 5 минут обновляется без дополнительной оплаты при каждом использовании, поэтому, пока ваши запросы идут с интервалом меньше 5 минут, запись остаётся тёплой, и 1.25x за запись применяется только к новому содержимому. Это подходит для долгой правки или последовательных вызовов инструментов; если уйти больше чем на 5 минут, первое сообщение после возвращения переобработает весь контекст.

promptCacheTtl со значением 1h: отойти и вернуться

Если перевести основную беседу на 1h, запись тарифицируется по 2x и вы получаете час допуска на паузы в работе. Собственная формулировка компромисса из документации: It costs more on short bursts of work that never idle past five minutes, where the higher write rate applies and the longer cache lifetime goes unused. Иными словами, если вы часто отходите и возвращаетесь, эта надбавка покупает пропуск повторной обработки всего контекста.

Пять шагов: сначала узнать действующий TTL, затем решать, менять ли его

  1. 1Сначала узнайте реальный TTL: выполните claude -p "hello" --output-format json и проверьте usage.cache_creation, где ephemeral_1h_input_tokens отмечает запись на 1 час, а ephemeral_5m_input_tokens — запись на 5 минут. Внутри сессии /usage показывает строку Prompt cache (main) с долей попаданий, числом промахов и действующим TTL, пока кеш тёплый.
  2. 2Чтобы получить час, укажите "promptCacheTtl": "1h" в settings.json или задайте CLAUDE_CODE_PROMPT_CACHE_TTL=1h (v2.1.242 или новее); чтобы дать час обоим бакетам, задайте ENABLE_PROMPT_CACHING_1H=1. При подключении к любому шлюзу через ANTHROPIC_BASE_URL официальное примечание гласит, что часть запроса на один час передаётся в заголовке anthropic-beta, поэтому шлюз должен пересылать его без изменений; после настройки повторите шаг ① и убедитесь, что появился ephemeral_1h_input_tokens.
  3. 3При отладке принудительно верните оба бакета к 5 минутам через FORCE_PROMPT_CACHING_5M=1 и сравните, так как этот параметр приоритетнее всех остальных.
  4. 4Перестаньте пересобирать кеш: не переключайте модели, не редактируйте определения инструментов и не меняйте рабочий каталог посреди сессии, поскольку кеш фактически привязан к одной машине и каталогу; дайте субагентам более длинный TTL через subagentPromptCacheTtl и учтите, что изменение effort по умолчанию сохраняет кеш на Fable 5.1 и новее, Opus 5.5, Sonnet 5.5 и Haiku 5.5.
  5. 5С QCode задайте ANTHROPIC_BASE_URL равным https://api.qcode.cc/api и ANTHROPIC_AUTH_TOKEN равным вашему ключу cr_, затем повторите шаг ①, чтобы подтвердить TTL.

Запуск Claude Code с оплатой за токены: тарифы кеша на /models

QCode тарифицирует по токенам. В Claude Code задайте ANTHROPIC_BASE_URL как https://api.qcode.cc/api и ANTHROPIC_AUTH_TOKEN как ваш ключ cr_. Настройки TTL на стороне Claude Code описаны выше; при нестандартном ANTHROPIC_BASE_URL кэш находится там, куда перенаправляются ваши запросы, поэтому работоспособность кэширования зависит от сервиса, к которому вы подключаетесь, — после настройки запустите claude -p "hello" --output-format json и проверьте ephemeral_5m_input_tokens и ephemeral_1h_input_tokens сами.

Тарифы записи и чтения кэша перечислены по каждой модели на qcode.cc/models, и эта страница — ориентир. Не готовы к месячному тарифу? Разовые пакеты начинаются от $4 за единоразовую квоту, которую вы используете в течение 7 дней; если у вас уже есть личный тариф, добавьте бустер-пакет, когда нужно больше квоты.

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

Почему у одной и той же модели кеш живёт всего 5 минут при использовании API-ключа?

Потому что Claude Code выбирает TTL для каждого запроса и для каждого типа биллинга. В официальной таблице подписка в пределах лимита тарифа получает 1 час для основного диалога, а API-ключи, кредиты за использование или облачные провайдеры получают там 5 минут. Вне основного диалога подписка тоже получает 5 минут, за исключением небольшого набора вспомогательных запросов, которые Anthropic контролирует на стороне сервера, — им достаётся час; на API-ключах, кредитах за использование или облачных провайдерах эти запросы тоже получают 5 минут. Чтобы сохранить час на API-ключе, задайте promptCacheTtl равным 1h самостоятельно на v2.1.242 или новее, — именно это предписывает документация.

Оправдан ли кеш на 1 час?

Это зависит от паузы между запросами. Если вы используете префикс чаще, чем раз в 5 минут, оставьте кеш на 5 минут, поскольку он продолжает обновляться без дополнительной оплаты; кеш на 1 час подходит для промптов, которые используются реже, чем раз в 5 минут, но чаще, чем раз в час, например для агентного вспомогательного агента, работающего дольше 5 минут, или долгой беседы в ожидании пользователя. Надбавка в том, что записи тарифицируются по 2x от цены ввода.

Почему чтение из кеша вообще стоит денег?

Потому что сервер действительно читает этот префикс снова, просто намного дешевле обычного ввода: 0.1x на большинстве моделей, 0.05x на Opus 5.5 и Sonnet 5.5 и 0.025x на Fable 5.2, Mythos 5.2, Fable 5.1 и Mythos 5.1. Страница тарифов Anthropic приводит арифметику: при записи 1.25x на длительности 5 минут кеширование начинает окупаться после 1 чтения из кеша.

Сколько на самом деле стоит чтение из кеша Fable 5.2?

Это $0.20 за миллион токенов: Fable 5.2 указывает $8 за MTok базового ввода, а попадания тарифицируются по 0.025x, то есть $8 × 0.025 = $0.20. В той же строке запись на 1 час стоит $16 за MTok, а запись на 5 минут выходит $8 × 1.25 = $10 за MTok (пример расчёта, только по официальным ценам Anthropic, без цен QCode).

Сбрасывает ли кеш изменение уровня effort?

По умолчанию нет на Fable 5.1 и новее, Opus 5.5, Sonnet 5.5 или Haiku 5.5: документация говорит, что кеш там остаётся целым и с API-ключом, и с подпиской. На большинстве других моделей у каждого уровня effort свой кеш, поэтому изменение effort посреди сессии пересчитывает весь запрос. Документация советует выбирать модель и effort в начале сессии, а /compact оставлять для естественных пауз между задачами.

Есть ли кеш у субагентов?

Да, но отдельный. Субагент начинает собственную беседу со своим системным промптом и набором инструментов, поэтому его первый запрос не может читать родительский кеш, и он прогревает собственный кеш между своими ходами. Он находится вне бакета TTL основной беседы, поэтому получает 5 минут даже при подписке, пока вы не выберете более длительный subagentPromptCacheTtl. Родительский кеш не затрагивается; исключение — fork, который читает родительский кеш при первом запросе.

Источники

Официальная документация Claude Code по prompt caching, code.claude.com/docs/en/prompt-caching, и страница затрат, code.claude.com/docs/en/costs (проверено 2026-11-20); официальная страница цен Anthropic, platform.claude.com/docs/en/about-claude/pricing, и руководство по prompt caching, platform.claude.com/docs/en/build-with-claude/prompt-caching (проверено 2026-11-20); официальная страница цен OpenAI, developers.openai.com/api/docs/pricing (2026-11-20, использовалась только для сопоставления названий уровней кэша); qcode.cc/models (2026-11-20, ориентир для тарифов записи и чтения кэша); материалы сообщества взяты только из публичных обсуждений и помечены в тексте как сообщения пользователей. Всё вышеперечисленное проверено 2026-11-20.

Сначала настройте TTL правильно, затем переходите на ключ с оплатой за токены

Создайте аккаунт QCode для ключа cr_, задайте ANTHROPIC_BASE_URL=https://api.qcode.cc/api в Claude Code и вызывайте несколько моделей с оплатой за токены; тарифы кеша на /models.

Связанные материалы

Оплата криптовалютой

Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.

Страницы тарифов Anthropic и OpenAI, а также документация Claude Code по кешированию и затратам проверены 2026-11-20 и являются авторитетными на code.claude.com, platform.claude.com и developers.openai.com; ставки на стороне QCode следуют qcode.cc/models. QCode.cc — независимый сервис доступа к API, не связанный с Anthropic, OpenAI и другими вендорами и не имеющий их одобрения. Каждая долларовая цифра выше — официальная прейскурантная цена вендора, а примеры расчётов лишь иллюстрируют тарифные множители.

Не знаете, с чего начать?

Попробовать неделю

Пакет «Малый» — $4: квота $30 на 7 дней

Работаете каждый день

«Стартовый» — $9.00 в месяц и $5 квоты каждый день: всего $0.060 за $1 квоты, у пакета «Средний» — около $0.113