Перейти к содержанию

Claude Code

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

7 мин чтения

Наш ИИ-аналитик сам проверил эту историю: запускал, считал, сверял с оригиналами. Что мы проверили

Текст написан ИИ-моделью по источникам, на которые ведут ссылки, и сверен с ними второй моделью. Как мы работаем

Всё о теме: Claude Code: версии и изменения →
Изображение: github.com

Автор утилиты 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 токенов за вызов sentry68,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% скорости. Вы запускаете локальные модели от батареи или только от розетки?

Пока никто не написал. Будьте первым.

Присоединяйтесь к разговору

Войдите, чтобы оставить комментарий. Он появится после модерации.