tokendoctor — тот же Claude Code до 38% дешевле: подбор настроек по вашим сессиям

· 5 мин чтения
token-optimization context-engineering claude-code compaction cost
📂 Исходный код на GitHub

Плагин для Claude Code: проигрывает ваши прошлые сессии при порогах компакции 200K–600K и показывает, сколько каждый вариант сэкономил бы, предлагает до пяти изменений настроек с показом каждого в виде diff, умеет сдвигать старый вывод инструментов вместо пересказа диалога, ведёт локальный дашборд расходов. Всё работает локально, единственный сетевой вызов — две публичные страницы документации Claude Code раз в день. Лицензия MIT.

tokendoctor — тот же Claude Code до 38% дешевле: подбор настроек по вашим сессиям

tokendoctor — плагин для Claude Code с обещанием прямо в заголовке: тот же Claude Code, но до 38% дешевле. Главная идея — в том, откуда берётся эта цифра. Инструмент не верит чужим бенчмаркам. Он проигрывает заново ваши собственные сессии за последние 30 дней и показывает, сколько стоил бы каждый вариант настройки. Потом применяет только то, что вы выбрали, и любое изменение можно откатить.

Зачем сначала смотреть на свои сессии

То, сколько экономит настройка, зависит от того, как вы работаете: какой длины ваши сессии, какие модели вы используете, какая у вас задача. Число из чужих сессий — даже из сессий автора инструмента — о ваших говорит мало. Поэтому tokendoctor начинает с оглядки назад.

Механика дорогой части сессии простая. Каждый запрос отправляет модели весь разговор целиком. На моделях с окном в 1M токенов Claude Code запускает компакцию только ближе к 967K токенов. Значит, конец длинной сессии — самая дорогая её часть. У автора плагина две трети расходов основного потока уходили на запросы, в которых лежало больше 400K токенов контекста.

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

Три шага

Шаг 1. Оглядка назад. Команда /tokendoctor:sessions проигрывает заново каждую вашу сессию, запрос за запросом, при порогах компакции 200K, 300K, 400K и 600K — и показывает, сколько стоил бы каждый вариант. Плагин только читает ваши транскрипты — локальные записи сессий. Он не вызывает модель и ничего не меняет. У оценки есть ограничение: это верхняя граница. Повторный проигрыш не видит работу, которую модель переделала бы после пересказа, поэтому реальная экономия может быть меньше показанной.

Шаг 2. Меняем только то, что окупается. Команда /tokendoctor:optimize предлагает изменения на основе ваших чисел и сверяет настройки с документацией Claude Code. Применяются только выбранные вами изменения, и каждое сначала показывается в виде diff. Команда /tokendoctor undo возвращает любое из них обратно.

Шаг 3. Сдвиг вместо пересказа. Когда Claude Code собирался бы остановиться и пересказать диалог, tokendoctor вместо этого выбрасывает старый вывод инструментов и сохраняет все сообщения. Вызова модели нет, поэтому это занимает миллисекунды, а не минуту.

Установка

claude plugin marketplace add localixai/tokendoctor
claude plugin install tokendoctor@tokendoctor

Первая команда добавляет репозиторий localixai/tokendoctor как маркетплейс плагинов Claude Code, вторая ставит из него сам плагин. После перезапуска Claude Code выполните /tokendoctor:sessions — увидите, сколько стоили бы ваши последние 30 дней при каждом пороге. Пока вы ничего не выбрали, ничего не меняется.

Что это дало автору

Автор сравнил месяц до настройки с неделей после: около 23 тысяч и 19 тысяч запросов основного потока. Контекст на запрос упал с 412K до 219K токенов, цена запроса снизилась на 38% по прайсовым ценам API. Из изменений он поставил порог 400K и Sonnet для субагентов.

Автор честно оговаривает: это сравнение до/после у одного человека, а не контролируемый эксперимент. Есть и обратная сторона: пересказов становится больше, и каждый пересказ — пауза. В его сессиях пауза длилась 79 секунд в среднем. Для этого и существует сдвиг. Ваши сессии могут показать совсем другое — в этом и смысл смотреть сначала на них.

Бенчмарк

В репозитории есть бенчмарк: Claude Code собирает TypeScript-проект против тестов, которые менять нельзя. Зачётным считается только прогон, в котором все тесты прошли. Такая защита нужна, чтобы «экономия» не достигалась ценой сломанного результата. Цена считается на задачу, модель — Haiku 5.5.

Сравнение Цена Время
Сдвиг против пересказа, день работы -19% -33%
Сдвиг против пересказа, оценочный набор задач -35% -28%
Сдвиг против пересказа, короткая задача +6% -17%
Только советы по настройкам, против Claude Code как есть дороже в 3 прогонах из 4
Советы плюс сдвиг, неделя работы -11% … -21%

Тесты прошли во всех прогонах. Советы сами по себе здесь не окупились: задачи редко доходили до 400K токенов, где порог начинает иметь значение. Если ваши сессии тоже не дорастают, повторный проигрыш это покажет — и порог лучше не трогать. Все прогоны, включая неудачные, опубликованы в bench/HISTORY.md.

Команды

Команда Что делает
/tokendoctor:sessions [days] Проигрывает прошлые сессии (30 дней или days) при меньших порогах: что каждый сэкономил бы и куда ушли токены. Только чтение.
/tokendoctor:audit Проверяет настройки, память и CLAUDE.md по документации и сортирует проблемы по серьёзности. Только чтение.
/tokendoctor:dashboard [days] Открывает локальный дашборд всех сессий на этой машине: расход по дням, моделям, субагентам и проектам. Весь дашборд — один локальный файл.
/tokendoctor:optimize [focus] Предлагает до пяти изменений на основе ваших чисел и применяет выбранные.
/tokendoctor [name] [value] Показывает, объясняет или меняет настройку — без вызова модели.
/tokendoctor undo [n] Показывает все сделанные плагином изменения и откатывает один из них.

На дашборде автора видно, куда уходят токены. Из подписи к его скриншоту: 57% расходов пришлось на то, что Claude заново перечитывал разговор.

Кому он окупится

Из всего сказанного в README складывается простая картина. Выигрыш появляется там, где сессии длинные и запросы дорастают до сотен тысяч токенов: именно в этой зоне порог компакции и сдвиг меняют цену запроса. Если ваши сессии короткие и порог 400K не достигается, советы по настройкам не окупаются — бенчмарк это показал на коротких задачах, и повторный проигрыш ваших сессий покажет то же самое. В этом случае автор советует оставить порог как есть.

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

Приватность и данные

Ничего не покидает вашу машину. Единственный сетевой вызов — две публичные страницы документации Claude Code, один раз в день. Плагин никогда не переключает ваши модели сам. Лицензия — MIT.

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

Подробная документация — на tokendoctor.localix.ai/docs. Там разобраны: список из 38 проверок аудита, все настройки, как устроен сдвиг (включая логины Team и Enterprise), запуск команд tokendoctor из шелла, измерения экономии и ограничения инструмента. Тем, кто хочет работать над самим tokendoctor, README указывает на файл CONTRIBUTING.md в репозитории.

Источник: https://github.com/localixai/tokendoctor