Як перевірити використання токенів 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 для важелів, які дійсно мають значення, починаючи з повторного використання кешу.