tokendoctor — плагин
tokendoctor показывает, где Claude Code переплачивает токенами, советует правки настроек и откатывает их одной командой
- 70 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Плагин читает историю ваших сессий и настройки Claude Code, а скилл `optimize` переписывает файлы настроек
- Хук запуска сессии в фоне дописывает итоги дня в `~/.claude/tokendoctor/history.jsonl`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/tokendoctorОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Плагин читает историю ваших сессий и настройки Claude Code, а скилл `optimize` переписывает файлы настроек
- Хук запуска сессии в фоне дописывает итоги дня в `~/.claude/tokendoctor/history.jsonl`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин проверяет настройки и историю ваших сессий в Claude Code. Скилл `audit` сверяет конфигурацию с актуальной документацией на code.claude.com и выдает ошибки, предупреждения и замечания с оценкой потерь. Скилл `sessions` показывает расходы по дням или неделям, а `tokendoctor-replay` пересчитывает ваши прошлые сессии с меньшим окном контекста и показывает, сколько это сэкономило бы. Правки вносит скилл `optimize`: каждое изменение показывается в диалоге и выполняется только после «Apply». Можно менять окно автосжатия, кэш, уровень усилия, модель и подагентов, хуки и разрешения в список не входят. Перед записью создается резервная копия, отмена делается командой `tokendoctor-undo`. Команда `/tokendoctor` отвечает без обращения к модели, поэтому токены не тратит. Папка `bin/` плагина попадает в PATH инструмента Bash.
Для кого. Тем, кто работает в Claude Code каждый день и хочет увидеть реальные причины большого счета за токены и безопасно подправить настройки.
Подходит, если
- Счет за токены растет, и непонятно, виноваты окно контекста, модель или подагенты
- Нужно проверить, какие настройки Claude Code игнорируются или написаны с ошибкой
- Перед изменением окна автосжатия хочется увидеть расчет на собственных сессиях
- Сессии редко превышают 400 тысяч токенов, и надо понять, помогает ли им большое окно
- Под логином Team или Enterprise нужен слайд с итогами через `tokendoctor-org-install`
Не подходит, если
- Нужны правки хуков и разрешений: инструмент их не меняет
- Вы работаете не в Claude Code, ведь плагин рассчитан только на него
- Вам нужно сжимать вывод команд на лету, для этого есть отдельные оптимизаторы токенов
Пример запроса к агенту
Прогони аудит tokendoctor и покажи, сколько я сэкономил бы на окне 400k по прошлым сессиямОграничения
Правила аудита зависят от выпуска Claude Code, на старых версиях часть из них пропускается. Автор сам предупреждает, что единого средства нет: при редких длинных сессиях окно ничего не дает, и сводка перед концом может стоить дороже, чем экономит. Инструмент читает текущую документацию с code.claude.com и кэширует ее на сутки. Вспомогательный хук дописывает итоги каждого дня в `~/.claude/tokendoctor/history.jsonl`. Команда `selfcheck` делает один запрос к малой модели.
Как отключить. Выполните `claude plugin uninstall tokendoctor@tokendoctor`. Сделанные правки откатывает `tokendoctor-undo`, историю удаляет файл `~/.claude/tokendoctor/history.jsonl`.
Частые вопросы
Как установить tokendoctor?
Выполните `claude plugin marketplace add rsaryev/tokendoctor` и `claude plugin install tokendoctor@tokendoctor`, затем перезапустите Claude Code. Попробовать без установки можно через `claude --plugin-dir`.
Может ли он что-то сломать?
Изменения применяются только после подтверждения в диалоге, перед записью делается резервная копия, а `tokendoctor-undo` возвращает прежние настройки. Хуки и разрешения инструмент не трогает.
Сколько токенов тратит сам плагин?
По оценке `claude plugin details`, около 160 токенов постоянной нагрузки на четыре скилла. Команда `/tokendoctor` отвечает без вызова модели.
Что такое replay?
Команда `tokendoctor-replay` пересчитывает ваши прошлые сессии с окнами вроде 200k и 400k и показывает, что изменилось бы в расходе.
Чем отличается от оптимизаторов токенов?
Он смотрит настройки и историю сессий и советует правки конфигурации. Оптимизаторы вроде token-optimizer сжимают контекст или вывод команд во время работы.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин Claude Code заменяет встроенные файловые инструменты облегченными версиями, чтобы тратить меньше токенов за сессию
Локальная панель для сессий Claude Code: таймлайны, расходы токенов, инструменты, агенты, скиллы и живые сессии
Установщик набора из хуков, команд и плагинов, который сжимает вывод инструментов и экономит токены в Claude Code.
CLI-установщик восьми инструментов экономии токенов: правила, хуки, MCP и локальный прокси для Claude Code, Codex, Cursor.
Локальный прокси с панелью в терминале: показывает, сколько токенов уходит с каждым запросом Claude Code и Codex, и сохраняет промпты в файлы
Локальный прокси и плагин для Claude Code и Codex: режет лишний вывод инструментов, греет кэш промптов и показывает экономию
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| tokendoctor (эта карточка) | нет | 70 | |
| Token Optimizer | нет | 2 964 | сжимает контекст и вывод во время работы, tokendoctor разбирает настройки и историю сессий |
| Claude Token Optimizer — меньше токенов на старте | нет | 653 | отдельный CLI оптимизации, а tokendoctor работает плагином внутри Claude Code с откатом правок |
Коротко о README
README начинается с мысли, что единого средства экономии нет, и показывает, как проверить свои сессии до правок. Дальше описаны установка, команды и четыре скилла, список утилит из `bin/`, правила аудита по документации и расчет расхода. Завершают страницу замечания о хуках и лицензия.