Доля попаданий в кэш Claude Code

Главное

• Норма: 96.8%, медиана в продолжающихся диалогах (120 пользователей); средняя половина 94.9%–98.1%
• Все запросы: 90.9%, включая смену аккаунта, истечение кэша и новые диалоги
• Главная причина промахов: смена аккаунта, 37% промахов
• Между вариантами клиента: разница 4.0 п., CLI (терминал), Настольное приложение, Локальный агент

Какая доля попаданий в кэш нормальна для каждого клиента

Неделя 2026-09-29 – 2026-10-05 (UTC)

• Доля попаданий в продолжающихся диалогах (медиана): 96.8%
• Средняя половина пользователей: 94.9%–98.1%
• Подходящие пользователи: 120 (не менее 20 продолжений диалога за неделю)
• Доля попаданий по всем запросам: 90.9%

Claude Code по вариантам

CLI, расширение для IDE и настольное приложение одного клиента отправляют почти одинаковые запросы, поэтому и доля попаданий у них должна быть близкой.

• CLI (терминал): 97.2% (59)
• Настольное приложение: 96.2% (39)
• Локальный агент: 96.2% (22)
• Расширение VS Code: 96.8% (15)
• Agent SDK (CLI): 93.3% (7)

Claude Code по версиям

Если релиз меняет префикс запроса, его доля попаданий заметно ниже, чем у других версий, — уже в неделю выхода.

• 2.1.289: 98.8% (17)
• 2.1.288: 96.8% (13)
• 2.1.287: 97.7% (14)
• 2.1.286: 97.3% (38)
• 2.1.285: 97.7% (16)
• 2.1.284: 95.5% (38)
• 2.1.283: 97.0% (10)
• 2.1.281: 94.0% (22)
• 2.1.280: 95.9% (10)

Почему у Claude Code низкая доля попаданий в кэш: причины промахов

9.1% входа за эту неделю не было прочитано из кэша. Ниже — по причинам и с тем, что можно сделать.

Запрос ушёл на другой вышестоящий аккаунт или эндпоинт: 37% промахов, около 3.4% всего входа

Кэш промптов хранится у того вышестоящего аккаунта, который обработал запрос. Если посредник или шлюз с несколькими аккаунтами отправляет следующий шаг диалога на другой аккаунт, весь контекст записывается заново. При прямом подключении к вендору этой причины нет.

Новый контент и изменения префикса в идущем диалоге: 22% промахов, около 2.0% всего входа

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

Параллельный запрос (предыдущий ещё не завершён): 15% промахов, около 1.4% всего входа

Субагенты и параллельные вызовы инструментов отправляют следующий запрос до завершения предыдущего. Форк Claude Code читает кэш родительской сессии; обычный субагент со своим системным промптом и инструментами строит собственный кэш.

Пауза больше 5 минут, кэш истёк: 12% промахов, около 1.1% всего входа

По умолчанию кэш живёт 5 минут, и каждое попадание бесплатно его продлевает. Если вы часто делаете паузы дольше, задайте CLAUDE_CODE_PROMPT_CACHE_TTL=1h (v2.1.242+); запись в кэш тогда стоит 2× цены входа вместо 1,25×.

Смена модели: 8% промахов, около 0.8% всего входа

У каждой модели свой кэш. После /model следующий запрос читает всю историю без попаданий в кэш, даже если содержимое не изменилось.

Новый диалог или простой больше часа: 6% промахов, около 0.5% всего входа

Первый запрос нового диалога или запрос после часа простоя вынужден записать кэш заново.

Пара пунктов доли попаданий — счёт в разы больше

По официальным ценам Claude Opus 5.5, промахи записываются в 5-минутный кэш; фактическая стоимость миллиона входных токенов:

• Медиана этой недели: 96.8%: $0.35 (×1.0)
• 90%: $0.68 (×1.9)
• 80%: $1.16 (×3.3)
• 50%: $2.60 (×7.3)

Посчитайте свой случай в калькуляторе стоимости Claude API

TTL кэша Claude Code: сколько он живёт и сколько стоит

• По умолчанию живёт 5 минут, каждое попадание бесплатно его продлевает.
• Переключиться на 1 час: CLAUDE_CODE_PROMPT_CACHE_TTL=1h (v2.1.242+; для субагентов — CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL), в старых версиях — ENABLE_PROMPT_CACHING_1H=1.
• Запись в кэш стоит 1,25× цены входа (5 минут) или 2× (1 час); чтение обычно 0,1×, а на Opus 5.5 и Sonnet 5.5 — 0,05×.
• Промпты короче минимальной длины молча не кэшируются: от 512 до 4096 токенов в зависимости от модели.

Кэширование промптов Anthropic · Кэширование промптов в Claude Code · Переменные окружения Claude Code

Как проверить долю попаданий в кэш у Claude Code

• Выполните /usage в Claude Code: строка Prompt cache (main) в блоке Session показывает число запросов, долю входа из кэша, промахи и то, жив ли кэш сейчас.
• Скрипты строки состояния могут читать поля prompt_cache; экспортёр OpenTelemetry передаёт токены чтения и создания кэша по пользователям и сессиям.
• Из API: cache_read_input_tokens ÷ (input_tokens + cache_read_input_tokens + cache_creation_input_tokens).
• В Wokey в журнале запросов консоли у каждого запроса видны чтение и запись кэша.

Расходы и использование Claude Code

Почему через посредников (relay) доля попаданий ниже

• Смена аккаунта: кэш принадлежит вышестоящему аккаунту, поэтому запрос, отправленный на другой аккаунт, переписывает всё заново. Самая частая причина у посредников; при прямом подключении её нет.
• Конвертация формата: при переводе между форматами Anthropic и OpenAI может меняться префикс или теряться точка cache_control.
• Claude Code до v2.1.181 с собственным base URL добавлял в блок атрибуции в начале системного промпта токен, разный для каждого запроса, поэтому шлюзы, кэширующие по телу запроса, не попадали в кэш; обновитесь или задайте CLAUDE_CODE_ATTRIBUTION_HEADER=0.
• Самопроверка: отправьте два запроса с одинаковым префиксом длиннее минимальной длины кэша; у второго чтение из кэша должно быть близко к длине префикса.

Wokey по возможности направляет последующие запросы диалога на тот же вышестоящий аккаунт. С 2026-10-04 по 2026-10-10 обычные пользователи Wokey получили 92.8% попаданий на Claude Opus 5.5 по всем запросам, OpenRouter в целом — 87.8%.

Сравнить с долей попаданий в кэш у OpenRouter · Онлайн: публичный API доли попаданий в кэш Wokey (7 дней)

Как мы измеряем

• Реальные запросы пользователей через шлюз Wokey; каждый понедельник в 05:00 UTC считаем прошлую неделю (с понедельника по воскресенье).
• Клиент определяется по User-Agent запроса. Запросы из SDK, HTTP-библиотек и от посредников, где настоящий клиент неизвестен, не учитываются; корпоративные клиенты тоже.
• Продолжение диалога: та же модель и тот же вышестоящий аккаунт, что у предыдущего запроса диалога, и старт не позже 5 минут после его завершения. Доля пользователя = чтение из кэша ÷ вход по таким запросам (вход включает чтение и запись кэша); публикуем медиану по пользователям, у которых за неделю не меньше 20 таких запросов.
• Ячейка публикуется, если в ней не меньше 5 подходящих пользователей; изменение больше чем на 3 пункта к прошлой неделе сначала проверяется вручную.
• Известные смещения: только пользователи Wokey; привычки пользователей сильно различаются; доля по всем запросам включает собственные потери маршрутизации шлюза (причина «запрос ушёл на другой вышестоящий аккаунт»).

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