ccusage CLI
Отчеты по токенам и стоимости Claude Code, Codex, Gemini CLI и других агентов по локальным логам: по дням, месяцам и сессиям
- 19 238 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Запускается через npx и читает локальные логи Claude Code, Codex и других агентов
- Для расчета стоимости загружает таблицу цен из сети, без сети работает с флагом --offline
Установка
- Работает в
Ручная установка
npx ccusage@latestБез установки. Альтернативы: bunx ccusage, pnpm dlx ccusage.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускается через npx и читает локальные логи Claude Code, Codex и других агентов
- Для расчета стоимости загружает таблицу цен из сети, без сети работает с флагом --offline
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ccusage читает данные об использовании, которые агенты для программирования сохраняют на диске, и собирает из них таблицы по дням, неделям, месяцам и сессиям. Поддерживаются Claude Code, Codex, OpenCode, Amp, Gemini CLI, GitHub Copilot CLI, Goose и другие. Для Claude Code есть отчет по пятичасовым окнам лимитов, разбивка по проектам и строка статуса. Стоимость считается в долларах с учетом кеш-токенов, данные выгружаются в JSON, цены можно переопределить в конфиге.
Для кого. Для тех, кто пользуется агентами по подписке или API и хочет понимать реальный расход токенов и денег.
Подходит, если
- Нужно понять, во сколько обходится работа с агентом за месяц
- Нужно сравнить расход между проектами или агентами
- Нужно следить за пятичасовыми лимитами Claude Code
Не подходит, если
- Нужен учет расходов всей команды с разных машин
- Агент не сохраняет локальные логи использования
Пример запроса к агенту
Покажи, сколько токенов и денег ушло на Claude Code за этот месяц по проектамОграничения
Считает только то, что лежит в локальных логах этой машины. Стоимость оценочная и зависит от таблицы цен, для работы без сети есть режим --offline с сохраненными ценами. Строка статуса для Claude Code в бета-версии.
Как отключить. Ничего удалять не нужно при запуске через npx. Если строка статуса добавлена в настройки Claude Code, уберите ее из settings.json.
Частые вопросы
Отправляет ли ccusage мои данные куда-то?
README описывает анализ локальных данных. Из сети подгружаются цены, и это отключается флагом --offline.
Можно ли скрыть стоимость?
Да, флаг --no-cost убирает столбцы и поля со стоимостью.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСчитает токены и стоимость сессий Claude Code и Codex по локальным журналам и показывает остаток лимитов в статусной строке
TokenTracker считает токены и расходы в Claude Code, Codex, Cursor, Gemini CLI и других агентах по локальным логам и показывает их на панели localhost:7680
Терминальный монитор расхода Claude Code в реальном времени: токены, сообщения и стоимость в пятичасовом окне, прогноз и экспорт
cc-lens
Claude Code Lens (cc-lens)
Локальная аналитика Claude Code: панель по сессиям, токенам, расходам и проектам из данных каталога ~/.claude, без облака
CLI и MCP-сервер, которые считают расход токенов по 41 инструменту и агенту, показывают трату по проекту и модели и помогают срезать лишние токены
Локальный просмотр, поиск и учет расходов по сессиям Claude Code, Codex и других агентов в одном веб-интерфейсе
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ccusage (эта запись) | нет | 19 238 | ||
| Claude Resets — трекер сбросов лимитов | нет | не нужна | неофициальный трекер сбросов лимитов Claude | |
| TokenTracker | нет | 2 149 | tokenTracker считает токены и расходы в Claude Code | |
| Claude Powerline | нет | 1 175 | статусная строка для Claude Code |
Из блога
Коротко о README
README начинается с запуска через npx и таблицы поддерживаемых агентов с командами для каждого. Дальше перечислены запуск через bunx, pnpm и Nix, примеры отчетов с фильтрами по датам, проектам и часовым поясам, выгрузка в JSON и компактный режим для скриншотов. Полная документация на ccusage.com.