Cache Tax — плагин
Мод для Claude Code греет кэш промпта в перерыве и показывает цену перезаписи, пока вы не отправили сообщение в остывшую сессию
- 384 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Каждый запрос прогрева тратит токены вашей подписки или ключа API, а вывод модели в нем не ограничен
- Мод видит каждый введенный запрос и ответы модели с числом токенов, текст промпта при этом не сохраняется и не пишется в журнал
- Хранит в локальном хранилище Claude Code срок окна прогрева и режим защиты для сессий
Установка
- Работает в
Ручная установка
claude plugin marketplace add karanb192/claude-code-modsНужен Claude Code 2.1.287 или новее, моды включены по умолчанию.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Каждый запрос прогрева тратит токены вашей подписки или ключа API, а вывод модели в нем не ограничен
- Мод видит каждый введенный запрос и ответы модели с числом токенов, текст промпта при этом не сохраняется и не пишется в журнал
- Хранит в локальном хранилище Claude Code срок окна прогрева и режим защиты для сессий
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Cache Tax решает проблему холодного кэша. Когда он устаревает, даже короткая просьба вроде «дай краткое резюме» заставляет Claude Code заново записать весь прежний контекст, и счет растет. Мод делает две вещи: греет кэш в перерыве и останавливает отправку в остывшую сессию, пока вы не увидите цену. Команда `/keepwarm` включает окно прогрева на шесть часов, `/keepwarm 90m` задает свою длину, `/keepwarm off` выключает. После 50 минут простоя таймер внутри Claude Code отправляет один запрос без инструментов поверх записи сессии. Мод читает расход после каждого такого запроса и останавливается, если чтений ноль или записи достигли 10 процентов от чтений. Когда вы возвращаетесь, а кэш уже остыл и контекст не меньше 50 000 токенов, защита один раз отбрасывает ваше сообщение и показывает оценку перезаписи. Повторная отправка проходит, после обнаруженной холодной записи прогрев включается минимум на три часа. Команда `/cache-tax` показывает карточку с оценкой кэша, окном прогрева и счетчиком холодных записей сессии. Пока прогрев включен, над строкой ввода виден куб: зеленый для теплого кэша, оранжевый для холодного, серый до первого хода.
Для кого. Для тех, кто часто отходит от долгой сессии Claude Code и не хочет платить за внезапную перезапись большого контекста после возвращения.
Подходит, если
- Вы уходите на обед или встречу, а в сессии накоплен контекст на сотни тысяч токенов, и хотите вернуться в теплый кэш
- Перед отправкой нужно знать цену: мод показывает оценку перезаписи, а при желании предлагает начать заново через `/clear` с заметкой
- Вы работаете по подписке с часовым кэшем и хотите, чтобы окно прогрева закрывало перерывы до шести часов
- Нужно узнать, сколько холодных записей уже случилось в сессии, командой `/cache-tax`
- Вы предпочитаете хуки в настройках: есть отдельная версия на хуках с предупреждением и режимом отказа через `CACHE_TAX_BLOCK=1`
Не подходит, если
- Вы не уходите надолго: прогрев тратит токены, и окно стоит выбирать по тому, когда вы вернетесь
- Версия Claude Code ниже 2.1.287: моды там недоступны
- Сессия идет через ключ API, кредиты или облачного поставщика с кэшем на пять минут и вы не задали `promptCacheTtl` равным `"1h"`: расписание в 50 минут рассчитано на часовой кэш
- Claude Code не остается запущенным во время перерыва: таймер работает внутри процесса
Пример запроса к агенту
Я ухожу на полтора часа: включи прогрев кэша на 90 минут и покажи, сколько будет стоить возвращение, если кэш остынетОграничения
- Моды требуют Claude Code 2.1.287 или новее, локальные настройки, безопасный режим или политика организации могут помешать загрузке.
- Расписание в 50 минут рассчитано на основной кэш в один час. Подписка дает его по умолчанию, а для ключа API, кредитов и облака нужен `promptCacheTtl` равный `"1h"`.
- Ответ на запрос прогрева тоже стоит токенов, а выходные токены не ограничены.
- Сумма в отказе — верхняя оценка: число токенов взято из последнего ответа вместе с его выводом.
- Хук и мод с одним именем нельзя держать вместе, иначе каждое холодное сообщение проверяют две защиты.
- Кэш может сброситься из-за смены префикса независимо от времени.
Как отключить. Команда `/keepwarm off` останавливает прогрев и сбрасывает окно. Саму защиту отключает `claude plugin uninstall cache-tax@claude-code-mods`, а выключатель всех модов описан в разделе Mod controls документации Claude Code.
Частые вопросы
Как поставить Cache Tax в Claude Code?
Выполните `claude plugin marketplace add karanb192/claude-code-mods`, затем `claude plugin install cache-tax@claude-code-mods`. Перезапустите Claude Code или запустите /reload-plugins. Нужен Claude Code 2.1.287 или новее, флаг раннего доступа не требуется.
Сколько стоит поддержание кэша командой keepwarm?
Каждый запрос прогрева оплачивает чтение кэша, несколько некэшированных токенов и ответ модели по цене вывода. В записанном прогоне статус показал 75 тысяч токенов, прочитанных за 0,02 доллара. Мод останавливается, если чтений нет или записи достигли десятой части чтений.
Почему после перерыва короткая просьба оказалась дорогой?
Когда кэш истек, даже просьба о резюме заставляет перезаписать прежний контекст. В записанном отказе двухстрочное резюме в сессии на 330 тысяч токенов получило оценку 6,61 доллара, после повторной отправки фактическая запись стоила 6,28.
Что делает защита при возвращении в остывшую сессию?
Если контекст не меньше 50 000 токенов и часовые часы кэша показывают остывание, защита один раз отбрасывает обычное сообщение и показывает оценку перезаписи. Чтобы продолжить, отправьте сообщение повторно или выполните /clear и начните с заметки.
Чем мод отличается от версии на хуках?
Версия на хуках по умолчанию предупреждает, при `CACHE_TAX_BLOCK=1` один раз отказывает и дает счетчик в строке состояния. Прогрев входит только в мод. Держать обе версии сразу не стоит: холодное сообщение проверят две защиты.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныНавык Claude Code держит кэш промпта теплым в простое, чтобы возврат в сессию читался по цене кэша.
Плагин для Claude Code сам выбирает уровень усилий модели на каждый запрос и показывает остаток времени кэша промпта
Плагин Claude Code рисует над строкой ввода остаток лимитов на 7 дней и 5 часов и состояние кэша промпта
Четыре мода для Claude Code: цена кеша, маскировка при записи экрана, шкала /goal и защита от конфликта правок
Строка состояния Claude Code с остатком лимитов за 5 часов и неделю, отсчетом до сброса, моделью и сроком жизни кэша
claudetop выводит в строке состояния Claude Code стоимость сессии, кэш, окна лимитов тарифа и предупреждения о перерасходе
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Cache Tax (эта карточка) | нет | 384 | |
| ccusage | нет | 19 415 | отчеты по токенам и стоимости из локальных логов, кэш не греет и отправку не останавливает |
| Claude Code Karma | нет | 339 | локальная панель по сессиям Claude Code с расходом токенов, без прогрева и защиты от холодной отправки |
Коротко о README
Страница показывает запись отказа с оценкой в 6,61 доллара и ведет через установку, принцип работы, цену прогрева и команды. Затем описаны строка состояния с кубом, что мод может затронуть в Claude Code, модель угроз, ограничения и способ проверить прогрев на своей сессии.