Ccusage

ccusage – это мощный инструмент командной строки (CLI), разработанный для обеспечения необходимой прозрачности в потреблении токенов Claude Code. Анализируя локальные файлы использования JSONL, генерируемые Claude Code, ccusage решает общую проблему для пользователей с безлимитными планами: он позволяет количественно оценить фактическое использование, выявить основные факторы затрат и оценить истинную ценность, получаемую от подписки. Инструмент предоставляет детализированные, практически применимые отчеты для управления и оптимизации вашего взаимодействия с ИИ.

Ключевые особенности

Мы сосредоточены на предоставлении детальной информации и практических рекомендаций, обеспечивая полную прозрачность в использовании ваших токенов и связанных с этим расходах.

📊 Комплексный набор отчетов

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

⏰ Пятичасовые блоки и мониторинг в реальном времени

Отслеживайте потребление в пределах конкретных 5-часовых расчетных окон, используемых бэкэнд-системами Claude. Этот уникальный Blocks Report обеспечивает активный мониторинг, прогнозирование затрат и расчет скорости их расходования в реальном времени, предоставляя вам ранние предупреждения и помогая управлять использованием в соответствии с базовыми механизмами платформы.

💰 Детальный учет затрат и отслеживание моделей

ccusage предоставляет ориентировочные затраты в долларах США, рассчитанные на основе текущего потребления токенов и ценообразования для конкретных моделей. Инструмент автоматически отслеживает использование различных моделей Claude (Opus, Sonnet и др.) и предлагает представление Model Breakdown. Более того, он точно различает стандартные токены и Cache Read/Creation Tokens, обеспечивая более полное представление о ваших чистых операционных расходах.

🔒 100% Локальный и приватный анализ

Ваша конфиденциальность превыше всего. ccusage работает полностью в Offline Mode и выполняет весь анализ локально на вашем компьютере, считывая файлы Claude Code JSONL. Никакие данные никогда не передаются и не покидают ваш компьютер, обеспечивая полную безопасность и суверенитет над вашими шаблонами использования.

🚀 Сверхмалый объем и мгновенный доступ

В отличие от многих сложных CLI-инструментов, ccusage разработан с невероятно малым размером пакета. Эта ориентация на эффективность означает, что вы часто можете запускать инструмент напрямую без полной установки (например, используя bunx ccusage), обеспечивая мгновенный доступ к критически важным данным использования с минимальными затратами на настройку.

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

ccusage преобразует необработанные данные об использовании в стратегические выводы, позволяя пользователям принимать обоснованные решения относительно своего рабочего процесса с ИИ.

1. Оценка рентабельности инвестиций (ROI) для безлимитных планов

Если вы используете план Max, воспользуйтесь Месячными и Сессионными Отчетами, чтобы рассчитать, сколько бы стоило ваше использование по тарифу с оплатой по факту. Это сравнение предоставляет конкретный, количественно измеримый показатель для оценки того, обеспечивает ли ваша текущая модель подписки достаточную ценность, помогая вам обосновать или скорректировать ваш план.

2. Выявление ресурсоемких рабочих процессов

Используйте Session Reports, чтобы точно определить конкретные проекты или цепочки диалогов, которые потребляют наибольшее количество токенов. Сочетая это с функциями Model Tracking и Breakdown, вы сможете определить, не зависели ли дорогостоящие сессии непропорционально от премиальных моделей (таких как Opus), и оценить, может ли менее дорогая модель достичь аналогичных результатов для определенных задач.

3. Интеграция данных об использовании в пользовательские дашборды

Функция JSON Output позволяет экспортировать весь агрегированный анализ в структурированном, программно доступном формате. Разработчики и опытные пользователи могут направлять эти данные непосредственно во внутренние системы мониторинга, пользовательские аналитические дашборды или табличные редакторы для более глубокого анализа тенденций и интеграции с более широкими системами управления проектами.

Уникальные преимущества

ccusage предоставляет исключительную ценность, сосредоточившись на детальной проработке и обеспечении пользовательского контроля над данными.

Детальная отчетность в соответствии с логикой платформы

Мы не просто предоставляем календарные сводки; мы предлагаем 5-Hour Block Reports. Этот уровень детализации является критически важным, поскольку он согласуется с базовыми расчетными окнами Claude, предоставляя вам функциональное понимание использования, которое упускает стандартная календарная отчетность.

Встроенная поддержка экосистем разработчиков

Интегрированный Model Context Protocol (MCP) Server позволяет ccusage беспрепятственно взаимодействовать с другими инструментами и системами разработчиков. Эта функция позиционирует ccusage не просто как средство просмотра, но как активный компонент в более крупной цепочке инструментов, обеспечивая более глубокую автоматизацию и интеграцию.

Гибкая конфигурация и контроль часовых поясов

ccusage предлагает широкие возможности настройки, включая JSON Configuration Files с поддержкой IDE для валидации и автозаполнения, а также гибкую Timezone and Locale Support. Это гарантирует, что отчеты точно группируются, отображаются и форматируются в соответствии с вашей конкретной операционной средой и географическим положением.

Заключение

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

Узнайте, как ccusage может помочь вам получить полный контроль над вашим использованием уже сегодня. Ознакомьтесь с инструментом и документацией на GitHub.