Claude Usage Widget CLI
Виджет поверх экрана и CLI показывают лимиты Claude Code за 5 часов и 7 дней, расход токенов и стоимость каждого хода.
- 85 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Виджет держит доступ к токену подписки Claude Code и обращается с ним к серверам Anthropic.
- Он читает журналы разговоров Claude Code с содержимым ваших сессий.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/claude-usage-widgetОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Виджет держит доступ к токену подписки Claude Code и обращается с ним к серверам Anthropic.
- Он читает журналы разговоров Claude Code с содержимым ваших сессий.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Claude Usage Widget — кроссплатформенный виджет на PySide6 (Qt), который показывает лимиты Claude Code в реальном времени. Поверх окон висит компактная панель с использованием сессии и недели, таймерами сброса, счетчиком токенов в минуту, числом субагентов и бегущей строкой со стоимостью каждого хода. По клику открывается окно с прогнозами, спарклайнами за 5 часов и 7 дней, тепловой картой за 90 дней, календарем на 52 недели, стоимостью по моделям и проектам и недельным отчетом, который пишет Claude. Есть 11 тем, режимы Bars и Gauge, оповещения о быстром расходе и необязательный второй провайдер OpenAI Codex. Режим CLI (`--json`, `--once`, `--field`, `--export`) подходит для скриптов, а `--statusline` встраивается в строку состояния Claude Code.
Для кого. Пользователям Claude Code на подписке, которые хотят видеть остаток лимитов и расход токенов без заглядывания в настройки.
Подходит, если
- Подходит конец пятичасового окна, и нужно понять, хватит ли лимита до сброса.
- Сессия внезапно сжигает токены, и хочется увидеть всплеск и получить уведомление.
- Строку состояния Claude Code наполняют данными об использовании через `--statusline`.
- Раз в неделю выгружают расход по проектам и моделям в CSV или JSON.
Не подходит, если
- Токен подписки нельзя отдавать сторонним программам: виджет использует его для запросов лимитов.
- Среда без графики или без Python 3.10: нужен рабочий стол и Python.
- Вызовы к сторонним лентам запрещены политикой: новостная строка делает такие запросы, если включить ее.
Пример запроса к агенту
Поставь claude-usage-widget, запусти `claude-usage --detach` и покажи, сколько осталось до сброса недельного лимита и какой проект тратит больше всех.Ограничения
Нужны Python 3.10 или новее и авторизованный Claude Code: виджет читает токен OAuth из переменной `CLAUDE_CODE_OAUTH_TOKEN`, затем из `~/.claude/.credentials.json`, затем из связки ключей macOS, и вызывает эндпойнт `/api/oauth/usage`. Читаются и журналы разговоров Claude Code. Необязательная новостная строка обращается к Hacker News и по умолчанию выключена. Раз в день виджет проверяет релизы GitHub. Данные Codex поддержаны только в POSIX. Проект не связан с Anthropic.
Как отключить. Завершите виджет через меню `Quit` и удалите пакет командой `pip uninstall claude-usage-widget`. Автозапуск уберите из настроек рабочего стола или службы systemd. Конфиг `~/.config/claude-usage/config.json` удаляется вручную.
Частые вопросы
Как поставить виджет?
Выполните `pip install --user --upgrade claude-usage-widget` и запустите `claude-usage`. Для Homebrew есть формула `brew install claude-usage-widget`.
Откуда берутся данные о лимитах?
Из эндпойнта `/api/oauth/usage` Claude Code: это те же 5-часовые и недельные цифры, что показывает интерфейс Claude.
Как использовать как CLI?
Запускайте с флагами `--json`, `--once`, `--field` или `--export csv|json`, добавьте `--days N` для периода. Для строки состояния есть `--statusline`.
Можно ли смотреть расход Codex?
Да, добавьте `"codex"` в `providers` конфига: появятся строки с лимитами Codex на 5 часов и неделю. Режим работает на Linux и macOS.
Куда виджет обращается по сети?
К эндпойнту использования Claude Code и раз в день к релизам GitHub. Новостная строка с Hacker News включается отдельно и по умолчанию выключена.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПлагин для Claude Code: строка статуса с контекстом, лимитами за 5 часов и 7 дней, стоимостью и расходом Codex, Gemini и z.ai
Терминальный монитор расхода Claude Code в реальном времени: токены, сообщения и стоимость в пятичасовом окне, прогноз и экспорт
Строка состояния Claude Code с остатком лимитов за 5 часов и неделю, отсчетом до сброса, моделью и сроком жизни кэша
Строка состояния для Claude Code: модель, режим усилия, заполнение контекста, ветка git и лимиты за 5 часов и за неделю.
Монитор лимитов и расхода токенов для Claude Code, Codex, Antigravity и Grok CLI: меню macOS, трей Windows, отчеты в HTML
Строка статуса для Claude Code показывает расход лимитов за 5 часов и 7 дней и темп: хватит ли остатка до сброса окна
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Claude Usage Widget (эта карточка) | нет | 85 | |
| ccusage | нет | 19 415 | отчеты по токенам и стоимости из локальных журналов; виджет показывает лимиты Claude Code в реальном времени и читает данные эндпойнта использования |
| Claude Code Usage Monitor | нет | 8 801 | терминальный монитор расхода в пятичасовом окне; виджет добавляет панель поверх экрана, темы и CLI в JSON |
Коротко о README
README показывает виды панели, темы, возможности, требования, установку через pip и Homebrew, автозапуск, меню и конфигурацию. Отдельный раздел описывает кеш строки состояния и второго провайдера Codex.