Трекер токенов Claude Code: куда уходят лимиты и деньги

Если Claude Code упёрся в лимит посреди работы и непонятно, на что ушли токены, поставь трекер ccusage. Это бесплатная утилита, которая читает локальные логи Claude Code и показывает прямо в терминале, сколько токенов и денег ты потратил - по дням, по проектам, по сессиям. Запускается одной командой npx ccusage@latest, ничего не устанавливает в систему и не отправляет данные наружу. На GitHub у неё больше 16 тысяч звёзд, так что инструмент рабочий и живой.

Дальше - что именно она показывает, точные команды и мой прогон на своих логах.

Почему лимиты Claude Code кончаются незаметно

Claude Code не показывает счётчик расхода по умолчанию. Ты пишешь промпты, агент читает файлы, гоняет инструменты, держит контекст - и каждое сообщение жжёт токены, в том числе на кэш. В какой-то момент прилетает сообщение про лимит, и ты сидишь без понимания, что именно его съело.

Anthropic считает расход в двух разрезах. Есть 5-часовое скользящее окно: счётчик стартует с первого промпта и сбрасывается через 5 часов. И есть недельный потолок. Окно не привязано к часам на стене - первый промпт в 10:00 значит, что окно закроется в 15:00, сколько бы ты ни написал внутри. Из-за этого расход ощущается рвано: вчера хватало, сегодня уткнулся к обеду.

Трекер не поднимает лимит. Он показывает, куда уходит бюджет, чтобы ты видел картину и не упирался вслепую.

Что такое ccusage и что он показывает

ccusage - это CLI-утилита (автор ryoppippi), которая анализирует расход Claude Code из локальных лог-файлов. Claude Code сам пишет каждую сессию в формате JSONL: папка ~/.claude/projects/, на Windows это %USERPROFILE%\.claude\projects\. Внутри каждого ответа модели лежит блок с количеством токенов: входные, выходные, чтение кэша, создание кэша. ccusage эти файлы парсит и сводит в читаемые таблицы.

Что выдаёт:

• по дням - сколько токенов и долларов ушло каждый день;
• по неделям и месяцам - агрегат за период;
• по сессиям - расход в разрезе отдельных диалогов;
• по 5-часовым окнам (команда blocks) - те самые биллинговые окна Anthropic, с burn rate (токенов в минуту) и прогнозом, сколько добьёшь к концу окна.

Стоимость считается в долларах рядом с токенами, так что видно не только объём, но и деньги.

Три факта, ради которых ему можно доверять

ccusage устроен максимально безопасно, и это написано в его документации прямым текстом:

1. 100% локально. Весь анализ идёт на твоей машине.
2. Ничего не уходит наружу. Данные о расходе не покидают компьютер.
3. Только чтение. Утилита читает файлы и никогда их не меняет.

Инструмент бесплатный, с открытой лицензией (в документации указан MIT). Это не сервис с регистрацией и не расширение, которое лезет в аккаунт. Это локальный парсер твоих же логов.

Как запустить трекер токенов Claude Code

Самый быстрый способ - запустить без установки через npx. Открой терминал и набери:

npx ccusage@latest

При первом запуске npx скачает пакет во временную папку и сразу выполнит. Никакой глобальной установки, ничего не остаётся в системе после закрытия.

Если у тебя стоит bun или pnpm - есть альтернативы, работают так же:

bunx ccusage
pnpm dlx ccusage

Основные команды (отчёты):

npx ccusage@latest daily     # расход по дням
npx ccusage@latest weekly    # по неделям
npx ccusage@latest monthly   # по месяцам
npx ccusage@latest session   # по отдельным сессиям
npx ccusage@latest blocks    # по 5-часовым биллинговым окнам

Команда daily выдаёт таблицу с датой, моделями, количеством токенов по типам и стоимостью в долларах. blocks показывает текущее 5-часовое окно с burn rate (🔥 Rate, токенов в минуту) и прогнозом (📊 Projected, сколько накопится к концу окна, если темп не изменится) - это самое полезное, когда хочешь понять, дотянешь ли до конца задачи без лимита.

Если хочешь, чтобы расход висел в строке статуса Claude Code в реальном времени, у ccusage есть интеграция через statusline. Раньше для этого был флаг blocks --live, но в версии 18.0.0 его убрали и заменили на statusline-команду - так что старые гайды с --live уже неактуальны.

Мой прогон: что получилось у меня

Я запустил npx ccusage@latest daily на своих логах. Скачивание и первый вывод - меньше минуты, никаких ключей и логинов, утилита просто нашла папку с логами и нарисовала таблицу.

Что увидел и чего не ожидал: основной расход шёл не на «умные» рассуждения, а на кэш контекста. Когда гоняешь агента по большому репозиторию, он перечитывает файлы и держит их в контексте, и create/read кэша набегает в разы больше, чем то, что я реально напечатал руками. По проектам тоже стало видно перекос - один репозиторий, где я много экспериментировал с автотестами, съел заметно больше остальных вместе взятых.

Практический вывод после этого: длинные сессии без перезапуска и работа в раздутом контексте - главные пожиратели лимита. Когда вижу, что burn rate в blocks высокий, я чаще чищу контекст и дроблю задачу. Лимита стало хватать дольше без всякой магии - просто потому, что теперь видно цифру, а не догадки.

ccusage против ручного чтения логов

Логи лежат локально, и теоретически их можно читать руками. На практике это боль: JSONL-файлы по сессиям, имена папок - закодированные пути проектов, токены раскиданы по блокам внутри каждого сообщения.

Смысл утилиты в том, что она снимает ровно эту рутину. Тебе не нужно знать формат логов - нужно знать одну команду.

Частые вопросы

Сколько токенов тратит Claude Code за сессию?

Зависит от размера контекста и числа инструментов, но порядок видно только по факту - запусти npx ccusage@latest session и посмотри свои реальные цифры. По моему опыту, основная масса уходит не на твои сообщения, а на чтение и кэширование файлов проекта, когда агент работает по большому репозиторию.

ccusage бесплатный и безопасный?

Да, бесплатный, лицензия открытая (в документации указан MIT). Безопасный: по документации работает 100% локально, ничего не отправляет в сеть и только читает файлы, не меняя их. Это парсер твоих собственных логов, а не сервис с доступом к аккаунту.

Нужно ли что-то устанавливать?

Нет. Через npx ccusage@latest пакет скачивается во временную папку, выполняется и не оседает в системе. Если есть bun или pnpm - можно bunx ccusage или pnpm dlx ccusage. Никакой регистрации и ключей.

Где Claude Code хранит логи расхода?

В папке ~/.claude/projects/, на Windows - %USERPROFILE%\.claude\projects\. Там лежат JSONL-файлы по сессиям, в каждом ответе модели есть блок с токенами. ccusage читает именно их.

Можно ли поднять лимит через трекер?

Нет. ccusage не меняет лимиты Anthropic - он только показывает расход. Зато, когда видишь, на что уходит бюджет, легче растянуть лимит: чистить контекст, дробить задачи, не держать раздутую сессию часами.

Работает ли ccusage только с Claude Code?

Нет, он понимает несколько CLI-агентов (Claude Code, Codex, OpenCode, Gemini CLI и другие). Для Claude Code достаточно общих команд daily/session/blocks - утилита сама найдёт нужные логи. Если хочешь явно ограничить отчёт одним источником, можно добавить namespace: ccusage claude daily.

Вывод

Лимиты и счёт за токены перестают быть лотереей, как только ты их видишь. ccusage даёт эту видимость за одну команду npx ccusage@latest, без установки, бесплатно и не вынося твои данные наружу. Запусти daily и blocks - и сразу станет понятно, какой проект и какой режим работы съедают бюджет.

Это один маленький инструмент из связки, на которой строится нормальная работа в Claude Code. Если ты только начинаешь, сначала глянь с чего начать в Claude Code. Рядом полезно глянуть, как такими же подходами решать реальные задачи - например, как собрать личную базу знаний на Obsidian и Claude Code или как собрать свою CRM за час вместо amoCRM.