context-tax считает, во что обходится контекст Claude Code

Автор утилиты context-tax, показанной на Show HN 16 октября, приводит замер с одной реальной машины: один встроенный инструмент Claude Code занимал 11 402 токена из 47 700 в первом запросе сессии, почти четверть того, что уходит в модель до первого слова пользователя. Такой инструмент выпадает из каждого хода после правила в permissions.deny, а context-tax по транскриптам находит редко вызываемые встроенные инструменты, MCP-серверы и навыки и через context-tax fix записывает отключения только после показа диффа и подтверждения.
Код лежит на GitHub, запуск через npx context-tax, без установки, аккаунта и телеметрии. Языковую модель утилита не вызывает, каждый вердикт в ней - арифметика. Она читает транскрипты в ~/.claude/projects, куда свежий Claude Code записывает, что именно отправил: список навыков, имена инструментов, файлы инструкций, собственные инструменты и системный промпт. Чтобы взвесить MCP-сервер, она запускает его тем же рукопожатием, что и агент на старте сессии, и обращается только к хостам из вашего конфига; флаг --no-spawn обходится кэшем и встроенной таблицей известных серверов. Работает всё только с Claude Code.
Цена одного вызова
Главная колонка отчёта делит постоянный расход на число использований. В демонстрационном отчёте из README (имена и цифры там выдуманы автором на вымышленном конфиге) сервер sentry весит 400 токенов, повторяется в каждом из 42 900 ходов и вызван один раз за 96 сессий: выходит 17 160 000 токенов на одно использование. Итог за ход точный, он берётся из usage, по которому выставлялись запросы к API: медиана первого запроса по десяти последним сессиям. Строки оценочные, токены в них считаются как символы, делённые на четыре, и расхождение с итогом не размазывается по таблице, а стоит отдельной строкой unattributed.
У каждого MCP-сервера в отчёте два числа. В ноябре 2025 года в issue к claude-code семь серверов занимали одними определениями инструментов 67 300 токенов, 33,7% окна в 200 000. С версии 2.1.7 от 13 января Claude Code по умолчанию откладывал описания MCP-инструментов, когда они превышали 10% окна, а в коде версии 2.1.302, который мы разобрали, поиск инструментов включён по умолчанию, если не задана переменная ENABLE_TOOL_SEARCH; режим с порогом остался опцией. В каждый ход теперь едут имена и инструкции сервера, а схема подгружается, когда до инструмента доходит дело. Колонка tokens показывает первое, deferred - то, что придётся заплатить при загрузке схем.
Вердикт «не использовался» всегда печатается со знаменателем вроде «0 вызовов в 96 сессиях с момента настройки». Возраст проектного сервера берётся из git log: даты файлов переписывает git checkout, и на свежем клоне всё выглядело бы добавленным сегодня. Серверы из ~/.claude.json получают неизвестный возраст, и цифра за вызов для них помечена как верхняя граница. Команду claude mcp remove -s user, которая убирает сервер со всей машины, утилита не предлагает из-за молчания одного проекта. Прочерк в таблице означает выключенный сервер, который не запускали; ноль - сервер, к которому сессия не смогла подключиться, и он получает пометку could not connect вместо находки.
Версии до 0.4.0 считали строки транскрипта, хотя Claude Code пишет один ответ API несколькими строками, поэтому число ходов и цифры за вызов там выходили примерно вдвое выше реальных.
Навыки без описаний
Одна находка говорит о том, чего агент недополучил. На список навыков Claude Code отводит бюджет в 1% окна контекста, пересчитанный в символы. Имя сохраняет каждый навык, описания делят остаток, и проигравшие уходят в модель голым именем, по которому выбрать навык нечем. Описание и без того слабое место: в сентябре у 69% из 215 проверенных навыков описание не поднимало навык надёжно, а у выпавших из бюджета его нет вовсе. context-tax считает такие навыки по списку, который сессия действительно отправила, и группирует по владельцу, потому что место обычно съедает один крупный плагин.
Путей два. context-tax fix --restore-descriptions поднимает skillListingBudgetFraction, уходят все описания, и каждый ход дорожает; в обычный fix это изменение не входит, поскольку оно единственное добавляет токены. Второй путь - отключать лишнее через skillOverrides, но пока список не влезает в бюджет, промпт от этого почти не худеет: освобождённое место занимает чьё-то выпавшее описание. Навык, который вызывают только вручную как slash-команду, fix переводит в user-invocable-only: команда работает, описание из промпта уходит.
Куда fix ведёт каждую находку
- сервер из
.mcp.json: добавляется вdisabledMcpjsonServersв.claude/settings.local.json; - сервер из
~/.claude.json: утилита печатаетclaude mcp remove <name> -s <scope>и сама файл не трогает, потому что рядом лежат API-ключи, и даже бэкап стал бы второй копией всех учётных данных; - коннектор claude.ai: ни в одном файле на машине его нет, поэтому отчёт говорит, где он выключается, и отправляет в настройки claude.ai;
- встроенный инструмент или агент без вызовов: правило в
permissions.deny; - инструмент или плагин, который используется реже чем в одной сессии из 20, отключается только на уровне
--level lean, реже чем в одной из пяти - наmax; по умолчанию стоитsafe, и ничего из того, чем вы пользовались, без вашего выбора не выключается.
Запись обставлена предохранителями. Без терминала fix отказывается писать, если не передан --yes, каждый заменённый файл копирует в ~/.cache/context-tax/backups/, пишет через временный файл и переименование, а битый JSON, который часто оказывается недописанной ручной правкой, не трогает. Повторный запуск отвечает already applied. Одну правку без спроса он всё же делает: файл переписывается целиком с отступом в два пробела, и массив, записанный в одну строку, возвращается по элементу на строку. Она видна в диффе до подтверждения.
Авторский разбор
Что мы проверили
18 октября мы собрали context-tax из репозитория, прогнали тесты и все команды на синтетическом домашнем каталоге, затем сверили допущения утилиты с кодом и реальными транскриптами Claude Code 2.1.302 и с прайс-листом Anthropic.
Арифметика, отсутствие зависимостей и осторожность fix подтвердились. Устарели две константы из README: бюджет списка навыков на текущих моделях меньше заявленного, а токены на символ считаются иначе, так что строки отчёта и доля окна на свежих моделях смещены, при том что итог за ход остаётся точным. Ещё мы добавили то, чего в отчёте нет: повторяемые токены почти целиком читаются из кэша, и в долларах «цена за вызов» на порядок ниже, чем кажется по токенам.
- Из 459 тестов прошли 458; упавший проверяет, что убит запущенный сервер, и сервер в нашем контейнере был убит, но остался зомби, потому что PID 1 там не собирает процессы. В
package.jsonнет зависимостей. На синтетике сервер в 419 токенов при 120 ходах и одном вызове дал 50 280 за вызов, как и следует из формулы, аfix --dry-runпоказал дифф и ничего не записал. - README называет бюджет навыков в 8 000 символов при окне в 200 000 токенов и 40 000 при миллионе. Для моделей новее Opus 4.6, Sonnet 4.6 и Haiku 4.5 Claude Code берёт 3 символа на токен, и бюджет выходит 6 000 и 30 000. На нашей машине сессии со 115 навыками отправляли списки в 29 949-29 991 символ, 28-31 навык уходили голым именем. Окно утилита выводит делением на четыре, поэтому для модели с миллионом токенов она покажет около 750 000.
- Из-за того же коэффициента строки могут недосчитывать до 25% относительно оценки самого Claude Code; разница уходит в unattributed.
- В двух сессиях на нашей машине доля чтений из кэша составила 99,4% и 96,3%. Кэш стоит 1/20-1/40 цены входа: у Opus 5.5 это 4 доллара за миллион токенов против 0,20.
| Цифра из примера README | Как вход Opus 5.5 без кэша | Как чтение из кэша |
|---|---|---|
| 17 160 000 токенов за вызов sentry | 68,64 доллара | 3,43 доллара |
| 1,7 млрд токенов контекста | 6 864 доллара | 343 доллара |
При измеренной у нас доле кэша вторая строка обходится в 382-584 доллара, а заметный в токенах сервер sentry стоит всего несколько долларов. На подписке такие токены вообще не тарифицируются поштучно.
Первый запуск
Отчёт открывается командой npx context-tax. Чего он не скажет, автор оговаривает в самом выводе: сколько весит CLAUDE.md, посчитать можно, а какие инструкции из него агент реально использовал, по логам не узнать. План правок без записи даёт npx context-tax fix --dry-run, хотя серверы для замера он всё равно запускает. После настоящего fix и первой новой сессии отчёт в первых строках показывает первый запрос до правки и после, по той же точной медиане.
Дальше
AI-индустрияЖелезо и инфраструктураразбор
Surface Laptop Ultra тянет локальные модели, пока в розетке
99,6% производительности на батарее обещает Microsoft для Surface Laptop Ultra. Но в тестах локальных моделей у The New Stack ноутбук без зарядки терял около 20–25% скорости. Вы запускаете локальные модели от батареи или только от розетки?
Читайте также
- Дерево файлов покажет, что читает и правит Claude Code
- Промах кэша на Opus 5.5 стоит до 40 раз дороже попадания
- Tokendoctor обещает тот же Claude Code до 38% дешевле
- Память и навыки Claude Code получили git-историю в memsaga
- intent-lens объясняет команды Claude Code до их запуска
- Codedict срезал токены Claude Code на 63%, а счёт на 26%
Комментарии
Пока никто не написал. Будьте первым.
Присоединяйтесь к разговору
Войдите, чтобы оставить комментарий. Он появится после модерации.

