CodeLedger: Открытый плагин Claude Code отслеживает использование токенов и фоновые агенты

Что делает CodeLedger

CodeLedger — это плагин с открытым исходным кодом для Claude Code (сервер MCP), который автоматически отслеживает использование токенов, затраты на проекты и активность фоновых агентов. Он был создан после анализа 77 сессий Claude Code в 8 проектах на плане Max 20x, что выявило значительное потребление токенов фоновыми агентами.

Какую проблему он решает

Встроенная команда /cost в Claude Code показывает только данные текущей сессии. Нет встроенного способа увидеть:

• Историю по проектам
• Разбивку по агентам
• Что потребляют фоновые агенты
• Какая модель используется для какой задачи

Когда вы закрываете терминал, этот контекст исчезает навсегда.

Ключевые выводы из анализа

• Эквивалент $2,061 стоимости API за 77 сессий, 8 проектов
• Самый дорогой проект: $955 в токенах для побочного проекта
• 233 фоновых агента потребили 23% расходов на токены агентов
• 57% вычислений выполнялось на Opus, включая задачи вроде поиска файлов, с которыми Sonnet справляется хорошо
• Одна сессия породила 100+ фоновых агентов, потребив токены на сумму $80+

Обнаруженные паттерны фоновых агентов

• Агенты acompact-* запускаются автоматически для сжатия контекста, когда беседы становятся длинными, используя любую модель вашей сессии (включая Opus)
• Агенты aprompt_suggestion-* генерируют предложения по промптам и часто появляются в длинных сессиях
• Нет встроенного способа отличить «агентов, которых я запросил» от «системных фоновых агентов» без анализа префиксов agentId в JSONL

Функции CodeLedger

• Отслеживание затрат по проектам во всех сессиях
• Разбивка по агентам, показывающая, какие агенты потребили больше всего токенов
• Обнаружение накладных расходов, отделяющее ваших кодирующих агентов от фоновых агентов acompact-* и aprompt_suggestion-*
• Рекомендации по оптимизации моделей
• Диалоговые запросы — спросите «сколько я потратил на этой неделе на проект X?»

Как это работает

• Подключается к событиям SessionEnd и анализирует локальные JSONL-файлы
• Фоновый сканер перехватывает сессии, где хуки не были активны
• Хранит всё в локальной базе данных SQLite (~/.codeledger/codeledger.db) — никаких облачных сервисов, никакой телеметрии
• Предоставляет инструменты MCP: usage_summary, project_usage, agent_usage, model_stats, cost_optimize

Установка

npm install -g codeledger

Инструмент всё ещё ожидает одобрения в Anthropic Marketplace, но установка через npm работает напрямую.