tokendoctor — тот же Claude Code до 38% дешевле: подбор настроек по вашим сессиям
📂 Исходный код на GitHubПлагин для Claude Code: проигрывает ваши прошлые сессии при порогах компакции 200K–600K и показывает, сколько каждый вариант сэкономил бы, предлагает до пяти изменений настроек с показом каждого в виде diff, умеет сдвигать старый вывод инструментов вместо пересказа диалога, ведёт локальный дашборд расходов. Всё работает локально, единственный сетевой вызов — две публичные страницы документации Claude Code раз в день. Лицензия MIT.
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