Claude Usage Tracker

Что такое Claude Usage Tracker?

Claude Usage Tracker — локальный инструмент, который автоматически обнаруживает и агрегирует затраты на использование Claude AI в нескольких локальных инструментах разработки. Он сканирует известные директории данных, разбирает JSONL/лог-файлы, рассчитывает затраты по ценам конкретных моделей и отображает результаты в интерактивном дашборде.

Основная цель — отслеживание и визуализация затрат, чтобы вы могли анализировать расходы по источникам, моделям и периодам без отправки данных в облако. Всё работает на вашей машине, а дашборд построен на Chart.js.

Ключевые возможности

• Автообнаружение 9+ инструментов с интеграцией Claude и объединение данных использования для единого обзора.
• Расчёт затрат по ценам за миллион токенов для семейств моделей Anthropic (Opus, Sonnet, Haiku), включая input/output и чтение/запись кэша, где применимо.
• Тёмный интерактивный дашборд на Chart.js с визуальными графиками и разбивками.
• Отслеживание затрат по времени с видами за день, неделю, месяц и всё время.
• Аналитика по моделям и источникам, включая разбивку затрат по моделям и фильтры (источник, модель, диапазон дат, мин. стоимость).
• Визуализация пиковых паттернов через тепловые карты и два вида: Peak Hours (сетка день × час) и Peak Days (календарь в стиле GitHub).
• Детали на уровне сессий, включая расширяемый лог сессий с карточками источников по цветам, выделением затрат по сессиям (например, самая дорогая сессия) и панелью деталей сессии.
• Прогноз cadence проектов с monthly projections на основе текущего темпа расходов.
• Опция сборки macOS-приложения для создания автономного .app с запуском двойным кликом.

Как использовать Claude Usage Tracker

1. Установите и запустите последнюю релизную версию (рекомендуется) или инструмент локально из исходников.
2. Запустите сканирование для сбора данных и отображения дашборда: macOS-приложение собирает свежие данные и показывает интерактивный дашборд, а браузерный режим запускает локальный сервер и загружает dashboard.html.
3. Изучите дашборд, чтобы просмотреть общие затраты и разбить их по источникам/моделям и периодам с помощью доступных графиков, тепловых карт и фильтров.

Варианты быстрого старта (из репозитория):

• macOS (Apple Silicon/Intel): скачайте последнюю релизную версию, разархивируйте, переместите Claude Usage Dashboard.app в Applications, затем запустите двойным кликом.
• Сборка из исходников: клонируйте репозиторий, выполните ./build-app.sh, затем запустите собранное приложение двойным кликом.
• Браузерный режим (любой OS): выполните node collect-usage.js, запустите локальный сервер с python3 -m http.server 8765 и откройте http://localhost:8765/dashboard.html.

Сценарии использования

• Объединение расходов по нескольким инструментам Claude: Если вы используете несколько локальных интеграций (например, Cursor, Windsurf, Claude Desktop и Continue.dev), трекер объединяет использование из этих источников в один дашборд.
• Определение пиков расходов: Используйте Peak Hours (тепловая карта день × час) и календарь Peak Days, чтобы выявить время и дни с самыми дорогими сессиями.
• Аудит конкретных сессий или дней: Разверните лог сессий за дату, чтобы проверить затраты по сессиям, увидеть разбивку токенов и историю разговоров в панели деталей сессии.
• Сравнение изменений день в день: Используйте Yesterday Delta для быстрого сравнения сегодняшних расходов с вчерашними.
• Планирование ожиданий на месяц: Просмотрите Monthly Projections, чтобы оценить прогнозируемые месячные затраты на основе текущего темпа.

FAQ

• Отправляет ли трекер данные использования на сервер? Нет. В описании проекта указано «No cloud» и «No telemetry», всё остаётся на вашей машине.

• Какие инструменты поддерживаются? Репозиторий перечисляет использование Claude из OpenClaw/Clawdbot, Claude Code CLI, Claude Desktop (local agent mode), Cursor, Windsurf, Cline, Roo Code, Aider и Continue.dev. Обнаружение инструментов автоматическое.

• Какие форматы данных читает? Сканирует известные директории и разбирает JSONL/лог-файлы; раздел поддерживаемых инструментов указывает JSONL для каждого.

• Что если инструмент не установлен или нет данных? Поведение обнаружения: если инструмент не установлен или нет данных, он пропускается молча.

• Как рассчитываются затраты? Затраты рассчитываются по ценам Anthropic за миллион токенов для поддерживаемых семейств моделей (Opus, Sonnet, Haiku) на основе input/output и чтения/записи кэша, где указано.

Альтернативы

• Анализ локальных логов + таблицы: Экспортируйте или соберите логи использования Claude и рассчитайте затраты вручную в таблице. Это ручной процесс по сравнению с интерактивным дашбордом, но подходит для кастомных рабочих процессов.
• Дашборды использования от вендоров (если доступны): Некоторые провайдеры предлагают просмотры использования для биллинга/отчетности. Они обычно фокусируются на одном продукте/аккаунте, а не агрегируют по нескольким локальным инструментам.
• Общие инструменты аналитики времени/затрат разработчиков: Инструменты, анализирующие активность IDE или рассчитывающие затраты по событиям использования, могут помочь, но не моделируют ценообразование Claude по токенам и не парсят форматы хранения каждого инструмента автоматически.
• Другие локальные дашборды мониторинга: Смежные инструменты, визуализирующие локальные логи в браузере, дают похожие графики, но требуют подготовки данных, а не полагаются на автоопределение и парсинг JSONL трекера.