CoreCodeДокументация

Как выжать максимум из CoreCode

Кэш и тарификация Claude Code

Обновлено:

На каждом ходу Claude Code заново отправляет системный промпт, описания инструментов и весь диалог. Если это попадает в кэш промптов, оно тарифицируется как чтение из кэша — по 2,5–10% обычной цены входа, 5% на Opus 5.5 и Sonnet 5.5. Поэтому доля попаданий в кэш во многом определяет, сколько вы тратите. Другие способы сэкономить — в разделе как тратить на Claude Code меньше.

Мало попаданий? Сначала проверьте auto modeЕсли в Claude Code включён режим разрешений auto и задана переменная CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS, перед каждым вызовом инструмента уходит дополнительный проверочный запрос, который почти никогда не попадает в кэш; в журнале использования он отображается как Non-stream. На него может уходить больше половины расходов. См. Во сколько обходится auto mode.

Как тарифицируется кэш

Кэш промптов Anthropic сопоставляется по префиксу: запрос читает кэш, только если его начало полностью совпадает с ранее закэшированным содержимым. Вход запроса тарифицируется тремя частями:

ЧастьЧто этоОтносительно цены входа
Чтение из кэшаЧасть, совпадающая с закэшированным префиксом0,05× на Opus 5.5 и Sonnet 5.5; 0,1× на Haiku 5.5; 0,025× на Fable 5.1
Запись в кэшЧасть, заново записанная в кэш. Записи на пять минут и на час стоят по-разномуОколо 1,25× на пять минут, 2× на час
ВходЧасть, не попавшая в кэш; в Claude Code обычно несколько токенов1×

Цены за единицу — на странице Цены. В обычной сессии Claude Code на каждом ходу записывается лишь несколько сотен или тысяч новых токенов, а остальные сотни тысяч читаются из кэша. Как только префикс меняется, весь контекст записывается заново по цене записи — часто это сотни тысяч токенов за раз.

Что делает CoreCode

Когда кэш ломается, зависит от того, что отправляет клиент. Случаи ниже — собственное поведение Claude Code, и они одинаковы через любой прокси и при прямом обращении к Anthropic.

Во сколько обходится auto mode

Режим разрешений auto в Claude Code сам решает, можно ли выполнить действие, вместо того чтобы каждый раз спрашивать вас. Каждое проверяемое действие всё равно требует вердикта. Начиная с v2.1.278, когда запросы идут через шлюз или прокси, Claude Code сначала просит сервер проверить действия внутри обычных запросов к модели, без дополнительного запроса. CoreCode передаёт эти запросы и результаты проверки без изменений: в тесте 30 октября 2026 г. auto mode на Opus 5.5 и Sonnet 5.5 проверялся сервером, в запросах была только основная беседа и никаких дополнительных расходов.

Если сервер не проверяет, Claude Code возвращается к старому способу: перед каждым вызовом инструмента он отправляет отдельный запрос классификатора с частью транскрипта и ожидающим действием, и модель решает, разрешить ли его. В официальной документации сказано, что при работе по API-ключам или через прокси эти запросы классификатора учитываются в расходе токенов. На CoreCode к такому откату приходят почти только сессии, где задан CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS, — он заодно отключает проверку на сервере. Установка CLAUDE_CODE_AUTO_MODE_SERVER=0 делает то же самое.

Такие проверки могут и отклоняться: проверка передаёт модели часть транскрипта и просит записать рассуждение до вердикта. На CoreCode мы неоднократно видели, как классификатор безопасности Anthropic отклоняет такие запросы как извлечение рассуждений (reasoning_extraction). Отклоняется собственная проверка Claude Code, а не что-либо написанное вами, и CoreCode не штрафует за это ваш аккаунт, но та же проверка повторно не пересылается, а повторная отправка останавливается (см. 403). Уберите CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS и дайте серверу проверять — отдельные проверки прекратятся.

Какую модель использует классификатор при откате: у Anthropic по умолчанию это Claude Sonnet 5. CoreCode предоставляет Sonnet 5.5, Opus 5.5, Haiku 5.5 и Fable 5.1, но не Sonnet 5, и по правилам Anthropic Claude Code тогда использует модель вашей сессии. Поэтому если вы работаете на Opus, каждая проверка тоже тарифицируется по ценам Opus.

Вот сколько стоят отдельные запросы классификатора при откате.

Проблема в том, что в кэш попадает только небольшая начальная часть такой проверки. Остальные десятки тысяч токенов записываются заново каждый раз, а следующая проверка не может использовать то, что записала эта. Реальный случай:

Как это заметить

Как убедиться, что auto mode включён

Что делать

  1. Уберите CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: проверьте блок env в ~/.claude/settings.json, .claude/settings.json вашего проекта и профиль оболочки и удалите её, а также любой CLAUDE_CODE_AUTO_MODE_SERVER=0. CoreCode не нужна ни та, ни другая. Начните новую сессию — auto mode будет проверяться сервером, без отдельных проверок. Подтверждение: /status показывает Auto mode server как Enabled.
  2. Выключайте auto, если не нужно оставлять работу без присмотра: нажмите Shift+Tab, чтобы перейти в режим Manual или accept-edits, и проверки прекратятся. Чтобы каждая сессия начиналась в Manual, добавьте в ~/.claude/settings.json:
    {
      "permissions": {
        "defaultMode": "default"
      }
    }
    Чтобы начинать в accept-edits, укажите acceptEdits вместо default.
  3. Используйте более дешёвую модель классификатора: начиная с Claude Code v2.1.302 переменная окружения CLAUDE_CODE_AUTO_MODE_MODEL задаёт модель классификатора; укажите полный ID модели. Если вы работаете на Opus, задайте claude-sonnet-5-5, и проверки будут тарифицироваться по ценам Sonnet:
    {
      "env": {
        "CLAUDE_CODE_AUTO_MODE_MODEL": "claude-sonnet-5-5"
      }
    }
    Классификатор оценивает безопасность действия, а меньшая модель оценивает хуже; взвесьте это сами.
  4. Примите расходы: auto mode избавляет вас от подтверждения каждого действия. Если он вам нужен, эти расходы ожидаемы и не являются проблемой прокси.

Другие причины промахов

Всё это меняет префикс, который отправляет Claude Code, поэтому на следующем ходу весь кэш записывается заново:

СлучайПодробности
Смена модели посреди сессииКэш привязан к модели, поэтому другая модель начинает с нуля. Когда вы переключитесь обратно, кэш исходной модели может уже истечь.
Смена усилия мышления или /fastУсилие и быстрый режим тоже меняют запрос и ломают кэш.
Пауза дольше 5 минутКэш по умолчанию живёт всего 5 минут; после перерыва на кофе первый ход записывает всё заново. Если вы часто делаете паузы, см. Часовой кэш.
Подключение или отключение MCP-сервераОписания инструментов идут в запросе первыми, поэтому изменение списка инструментов меняет весь префикс. Включённый по умолчанию поиск MCP-инструментов в Claude Code этого избегает; не задавайте ENABLE_TOOL_SEARCH=false.
Включение или отключение плагинаПлагин, приносящий MCP-сервер, действует так же, как предыдущая строка.
/compactСжатие переписывает историю, поэтому первый ход после него снова пишет в кэш; потом сессия становится короче и дешевле.
Обновление Claude CodeУ новой версии другой системный промпт, поэтому первый ход после обновления записывает заново.
Новая сессия, /clear или --resume спустя долгое времяНовая сессия пишет кэш с нуля. Когда вы возобновляете старую сессию, её кэш, скорее всего, уже истёк.

Правка CLAUDE.md не ломает кэш сразу, но и не вступает в силу сразу: она ждёт /clear, /compact или перезапуска. Как писать его хорошо — в разделе как писать CLAUDE.md.

Чтобы чаще попадать в кэш: по возможности заканчивайте задачу в одной сессии, не меняя модель и усилие мышления на полпути; когда контекст становится длинным, сжимайте его через /compact, а не начинайте новую сессию и не собирайте контекст заново.

Часовой кэш

Если вы часто останавливаетесь подумать на пять–шестьдесят минут и продолжаете после этого, пусть Claude Code пишет записи часового кэша. Добавьте одну строку в env в ~/.claude/settings.json (нужен Claude Code v2.1.242 или новее):

"CLAUDE_CODE_PROMPT_CACHE_TTL": "1h"

Запись в часовой кэш стоит около 2× цены входа, запись на пять минут — около 1,25×. При редких паузах каждая запись обходится дороже; при частых полные перезаписи, которых вы избегаете, экономят намного больше. CoreCode передаёт заголовки, нужные часовому кэшу, без изменений, так что больше ничего настраивать не нужно.

Разбор по журналу

Откройте журнал использования и читайте подряд идущие запросы одной сессии в порядке времени:

В Claude Code /usage (или /cost) показывает расход токенов и стоимость текущей сессии, а /context — чем заполнен контекст.

Если журнал всё равно ничего не объясняет, пришлите нам время этих запросов из журнала использования, и мы проверим аккаунт-источник и маршрутизацию.

Другие модели в счёте

Даже если вы пишете код только на Opus, в счёте могут появиться Haiku или Sonnet, обычно из-за:

Найдите соответствующие записи по времени в журнале использования, чтобы увидеть, какая модель использовалась в каждой и сколько это стоило.