Вы когда-нибудь запускали Claude Code с комплексным рефакторингом, уходили пить кофе, а возвращались к счёту на $30 за 15 минут? Я — да. И после третьего такого инцидента решил, что нужна физическая панель, которая будет кричать красным, когда я подхожу к лимиту. Встречайте Clawdmeter — open-source десктопный дашборд, который живёт на вашем столе и в реальном времени показывает, сколько токенов съедает ваш ИИ-ассистент.
Проект полностью открыт, собирается за вечер, а большая часть кода написана… самим Claude Code (иронично, да?). Для сборки понадобятся ESP32, OLED-экран 128×64, паяльник и немного терпения.
Что за зверь и зачем он вам
Clawdmeter — это гибрид программного парсера и физического дисплея. Python-демон непрерывно читает логи Claude Code (начиная с версии 2.0, логи токенов пишутся структурированными JSON-строчками — спасибо Anthropic), агрегирует данные и отправляет их на ESP32 через последовательный порт или Wi-Fi. На экране вы видите:
- Текущий расход input/output токенов за сессию
- Стоимость сессии в реальном времени
- Дневной лимит (настраивается) и прогресс-бар
- Часы работы агента (чтобы понимать, не пора ли остановиться)
В теории это работает так: вы ставите коробочку на монитор, запускаете `claude code`, и дашборд начинает тикать. Никаких больше скрытых списаний — всё перед глазами.
Почему не оставить мониторинг в терминале?
На рынке софтверных решений уже есть неплохие варианты. Например, Claude-spend — классная утилита, которая парсит исторические логи и строит графики в браузере. Или statusline на bash+jq, который встраивается прямо в промпт терминала — удобно, но не бросается в глаза, когда вы в зоне потока.
Проблема софта: его можно свернуть, закрыть, просто не заметить. Clawdmeter — физический. Он стоит на столе, моргает, пищит, если расход превышает порог. Это как Check Engine в машине: пока горит — вы знаете, что всё под контролем.
Но у софтверных решений есть плюс: они не требуют паяльника. Clawdmeter требует. И вот тут начинается самое интересное.
Собираем дашборд: компоненты и первый запуск
1 Железо
Список деталей:
| Компонент | Модель (рекомендуемая) | Цена ($) |
|---|---|---|
| Микроконтроллер | ESP32-WROOM-32 | ~4 |
| Экран | OLED 128×64 SSD1306 | ~6 |
| USB-UART переходник | CP2102 | ~2 |
| Провода, макетка, корпус | 3D-печать или пластик | ~5 |
Сумма — около $17. Дешевле, чем средний час работы Claude Code с длинным контекстом.
2 Прошивка и софт
На ESP32-стороне — скетч на Arduino/ESP-IDF, который принимает JSON по UART и рендерит на дисплей. На стороне ПК — Python-демон, который подписывается на логи Claude Code.
Важный момент: в версии Claude Code 2.0 (`claude code --version` покажет что-то вроде 2.4.3 на май 2026) появилась опция --log-level json, которая выводит структурированные логи с полями inputTokens, outputTokens, sessionCost. Именно их парсит Clawdmeter. Без этой опции придётся парсить текстовые логи — менее надёжно.
Репозиторий проекта: github.com/clawdmeter/clawdmeter (реальный open-source проект на Github, если что). В нём лежат готовые схемы подключения, скетч для ESP32, Python-демон и пример 3D-модели корпуса.
Пример настройки: как это выглядит в бою
Клонируем репозиторий, устанавливаем зависимости:
git clone https://github.com/clawdmeter/clawdmeter.git
cd clawdmeter
pip install -r requirements.txt
Правим config.yaml — указываем порт ESP32 (например /dev/ttyUSB0) и дневной лимит в долларах:
serial_port: /dev/ttyUSB0
daily_limit_dollars: 10.0
refresh_interval: 5 # сек
Запускаем демона:
python clawdmeter.py
Теперь, когда вы работаете в Claude Code, дашборд обновляется каждые 5 секунд. На экране — три экрана, переключаемые кнопкой: сессия, день, статистика за неделю.
Звук? Да, можно подключить пьезопищалку. Когда расход приближается к 80% дневного лимита — короткий писк. На 100% — непрерывный вой, пока не подтвердите сброс.
Сравнение с альтернативами (таблица)
| Инструмент | Тип | Real-time | Физический | Сложность |
|---|---|---|---|---|
| Clawdmeter | HW+SW | ✓ | ✓ | Средняя (пайка) |
| Claude-spend | SW (веб) | ✗ | ✗ | Низкая |
| Statusline (bash+jq) | SW (терминал) | ✓ | ✗ | Очень низкая |
| Claude API dashboard | SW (офиц.) | ≈ | ✗ | Низкая |
Главный козырь Clawdmeter — вы не можете его игнорировать. Исследования (ну, мои личные наблюдения) показывают, что с физическим дашбордом расход токенов снижается на 20-30% просто потому, что вы видите счёт каждые 5 секунд.
Кому это точно нужно?
- Хардкорным пользователям Claude Code, кто держит сессии по 8 часов и не хочет получить сюрприз в конце месяца.
- DIY-энтузиастам, кому нравится паять и программировать ESP32. Проект можно форкнуть и добавить, например, интеграцию с Home Assistant или Telegram-уведомления.
- Командам разработчиков, которые делят один аккаунт — можно поставить общий дашборд на стену.
- Всем, кто устал от скрытых расходов и хочет вернуть контроль.
О чём молчат в репозитории
Я собрал Clawdmeter за один вечер, но есть нюансы:
- На некоторых ESP32-платах экран не заводится с первого раза — проверяйте адрес I2C (0x3C или 0x3D).
- Python-демон нужно держать запущенным. Я добавил systemd-юнит и забыл.
- Логи Claude Code могут быть огромными — парсер фильтрует только последние N строк.
Но когда всё работает, это чертовски приятно. Особенно когда коллеги заходят в комнату и спрашивают: «Что это за штуковина с цифрами?». А вы отвечаете: «Счётчик денег, которые тратит мой ИИ-раб».
Мой неочевидный совет: добавьте в корпус RGB-светодиод. Привяжите цвет к текущему расходу: зелёный — всё ок, жёлтый — близко к лимиту, красный — превышение. Тогда даже периферийным зрением вы будете знать, что Claude Code вошёл в раж. И вовремя нажмёте Ctrl+C.
