Как проверить использование токенов Claude Code: 4 способа увидеть, что тратят ваши агенты

Если вы запускаете Claude Code более нескольких минут в день, токены становятся вашей настоящей валютой. Они определяют, когда вы достигнете лимита скорости, насколько быстро вы израсходуете подписку и стоило ли длительное выполнение агента. Проблема в том, что Claude Code не сообщает вам количество токенов. Вам нужно пойти и посмотреть.

Вот четыре способа проверить использование токенов Claude Code: от самого быстрого встроенного команды до живого счетчика, показывающего каждого агента в реальном времени. Выберите тот, который соответствует вашей потребности в детализации.

1. Самый быстрый способ: /usage, /context и строка состояния

В любой сессии Claude Code введите:

/usage

Claude Code выводит использование токенов в текущей сессии и, на тарифе Claude.ai, остаток вашей квоты: лимиты использования на 5 часов и на 7 дней, а также какую часть контекстного окна вы уже заняли. /cost и /stats по-прежнему работают, это псевдонимы той же команды. Её можно запустить, пока Claude отвечает, цифры появятся, не прерывая ответ (до версии v2.1.234 команда ждала конца хода).

Хотите увидеть контекстное окно подробно, а не одним процентом? Введите /context: окно рисуется в виде цветной сетки, и помечается то, что его съедает, инструмент со слишком тяжёлым выводом, разросшийся файл памяти, сессия на пределе ёмкости.

У обеих команд один и тот же подвох: их нужно вводить вручную, и они видят только ту сессию, в которой вы находитесь. Ничто не скажет вам, сколько вы потратили вчера или во сколько обошёлся другой проект. Если вам нужна цифра, которая остаётся на экране, используйте строку состояния. Попросите Claude Code написать её за вас:

/statusline show model name and context percentage with a progress bar

Он создаст скрипт в ~/.claude/ и подключит его к вашим настройкам. Если предпочитаете написать его сами, добавьте запись statusLine в ~/.claude/settings.json. Скрипт получает на stdin объект JSON с context_window.used_percentage, cost.total_cost_usd и, для подписчиков Pro и Max, rate_limits.five_hour.used_percentage. Одной строки достаточно:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
  }
}

Строка состояния обновляется после каждого ответа API, поэтому процент меняется, пока идёт сессия. Это по-прежнему одна сессия на терминал: за историей или сразу за несколькими агентами читайте дальше.

2. Чтение из источника: транскрипты сессий

Claude Code записывает каждую сессию на диск в виде транскрипта JSONL. На macOS и Linux вы найдете их здесь:

~/.claude/projects/<encoded-project-path>/<session-id>.jsonl

Каждая строка: это одно сообщение, и сообщения ассистента содержат объект usage с точными подсчетами: input_tokens, output_tokens и поля кэша (cache_creation_input_tokens, cache_read_input_tokens). Чтения из кэша: это интересная часть: они намного дешевле, чем свежий ввод, поэтому сессия с высоким уровнем попадания в кэш стоит намного меньше, чем предполагает общее количество токенов.

Это основа. Все остальные инструменты, включая два ниже, читают эти же файлы. Если вы хотите написать свой собственный отчет, jq по JSONL поможет вам в этом.

3. Специальная CLI: ccusage

Если вы не хотите писать свой собственный парсер, инструмент сообщества ccusage читает эти транскрипты и сворачивает их в ежедневные, ежемесячные и по-сессионные итоги:

npx ccusage@latest

Это хороший компромисс: больше истории, чем /usage, меньше работы, чем ручное использование jq. Однако он остается в терминале, поэтому отвечает на вопрос "что я потратил", но не "какой агент, прямо сейчас, это тратит".

4. Живой счетчик: использование по сессии в AgentsRoom

Три вышеупомянутых метода имеют один слепой угол: они работают после факта и для одного потока. В момент, когда вы запускаете несколько агентов параллельно, вы хотите видеть использование по агенту, в реальном времени, без ввода команды в каждом терминале.

Именно это и делает счетчик использования токенов Claude Code в AgentsRoom. Он читает те же транскрипты JSONL, по сессии, и отображает:

• входные, выходные и кэшированные токены по агенту, обновляясь по мере выполнения сессии
• уровень попадания в кэш, чтобы вы могли видеть, когда контекст повторно используется, а не пересылается
• предупреждение перед тем, как сессия приблизится к лимиту скорости

Поскольку он атрибутирует использование по сессии, он остается корректным даже когда вы запускаете несколько аккаунтов Claude Code параллельно: каждый аккаунт ведет свои собственные итоги, что упрощает перерасчет для клиента.

Какой из них использовать

• Нужна только цифра этой сессии или остаток вашей квоты? /usage, и строка состояния, если хотите видеть её постоянно.
• Хотите написать пользовательский отчет? Читайте транскрипты JSONL напрямую.
• Нужны ежедневные и ежемесячные итоги в терминале? ccusage.
• Запускаете несколько агентов и хотите следить за использованием в реальном времени, по агенту и аккаунту? Используйте счетчик в AgentsRoom.

Проверка использования: это первый шаг. Если цифры заставляют вас морщиться, следующий шаг: их уменьшение: смотрите как снизить затраты на токены Claude Code для рычагов, которые действительно имеют значение, начиная с повторного использования кэша.