claudetop — плагин
claudetop выводит в строке состояния Claude Code стоимость сессии, кэш, окна лимитов тарифа и предупреждения о перерасходе
- 212 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает все JSONL-файлы сессий Claude Code и хранит расходы, проекты и теги в локальных SQLite и журнале
- Для окон лимитов берет сохраненные учетные данные Claude Code и обращается к серверу Anthropic, но не обновляет и не меняет их
- Подключает хук SessionEnd и заменяет строку состояния
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/claudetopОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает все JSONL-файлы сессий Claude Code и хранит расходы, проекты и теги в локальных SQLite и журнале
- Для окон лимитов берет сохраненные учетные данные Claude Code и обращается к серверу Anthropic, но не обновляет и не меняет их
- Подключает хук SessionEnd и заменяет строку состояния
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
claudetop — плагин и набор скриптов, которые превращают строку состояния Claude Code в панель расходов. После каждого ответа видны проект, модель, длительность сессии, число добавленных и удаленных строк, стоимость, расход в час и прогноз на месяц. Отдельная строка показывает окна лимитов тарифа: пять часов, неделю и недельные лимиты по моделям с отсчетом до сброса. Плагин сравнивает, сколько стоила бы та же сессия на Opus, Sonnet или Haiku, с учетом реальной доли попаданий в кэш. Цены берутся из файла `pricing.json` в репозитории и обновляются вместе с ним. Предупреждения появляются, когда стоимость переходит отметки в 5, 10 и 25 долларов, превышен дневной бюджет, кэш просел ниже 20 процентов, расход идет быстрее 15 долларов в час или сессия тратит деньги без вывода кода. Сессии пишутся в журнал, а `claudetop-stats` строит сводки за день, неделю и месяц, в том числе по тегам. Движок `claudetop-engine` сканирует все JSONL-файлы Claude Code в SQLite и открывает панель на `localhost:8080`. Хук SessionEnd и слэш-команды `/claudetop:stats`, `/claudetop:dashboard`, `/claudetop:branch`, `/claudetop:export`, `/claudetop:pricing` и `/claudetop:usage` ставятся вместе с плагином.
Для кого. Владельцам подписок Claude Code и пользователям API, которым нужна стоимость сессии перед глазами, а не счет в конце месяца.
Подходит, если
- Счет за API выше, чем ожидалось, и надо понять, какая сессия и какая модель съели бюджет
- Подписка близка к недельному лимиту, и важно вовремя переключить модель
- Кэш работает плохо после компактификации или смены модели, и хочется увидеть это в числах
- Нужна сводка расходов по задачам: сессии размечаются тегом через `CLAUDETOP_TAG`
- Команде нужна панель с картой активности и расходами по проектам, моделям и инструментам
Не подходит, если
- Вы пользуетесь другим агентом: плагин читает файлы и поля строки состояния Claude Code
- Нужен учет по нескольким сотрудникам с общей базой: все данные лежат локально у одного пользователя
- Сессии идут через Bedrock или Vertex: строка с окнами тарифа в этих режимах не появляется
- Нужна точная бухгалтерия: стоимость, прогноз и сравнение моделей приблизительные
Пример запроса к агенту
Покажи расходы за неделю командой claudetop-stats week и скажи, на какой модели и в каком проекте ушло больше всегоОграничения
- Плагин работает только в Claude Code, строка состояния обновляется после каждого ответа.
- Окна тарифа для Pro, Max и Team берутся из JSON строки состояния, а недельные лимиты по моделям и кредиты запрашиваются из конечной точки `/usage` и кэшируются на минуту в `~/.claude/claudetop-usage.json`. Для ключей API, Bedrock и Vertex эта строка не показывается.
- Прогнозы и сравнение с другими моделями приблизительные. Автор отмечает, что сжатие контекста ранее скрывало до 80 процентов использованных токенов.
- Для интеграции с iTerm2 нужен сам терминал.
Как отключить. Плагин снимается командой `claude plugin uninstall claudetop`. Установленный скриптом `install.sh` вариант убирается обратным удалением файлов и записи `statusLine` из `~/.claude/settings.json`. Строку лимитов отключает переменная `CLAUDETOP_USAGE=off`. Журнал сессий остается на диске, удалите его вручную.
Частые вопросы
Как поставить claudetop в Claude Code?
Выполните `claude plugin marketplace add liorwn/claudetop` и `claude plugin install claudetop`, затем перезапустите Claude Code. Альтернатива: клонировать репозиторий и запустить `./install.sh`.
Чем claudetop отличается от ccusage?
ccusage считает расходы по журналам сессий в терминале. claudetop добавляет строку состояния прямо в Claude Code, окна лимитов тарифа, сравнение моделей с учетом кэша и предупреждения о перерасходе.
Откуда берутся данные о лимитах тарифа?
Окна на пять часов и семь дней приходят из строки состояния Claude Code. Лимиты по отдельным моделям и кредиты запрашивает фоновая команда `claudetop-usage` не чаще раза в минуту, она использует уже сохраненные учетные данные Claude Code.
Как включить дневной бюджет?
Задайте переменную `CLAUDETOP_DAILY_BUDGET`, например `export CLAUDETOP_DAILY_BUDGET=50`. На 80 процентах строка покажет остаток, а при превышении появится предупреждение OVER BUDGET.
Нужны ли внешние зависимости?
Нет, движок аналитики использует только стандартную библиотеку Python 3: `sqlite3`, `http.server` и `json`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин для Claude Code: строка статуса с контекстом, лимитами за 5 часов и 7 дней, стоимостью и расходом Codex, Gemini и z.ai
Терминальный менеджер сессий Claude Code: статус каждой сессии, расход токенов по моделям и проектам, сводки сразу после выхода.
Строка статуса для Claude Code показывает расход лимитов за 5 часов и 7 дней и темп: хватит ли остатка до сброса окна
Терминальный монитор расхода Claude Code в реальном времени: токены, сообщения и стоимость в пятичасовом окне, прогноз и экспорт
Плагин Claude Code, который показывает оценку выбросов CO2 сессии в статусной строке рядом с ее стоимостью
cc-lens
Claude Code Lens (cc-lens)
Локальная аналитика Claude Code: панель по сессиям, токенам, расходам и проектам из данных каталога ~/.claude, без облака
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| claudetop (эта карточка) | нет | 212 | |
| ccusage | нет | 19 337 | считает расходы по журналам в терминале, без строки состояния внутри Claude Code |
| ccstatusline | нет | 13 533 | настраиваемая строка состояния без прогноза расходов и окон лимитов тарифа |
Коротко о README
README начинается с истории автора: оценка модели показывала 10 долларов, а реальный счет составил 65, потому что компактификация скрывала расход. Дальше показаны вид строки состояния, три способа установки, окна лимитов, предупреждения, статистика, движок аналитики, теги, бюджет, темы и интеграция с iTerm2.