Token Tracker CLI
Считает токены и стоимость сессий Claude Code и Codex по локальным журналам и показывает остаток лимитов в статусной строке
- 535 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Правит настройки агентов: подключает statusLine в Claude Code и хуки в Codex и Kimi Code, которые срабатывают при каждом ответе и промпте
- Читает журналы сессий, где лежит полный текст ваших промптов
- Ставится скриптом curl с передачей в bash, который выбирает способ установки сам
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/token-trackerОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Правит настройки агентов: подключает statusLine в Claude Code и хуки в Codex и Kimi Code, которые срабатывают при каждом ответе и промпте
- Читает журналы сессий, где лежит полный текст ваших промптов
- Ставится скриптом curl с передачей в bash, который выбирает способ установки сам
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Token Tracker читает локальные журналы сессий Claude Code, Codex и Kimi Code и показывает расход токенов, эквивалентную стоимость и остаток лимитов. Команда tt без аргументов рисует тепловую карту за год в стиле GitHub. Команда tt status выводит сводку за сегодня с квотами на 5 часов и 7 дней, а tt weekly, tt monthly и tt sessions строят отчеты по неделям, месяцам и отдельным сессиям. Команда tt setup подключает статусную строку. В Claude Code она работает через официальный интерфейс statusLine и показывает проект, ветку, токены сессии, стоимость, остаток квоты и заполнение контекстного окна. У Codex своей статусной строки нет, поэтому после каждого ответа Token Tracker дописывает две строки текста через хук Stop. В Kimi Code подключается интерфейс status_line. Команда tt sidebar открывает узкую панель со всеми активными сессиями: состояние, последние промпты и подсказка следующего шага. Щелчок по сессии переключает на нужную панель iTerm2 или tmux. Цены инструмент берет из LiteLLM, а без сети пользуется таблицей, встроенной в пакет.
Для кого. Разработчикам, которые работают в Claude Code, Codex или Kimi Code и хотят видеть расход токенов и остаток лимитов, не открывая веб-кабинет.
Подходит, если
- Вы на подписке Claude Code или Codex и хотите видеть остаток лимита прямо в статусной строке
- Нужно понять, какой проект и какая модель съедают больше всего токенов: tt monthly раскладывает расход по проектам и моделям
- Вы ведете несколько сессий в iTerm2 или tmux, и tt sidebar подсказывает, какая из них ждет вашего ответа
- В Codex нужен хотя бы текстовый индикатор расхода после каждого ответа
- Агент работает через стороннего провайдера API, например DeepSeek, и нужна оценка стоимости сессии по тарифу
Не подходит, если
- Нужна точная выписка по счету: стоимость в отчетах эквивалентная, ее считают по публичным тарифам
- Вы пользуетесь другим агентом: встроены адаптеры только для Claude Code, Codex и Kimi Code
- Нужна общая аналитика расхода по всей команде: Token Tracker видит только журналы вашей машины
- Вы уже настроили собственную statusLine в Claude Code и хотите оставить ее без изменений: в мастере можно отказаться от подключения, но тогда в tt status не будет квоты подписки
Пример запроса к агенту
Поставь Token Tracker, подключи статусную строку в Claude Code и покажи, сколько токенов ушло на каждый проект за эту неделюОграничения
- Нужен Python 3.11 или новее.
- Квоты есть только у подписки. В режиме API статусная строка показывает лишь заполнение контекста.
- Квота Claude Code попадает на диск только через статусную строку, поэтому без ее подключения tt status не видит этих данных.
- Хук статуса в Codex выводит простой текст без цветов. Незнакомые хуки Codex просит подтвердить командой /hooks.
- Для разбивки окна на лету нужны iTerm2, Ghostty 1.3.0 или новее либо tmux. На macOS при первом запуске система запросит разрешение на управление терминалом.
- Для незнакомой модели цена может не найтись, тогда инструмент пишет, что тариф неизвестен.
Как отключить. Команда tt unsetup убирает статусные строки, хуки и скиллы, которые поставил tt setup, и возвращает прежние настройки агентов. Сам пакет после этого удаляйте тем же способом, которым ставили, например через pip uninstall token-tracker.
Частые вопросы
Как поставить Token Tracker для Claude Code?
Выполните команду curl -sSL https://raw.githubusercontent.com/stormzhang/token-tracker/main/install.sh | bash: скрипт сам выберет uv, pipx или отдельное виртуальное окружение. Затем запустите tt setup и пройдите мастер: язык, тема и согласие на подключение статусной строки Claude Code. Обновляется он повторным запуском той же команды.
Как увидеть остаток лимита Claude Code в статусной строке?
После tt setup вторая строка статусной панели показывает квоту на 5 часов и на 7 дней с обратным отсчетом до сброса. Рядом идут размер контекстного окна и его заполнение.
Как показать расход токенов в Codex?
У Codex нет настраиваемой статусной строки, поэтому tt setup ставит хук Stop, и после каждого ответа появляются две строки с проектом, веткой, токенами сессии, моделью, квотами и контекстом. Начиная с Codex 0.156.0 цветовые коды в хуках отфильтровываются, и строки идут без цвета.
Отправляет ли Token Tracker мои данные в сеть?
Данные хранятся локально, журналы агентов инструмент только читает, телеметрии нет. В сеть ходят две вещи: актуальные цены с LiteLLM и облачный запрос лимитов Kimi Code, который обновляется раз в 2 минуты.
Как открыть боковую панель текущей сессии Codex?
Введите в Codex команду $tt-sidebar, ее скилл ставит tt setup. Справа откроется панель шириной в треть окна, где полные промпты идут от новых к старым. Хук в Codex после установки нужно доверить командой /hooks.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыTokenTracker считает токены и расходы в Claude Code, Codex, Cursor, Gemini CLI и других агентах по локальным логам и показывает их на панели localhost:7680
Отчеты по токенам и стоимости Claude Code, Codex, Gemini CLI и других агентов по локальным логам: по дням, месяцам и сессиям
Терминальный монитор расхода Claude Code в реальном времени: токены, сообщения и стоимость в пятичасовом окне, прогноз и экспорт
Плагин для Claude Code: строка статуса с контекстом, лимитами за 5 часов и 7 дней, стоимостью и расходом Codex, Gemini и z.ai
CLI и MCP-сервер, которые считают расход токенов по 41 инструменту и агенту, показывают трату по проекту и модели и помогают срезать лишние токены
Статусная строка для Claude Code: расход токенов и денег, остаток контекста, лимиты и ветка git в четырех стилях и шести темах
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Token Tracker (эта запись) | нет | 535 | |
| ccusage | нет | 19 251 | только отчеты по журналам в терминале, без статусной строки и боковой панели |
| ccstatusline | нет | 13 462 | настраиваемая статусная строка только для Claude Code |
| Claude HUD | нет | 29 003 | плагин с контекстом, инструментами и субагентами в статусной строке Claude Code, без отчетов по стоимости |
Коротко о README
Основная версия README написана по-китайски, английская лежит в README_EN.md. Страница идет от списка возможностей и скриншотов отчетов к разделам про статусные строки, боковую панель, установку, шесть цветовых тем и таблицу путей, откуда инструмент читает журналы.