TokenTracker CLI
TokenTracker считает токены и расходы в Claude Code, Codex, Cursor, Gemini CLI и других агентах по локальным логам и показывает их на панели localhost:7680
- 2 149 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Первый запуск записывает хуки в конфигурацию Claude Code, Codex, Gemini CLI и других агентов
- Программа читает файлы сессий агентов и по умолчанию обращается в сеть: квоты провайдеров по имеющимся на машине данным входа, цены, обновления и анонимная телеметрия
Установка
- Работает в
Ручная установка
npx tokentracker-cliНужен Node.js 20 или новее. Первый запуск ставит хуки и открывает панель на localhost:7680.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Первый запуск записывает хуки в конфигурацию Claude Code, Codex, Gemini CLI и других агентов
- Программа читает файлы сессий агентов и по умолчанию обращается в сеть: квоты провайдеров по имеющимся на машине данным входа, цены, обновления и анонимная телеметрия
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пакет tokentracker-cli читает локальные логи ИИ-агентов, считает токены и переводит их в доллары. Первый запуск npx tokentracker-cli подключает хуки, синхронизирует данные и открывает панель на http://localhost:7680 с трендами, разбивкой по моделям, картой активности и привязкой расхода к проектам. Цены берутся из таблицы LiteLLM с ежедневным обновлением, а копия на диске позволяет считать расходы без интернета. Поддерживаются больше сорока инструментов, среди них Claude Code, Codex CLI, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Goose, Cline и Roo Code. Для Claude Code, Codex и Gemini CLI программа записывает хук SessionEnd или запись notify в конфигурацию самого агента. Остальные агенты читаются пассивно из их файлов сессий. Панель также показывает остаток лимитов у ряда провайдеров. Для рабочего стола есть приложения для macOS (в строке меню), Windows (в трее) и Linux, четыре виджета и необязательная вкладка Skills. Командой tokentracker status --json статус забирают скрипты и агенты. Командой tokentracker uninstall снимают все хуки и удаляют локальные данные.
Для кого. Для разработчиков, которые одновременно работают в нескольких ИИ-агентах и хотят видеть общий расход токенов в долларах, не отдавая промпты и код никому.
Подходит, если
- Вы платите за Claude Code, Codex и Cursor одновременно, и нужно понять, какая из подписок и какая модель съедает больше всего
- Хочется видеть расход по проектам и по дням в виде тепловой карты, строки лога вам не нужны
- Нужен недорогой способ следить за лимитами провайдеров: панель показывает окна квот Claude, Codex, Cursor и других
- Скрипту или агенту нужен машиночитаемый статус: tokentracker status --json отдает сводку для jq
- Агенты работают на сервере по SSH или в CI: tokentracker status --light печатает простую ASCII-таблицу без анимации
Не подходит, если
- Нужен подробный терминальный отчет по сессиям и блокам: у TokenTracker консольная часть базовая, а упор сделан на панель и приложения
- На машине нет Node.js 20 или новее, и ставить его нельзя
- Нельзя менять конфигурацию агентов: при первом запуске программа сама дописывает хуки в настройки Claude Code, Codex и других
- Нужна точная стоимость модели, у которой нет опубликованной цены: такие модели считаются по токенам, а их стоимость показывается как 0 долларов
Пример запроса к агенту
Запусти tokentracker status --json и скажи, на какой модели я потратил больше всего за эту неделю.Ограничения
- Нужен Node.js 20 или новее.
- Первый запуск записывает хуки в конфигурацию агентов, снять их можно командой tokentracker uninstall.
- Стоимость моделей без опубликованной цены показывается как 0 долларов, токены при этом считаются.
- По умолчанию программа обращается в сеть: проверка квот у провайдеров по уже имеющимся на машине данным входа, обновление цен, проверка обновлений и анонимная телеметрия. Телеметрию отключают переменной TOKENTRACKER_NO_TELEMETRY=1 или DO_NOT_TRACK=1.
- Облачная синхронизация и общий рейтинг работают только по явному согласию.
Как отключить. Выполните tokentracker uninstall: команда снимет хуки во всех найденных агентах и удалит локальные настройки и данные. Ее безопасно запускать повторно. Если ставили через Homebrew или npm, удалите и сам пакет.
Частые вопросы
Как посчитать токены и расходы в Claude Code и Codex сразу?
Выполните npx tokentracker-cli. Первый запуск добавит хук SessionEnd для Claude Code и запись notify для Codex, прочитает логи и откроет панель на localhost:7680 с общим расходом по моделям и проектам.
Читает ли TokenTracker мои промпты и код?
Нет. По словам автора, программа извлекает из локальных логов только число токенов, время и названия моделей. Промпты, ответы и код не сохраняются и не отправляются. Логика разбора лежит в файле src/lib/rollout.js, ее можно проверить.
Чем TokenTracker отличается от ccusage?
Автор сравнивает так: у ccusage сильнее консольные отчеты, а у TokenTracker панель, приложения для macOS, Windows и Linux, четыре виджета, отслеживание лимитов и необязательный общий рейтинг.
Как удалить TokenTracker и его хуки?
Команда tokentracker uninstall снимает все хуки в найденных агентах и удаляет локальные настройки и данные. Команда безопасна при повторном запуске.
Какие агенты поддерживает TokenTracker?
Больше сорока инструментов, среди них Claude Code, Codex CLI, Cursor, Gemini CLI, GitHub Copilot, OpenCode, Goose, Cline и Roo Code. Для Claude Code, Codex и Gemini CLI пишутся хуки, остальные читаются из файлов сессий. Лимиты провайдеров панель показывает для ряда инструментов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСчитает токены и стоимость сессий Claude Code и Codex по локальным журналам и показывает остаток лимитов в статусной строке
Отчеты по токенам и стоимости Claude Code, Codex, Gemini CLI и других агентов по локальным логам: по дням, месяцам и сессиям
CLI и MCP-сервер, которые считают расход токенов по 41 инструменту и агенту, показывают трату по проекту и модели и помогают срезать лишние токены
Локальный просмотр, поиск и учет расходов по сессиям Claude Code, Codex и других агентов в одном веб-интерфейсе
Yandex Tracker CLI
tracker
Консольная утилита tracker для Яндекс Трекера с JSON-выводом и готовым SKILL.md с рабочим циклом для агента
CLI и скилл для Яндекс Трекера и Вики: короткий человеко- и агенто-читаемый вывод вместо сырых ответов MCP на тысячи токенов
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| TokenTracker (эта запись) | нет | 2 149 | |
| ccusage | нет | 19 238 | консольные отчеты по токенам из логов, а у TokenTracker панель, приложения и виджеты |
| Claude Code Usage Monitor | нет | 8 781 | терминальный монитор окна лимитов Claude Code, а эта запись охватывает десятки агентов |
| Claude Usage | нет | 2 282 | локальная панель по логам одного Claude Code, а TokenTracker собирает много агентов |
Коротко о README
README показывает быстрый старт одной командой npx и перечисляет варианты установки: npm, Homebrew, образы для macOS, Windows и Linux. Дальше идут возможности: панель, движок цен, лимиты провайдеров, виджеты, достижения и необязательные облачные функции. Таблица описывает, как программа подключается к каждому из поддерживаемых инструментов. Отдельные разделы посвящены приватности, переменным окружения, поиску сессий в WSL, устранению неполадок и удалению.