usage CLI
Монитор лимитов и расхода токенов для Claude Code, Codex, Antigravity и Grok CLI: меню macOS, трей Windows, отчеты в HTML
- 345 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Кнопка настройки правит конфигурацию Claude Code, Antigravity CLI и Grok CLI, ставя хук и строку статуса
- Приложение читает локальные логи сессий и сохраненный вход Antigravity, а Muse Code опрашивает фоновым вызовом модели
Установка
- Работает в
Ручная установка
brew install --cask aqua5230/usage/usageРекомендуемый путь для macOS 12 и новее, обновляет команда brew upgrade --cask usage.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Кнопка настройки правит конфигурацию Claude Code, Antigravity CLI и Grok CLI, ставя хук и строку статуса
- Приложение читает локальные логи сессий и сохраненный вход Antigravity, а Muse Code опрашивает фоновым вызовом модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
usage показывает пятичасовые и недельные лимиты Claude Code, Codex, Antigravity, Grok CLI и Muse Code в строке меню macOS или системном трее Windows. Квота краснеет по мере приближения к пределу, а по клику открывается разбивка по сессиям, неделе и проектам. Токены и стоимость Claude Code, Codex, Grok CLI и Muse Code приложение берет из локальных логов. Квоту Antigravity оно читает через его CLI или через официальный эндпоинт Google с входом, который CLI уже хранит. В Claude Code кнопка Set Up Status Line ставит хук синхронизации и строку статуса с предупреждениями о раздувшемся контексте и промахе кэша промпта. Старую строку статуса приложение сначала сохраняет и восстанавливает при отключении. Дополнительно можно включить боковую панель с квотами и параллельными беседами, режим кратких ответов Token Saver и отчеты в HTML за дни и недели с экспортом в html, csv и png. Для терминала и скриптов команда `usage status --json` отдает квоты в Starship или tmux.
Для кого. Тем, кто работает с Claude Code и Codex по подписке и хочет заранее видеть, когда окно на пять часов или недельный лимит закончится.
Подходит, если
- Длинный рефакторинг идет часами, и упереться в лимит на середине не хочется
- Одновременно работают Claude Code, Codex и Antigravity, а остаток по каждому приходится смотреть в разных местах
- Сессии тянутся с холодным кэшем промпта или раздутым контекстом, и строка статуса подсказывает, когда сделать /clear или /compact
- Нужен отчет по токенам и стоимости за неделю по проектам, причем имена проектов можно скрыть
- Квоту надо вывести в Starship, tmux или собственный скрипт через `usage status --json`
Не подходит, если
- Нужен только отчет по стоимости без живых лимитов: для этого проще консольный счетчик токенов
- На компьютере нет данных Claude Code, Codex, Antigravity, Grok CLI или Muse Code и не запущено Claude Desktop
- Нужно меню-бар приложение на Linux: там доступен только терминальный интерфейс через uvx usage-cli
- Политика компании запрещает приложения под лицензией AGPL-3.0 или без подписи Apple и Microsoft
Пример запроса к агенту
Поставь usage через uvx, покажи квоты Claude Code и Codex командой `usage status --json` и скажи, хватит ли недельного лимитаОграничения
- Приложение работает на macOS 12 и новее и Windows 10 или 11. На Linux доступен только терминальный интерфейс без меню-бара и трея.
- Сборки без подписи: macOS 15 требует нажать Open Anyway в настройках приватности, а Windows SmartScreen показывает предупреждение.
- Нужны данные хотя бы одного из инструментов: Claude Code, Codex, Antigravity, Grok CLI, Muse Code или запущенное приложение Claude Desktop.
- Квота Muse Code определяется небольшим фоновым вызовом модели через его CLI. Режим Beginner Mode расходует немного квоты Claude, а автозапуск пятичасового окна отправляет каждому инструменту короткое сообщение.
Как отключить. Выключатель Sync quota via status line в Settings, раздел Claude Code, останавливает синхронизацию и возвращает прежнюю строку статуса. Само приложение закрывают и удаляют как обычную программу: usage.app из папки Applications на macOS, папку с usage.exe на Windows.
Частые вопросы
Как поставить usage на macOS?
Выполните brew install --cask aqua5230/usage/usage. Можно скачать usage.app.zip из последнего релиза и перетащить приложение в Программы. Если macOS блокирует первый запуск, откройте Настройки, Конфиденциальность и безопасность и нажмите Open Anyway.
Откуда usage берет данные о лимитах?
Токены и стоимость Claude Code, Codex, Grok CLI и Muse Code приложение считает по локальным логам. Квоту Claude синхронизирует хук строки статуса. Квоту Antigravity оно получает от его CLI или от эндпоинта Google с уже сохраненным входом. Телеметрии нет, по заявлению автора все работает локально.
Что делает кнопка Set Up Status Line?
Она ставит в Claude Code хук синхронизации квоты и строку статуса. Если вы уже настроили свою строку, приложение сохраняет ее и возвращает при выключении переключателя. После нажатия Claude Code нужно закрыть и открыть заново, на macOS полностью через Cmd+Q.
Можно ли получить квоты в Starship или tmux?
Да, команда `usage status --json` выводит квоты Claude Code, Codex, Antigravity, Grok и Muse в JSON для Starship, tmux или своих скриптов. Готовые фрагменты лежат в docs/DEVELOPMENT.md.
Какие системы поддерживает usage?
macOS 12 и новее и Windows 10 или 11 с приложением в меню или трее. На Linux доступен только терминальный интерфейс через uvx usage-cli. Нужны данные хотя бы от одного из инструментов: Claude Code, Codex, Antigravity, Grok CLI, Muse Code или от запущенного Claude Desktop.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТерминальный монитор расхода Claude Code в реальном времени: токены, сообщения и стоимость в пятичасовом окне, прогноз и экспорт
Плагин для Claude Code: строка статуса с контекстом, лимитами за 5 часов и 7 дней, стоимостью и расходом Codex, Gemini и z.ai
Отчеты по токенам и стоимости Claude Code, Codex, Gemini CLI и других агентов по локальным логам: по дням, месяцам и сессиям
Считает токены и стоимость сессий Claude Code и Codex по локальным журналам и показывает остаток лимитов в статусной строке
Строка статуса для Claude Code показывает расход лимитов за 5 часов и 7 дней и темп: хватит ли остатка до сброса окна
28 компонентов, до девяти строк и 227 настроек: статусная панель Claude Code показывает токены, кеш и цену сессии.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| usage (эта карточка) | нет | 345 | |
| ccusage | нет | 19 349 | печатает отчеты по токенам и стоимости в терминале, без трея и живых лимитов окна |
| claude-dashboard | нет | 585 | плагин со строкой статуса внутри Claude Code, а не отдельное приложение для трех систем |
Коротко о README
README начинается с идеи заранее видеть лимиты и перечисляет пять режимов: меню-бар, карточки инструментов, предупреждения, помощники внутри Claude Code и отчеты. Затем описаны установка через Homebrew, портативная сборка для Windows и запуск через uvx. Дальше идут настройка строки статуса, галерея из 16 тем, боковая панель и таблица сравнения с другими мониторами.