TokenJam CLI
CLI и локальная панель находят перерасход токенов в сессиях Claude Code и Codex и подсказывают конкретные правки
- 125 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает логи и транскрипты сессий агентов на диске и добавляет строку состояния и хуки в настройки Claude Code.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/tokenjamОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает логи и транскрипты сессий агентов на диске и добавляет строку состояния и хуки в настройки Claude Code.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
TokenJam читает телеметрию агентов и показывает, куда уходят токены. Команда `tj onboard` подключает живой сбор данных, подтягивает недавнюю историю Claude Code и Codex и ставит строку состояния без расхода токенов. Команда `tj serve` открывает локальную панель Lens по адресу 127.0.0.1:7391, а `tj optimize` печатает в терминал отчет о потерях. Анализаторы ищут повторно отправляемый контекст, ситуации, где хватило бы более дешевой модели той же линейки, раздутые файлы инструкций вроде CLAUDE.md и AGENTS.md, MCP-серверы с загруженными, но ни разу не вызванными схемами. Каждая проверка заканчивается конкретной правкой, а список правил выводит `tj rules list`. Данные остаются на вашей машине.
Для кого. Тем, кто платит за токены Claude Code или Codex и хочет увидеть по сессиям, где деньги уходят впустую, без отправки данных в облако.
Подходит, если
- Счет за Claude Code вырос, и непонятно, какие сессии и модели его раздули.
- Субагенты запускаются на дорогой модели там, где хватило бы дешевой.
- Файл CLAUDE.md разросся и утяжеляет каждую сессию.
- Команда хочет разовый отчет без установки: достаточно `npx tokenjam`.
Не подходит, если
- Нужна облачная панель наблюдаемости для всей команды: TokenJam работает локально.
- Агент не пишет телеметрию и логи сессий, которые можно прочитать с диска.
- От отчета требуют гарантий качества ответов при смене модели: рекомендации по более дешевой модели не доказывают равенство качества.
Пример запроса к агенту
Покажи, сколько токенов мои сессии потратили за месяц впустую и какие правки в CLAUDE.md дадут наибольшую экономию.Ограничения
Заявленная экономия до 40 процентов зависит от привычек конкретного пользователя и не гарантируется. Для установки нужен Node.js для `npx tokenjam` либо Python 3.10 и выше для `pipx install tokenjam`. Плагин Claude Code только оборачивает команды `tj` и сам ничего не ставит, поэтому `tj` должен быть доступен в PATH. Сервер MCP `tj mcp` включается отдельно и по умолчанию выключен. Для SDK-агентов добавляется декоратор `@watch()` или экспорт OTLP на локальный адрес. Последний коммит в репозитории датирован ноябрем 2026 года.
Как отключить. Выполните `tj uninstall --yes` или в Claude Code команду `/tokenjam:uninstall`, затем удалите пакет через `pipx uninstall tokenjam`. Строка состояния и хук возврата к сессии убираются той же командой.
Частые вопросы
Как быстро посмотреть отчет без установки?
Выполните `npx tokenjam`: команда печатает отчет только для чтения по логам, которые уже лежат на диске, и ничего не сохраняет.
Где открывается панель?
Командой `tj serve` на локальном адресе http://127.0.0.1:7391/. Панель Lens показывает расходы по моделям и сессиям и предложенные правки.
С какими агентами работает?
С Claude Code и Codex через чтение логов сессий, с собственными агентами на Python и TypeScript через SDK, а также с любым источником OTLP.
Как поставить плагин для Claude Code?
Командой `/plugin marketplace add Metabuilder-Labs/tokenjam`, затем `/plugin install tokenjam@tokenjam` и `/tokenjam:onboard`.
Можно ли импортировать данные из Langfuse?
Да, командой `tj backfill langfuse --source-url <адрес> --api-key <ключ>`, так же поддерживается Helicone.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСчитает токены и стоимость сессий Claude Code и Codex по локальным журналам и показывает остаток лимитов в статусной строке
TokenTracker считает токены и расходы в Claude Code, Codex, Cursor, Gemini CLI и других агентах по локальным логам и показывает их на панели localhost:7680
Локальный CLI показывает, куда уходят токены в Claude Code, Codex и opencode, и придерживает дорогие сообщения
Tokdash показывает расход токенов и стоимость сессий Claude Code, Codex, Gemini CLI и еще десятка агентов локально
CLI на основе ccusage синхронизирует суточный расход токенов агентов с публичным профилем и рейтингом на tokenmaxxing.sh
Отчеты по токенам и стоимости Claude Code, Codex, Gemini CLI и других агентов по локальным логам: по дням, месяцам и сессиям
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| TokenJam (эта карточка) | нет | 125 | |
| ccusage | нет | 19 425 | считает расходы по логам Claude Code; TokenJam дополнительно ищет причины перерасхода и предлагает правки |
| Token Optimizer | нет | 2 964 | сжимает контекст и вывод; TokenJam измеряет сессии и показывает, где расход можно сократить |
Коротко о README
Установка начинается с мастера, который спрашивает, как вы работаете с агентами, и подключает подходящие анализаторы. Лицензия MIT, облака и регистрации нет.