TokenEconomizer — плагин
Плагин от Microsoft Research и UC Berkeley снижает стоимость сессий Claude Code, Codex и Copilot CLI по опыту прошлых сессий
- 5 852 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Хуки плагина выполняются в каждой сессии агента и меняют его настройки: пишут список отключенных инструментов
- Плагин делает дополнительные вызовы модели через вашего агента на вашем тарифе
- Плагин хранит историю сессий репозиториев в `~/.tokeneconomizer`, в ней могут быть фрагменты кода и команд
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/tokeneconomizerОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Хуки плагина выполняются в каждой сессии агента и меняют его настройки: пишут список отключенных инструментов
- Плагин делает дополнительные вызовы модели через вашего агента на вашем тарифе
- Плагин хранит историю сессий репозиториев в `~/.tokeneconomizer`, в ней могут быть фрагменты кода и команд
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
TokenEconomizer учится на сессиях агента в вашем репозитории и убирает повторяющиеся траты в следующих. Агент, его модель и код остаются прежними. Три механизма работают по отдельности и включаются переключателями. Micro-skills запоминают факты о репозитории, например команду `python -m pytest` там, где нет `pytest`. Факт попадает в начало сессии после трех подтверждений и исчезает, если новые сессии его опровергают. Tool pruning исключает инструменты, которыми не пользуются: определения каждого загруженного инструмента уходят в каждый запрос, поэтому лишние дорого стоят. Инструмент отключается через настройки самого агента, одна команда возвращает его обратно. Loop guard вмешивается, когда ход агента застрял на одинаковых ошибках: модель-судья оценивает ситуацию, и при уверенности от 0,7 агент получает короткую подсказку сменить подход, не больше одной на ход. Остановить ход плагин не может, он только сообщает, как это сделать. Статус и настройки смотрят командами `/tokeneconomizer:status` и `/tokeneconomizer:config`.
Для кого. Для разработчиков, которые каждый день запускают Claude Code, Codex или Copilot CLI в одних и тех же репозиториях и платят за токены.
Подходит, если
- Агент в одном репозитории раз за разом заново выясняет, как запускаются тесты и сборка
- Счет за токены растет из-за подключенных, но неиспользуемых инструментов
- Агент застревает в циклах с одной и той же ошибкой и тратит ходы впустую
- Нужна статистика, сколько стоят сессии в репозитории, с учетом кэша
Не подходит, если
- Вы работаете в каждом репозитории по одному разу: плагин окупается на повторных сессиях
- Версия агента вне проверенного диапазона, например Claude Code новее 2.1.310: на других версиях работа плагина не проверена
- Нужен жесткий лимит расходов: плагин снижает траты, но потолок не задает
- Нельзя ставить хуки в агента из-за корпоративной политики
Пример запроса к агенту
Покажи, что TokenEconomizer узнал об этом репозитории и сколько стоили мои сессииОграничения
Нужен Python 3.10 или новее. Проверенные версии: Claude Code 2.1.300–2.1.310, Codex 0.153.1–0.164.0, Copilot CLI 1.0.83–1.0.102, Pi 1.2.0–1.3.0. opencode поддерживается экспериментально. Авторы измеряли экономию на задачах SWE-Bench и Web-Bench, в вашем репозитории результат зависит от числа повторных сессий. Micro-skills по умолчанию выключены, потому что их предложения добавляют вызовы модели. Для работы агентов нужны модели, а API OpenAI и Anthropic из России недоступны.
Как отключить. Каждый механизм выключается командой `config set` со значением `off` для `microskills`, `toolprune` или `loopguard`. Для полного удаления используйте инструкцию в `plugin/README.md`. Вернуть отключенные инструменты можно командой `toolprune`.
Частые вопросы
Как поставить TokenEconomizer в Claude Code?
Клонируйте репозиторий и выполните `claude plugin marketplace add "$PWD/TokenEconomizer"`, затем `claude plugin install tokeneconomizer@tokeneconomizer`. После запуска `claude` подтвердите доверие папке и проверьте установку командой `/tokeneconomizer:status`.
Сколько токенов экономит TokenEconomizer?
Авторы получили среднее снижение стоимости на 18,4–30,9 процента в пяти сочетаниях агента и модели на задачах SWE-Bench. Pass@1 вырос в четырех из пяти сочетаний. Это замеры исследования, в вашем репозитории цифры будут другими.
Может ли плагин остановить мой ход агента?
Нет. Loop guard только добавляет в контекст подсказку сменить подход, не больше одного раза за ход по умолчанию. Если ход все равно застрял, плагин сообщает, как его остановить.
Где плагин хранит данные?
Все, что плагин узнал, лежит на вашем компьютере в папке `~/.tokeneconomizer`. Отдельного API-ключа он не требует и учетные данные не обрабатывает.
Почему Micro-skills выключены по умолчанию?
Их предложения добавляют вызовы модели и расходуют токены, поэтому механизм включают отдельно.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныЛокальный прокси и плагин для Claude Code и Codex: режет лишний вывод инструментов, греет кэш промптов и показывает экономию
Token Savior индексирует код по символам, хранит память между сессиями и переписывает шумные команды Bash, чтобы агент тратил меньше токенов
Плагин режет расход токенов в долгих сессиях: чистит старый вывод, выбирает модель подагенту и сужает список навыков.
Скилл встраивает в Python-агента лимит расходов на весь прогон: проверка перед каждым вызовом модели останавливает лишние траты.
Token Optimizer MCP
token-optimizer-mcp
Сжатие и кэш контекста, учет экономии токенов по агентам. Глобальная установка npm включает хуки Claude и оборачивает команды; телеметрия по умолчанию выключена
Скилл экономии токенов для кодовых агентов: короткий код, сжатые ответы и компактная передача данных между агентами
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| TokenEconomizer (эта карточка) | да | 5 852 | |
| RTK | нет | 86 384 | сжимает вывод команд для экономии токенов, без обучения на сессиях |
| Claude Token Optimizer — меньше токенов на старте | нет | 653 | сокращает файлы, которые Claude Code грузит на старте |
| ccusage | нет | 19 415 | считает расход токенов по логам, но сам его не снижает |
Коротко о README
Репозиторий сопровождает научную статью с arXiv и содержит плагин, документацию архитектуры и скрипты для повторения экспериментов на SWE-Bench и Web-Bench. У всех параметров механизмов есть значения по умолчанию, меняются они командой `config set`.