OpenUsage CLI
Терминальная панель с расходом, квотами и лимитами Claude Code, Codex, Cursor, Copilot и других ИИ-инструментов
- 246 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает домашние каталоги и логи ИИ-инструментов и переменные окружения с ключами API, чтобы определить провайдеров
- Фоновый демон работает постоянно и пишет данные о расходе в локальную базу
- Хуки и статусная строка меняют конфиг Claude Code и других агентов, если вы их установите
Установка
- Работает в
Ручная установка
brew install janekbaraniewski/tap/openusageРекомендуемый способ для macOS. Дальше команда openusage запускает панель.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает домашние каталоги и логи ИИ-инструментов и переменные окружения с ключами API, чтобы определить провайдеров
- Фоновый демон работает постоянно и пишет данные о расходе в локальную базу
- Хуки и статусная строка меняют конфиг Claude Code и других агентов, если вы их установите
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OpenUsage находит на машине ИИ-инструменты и ключи API и собирает их расход, остаток квоты, время сброса лимитов и данные по моделям в одной терминальной панели. Всего поддержано 37 провайдеров: кодинг-агенты, платформы API вроде OpenAI, Anthropic и OpenRouter, локальный Ollama. Фоновый демон копит данные в локальной базе SQLite, поэтому история остается, пока панель закрыта. Без интерфейса работают отчеты `openusage daily`, `weekly`, `monthly`, `session` и `blocks`, к любому добавляется `--json` для скриптов и CI. Блок биллинга на 5 часов показывает скорость расхода и прогноз. Для Claude Code есть однострочная статусная строка с ценой сессии, дневной суммой и заполнением контекста (`openusage statusline install`). Для tmux ставится сегмент с данными активного инструмента (`openusage tmux install`). Снимки выгружаются в JSON и CSV, а встроенный хаб отдает метрики для Prometheus.
Для кого. Разработчикам, которые сидят в нескольких ИИ-инструментах и подписках сразу и хотят видеть общий расход и остаток лимитов, не открывая кабинет каждого сервиса.
Подходит, если
- Подписки Claude Code и Codex идут параллельно, и надо знать, когда сбросится 5-часовое окно
- Счет за OpenRouter и Anthropic растет, а в какой модели и проекте уходят деньги, непонятно
- В CI нужна ежедневная сводка расхода токенов в JSON
- В статусной строке tmux хочется видеть цену текущей сессии и скорость расхода
- Нужны метрики расхода в Prometheus и Grafana для команды
Не подходит, если
- Нужен лимит или бюджет, который сам останавливает агента: OpenUsage только показывает расход и ничего не блокирует
- Нужен учет по вашей организации в облаке: данные хранятся локально, на машине, где работает демон
- Нужна точная сверка со счетом: оценка цены приблизительная там, где провайдер не отдает стоимость
Пример запроса к агенту
Покажи, сколько я потратил на Claude Code и Codex за эту неделю, и выведи отчет по дням в JSONОграничения
Сборка из исходников требует Go 1.25 и CGO. Провайдеры определяются по бинарникам, каталогам вроде ~/.claude и переменным окружения, поэтому инструмент без следов на диске в списке не появится. Отчеты `session` и `blocks` есть не у всех: у удаленных платформ (OpenAI, Anthropic, OpenRouter) они отсутствуют, потому что те не отдают данных по ходам. Статусная строка поддерживает только Claude Code. Цена считается по справочнику тарифов и остается оценкой, когда провайдер не сообщает стоимость сам.
Как отключить. Остановите демон и удалите бинарник (`brew uninstall openusage`). Локальная база SQLite лежит у вас, ее можно удалить вручную. Статусную строку Claude Code и сегмент tmux уберите из своих конфигов.
Частые вопросы
Какие инструменты видит OpenUsage?
Среди кодинг-агентов и IDE: Claude Code, Codex CLI, Cursor, Copilot, Gemini CLI, OpenCode, Amp, Goose, Roo Code, Kilo Code, Kiro и Zed. Среди API-платформ: OpenAI, Anthropic, OpenRouter, Groq, Mistral, DeepSeek, Perplexity и xAI. Локально читается Ollama. Определение идет по бинарникам, домашним каталогам инструментов и ключам API в окружении.
Нужна ли настройка?
Нет, достаточно запустить openusage: инструменты и ключи подхватываются сами. Статусную строку для Claude Code и сегмент tmux можно добавить отдельными командами, а темы, окна времени и пороги меняются в конфиге.
Куда уходят данные?
Данные собирает локальный демон и складывает в базу SQLite на вашей машине. Панель работает в локальном режиме и облачного аккаунта не требует.
Как вывести метрики в Prometheus?
Встроенный хаб отдает метрики в формате Prometheus. Снимки состояния отдельно выгружаются в JSON или CSV, а справочник цен по моделям смотрится командой самого инструмента.
Чем отличаются отчеты `daily` и blocks?
`daily` группирует расход по дням, также есть `weekly` и `monthly. blocks` делит данные на 5-часовые окна биллинга со скоростью расхода и прогнозом, он работает для Claude Code, Codex, Gemini CLI, Copilot, Cursor и еще ряда агентов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальная панель учета работы ИИ-агентов: токены, оценка стоимости, шаги, измененные файлы и проверки по задачам Claude Code, Codex, OpenCode
Терминальная панель в стиле top для сессий Claude Code и Codex: расход, токены, контекст, процессы и вызовы инструментов.
ClawMetry читает файлы сессий агентов и показывает ход работы, вызовы инструментов, токены и стоимость в одной панели.
Плагин Claude Code с командой /omh: локальная панель по скиллам, агентам, MCP, расходу токенов и кэшу для Claude Code и Codex.
Локальный прокси с панелью в терминале: показывает, сколько токенов уходит с каждым запросом Claude Code и Codex, и сохраняет промпты в файлы
Панель в терминале и браузере показывает сессии, расходы и настройки Claude Code, считает бюджет и прогноз на 30 дней.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| OpenUsage (эта карточка) | нет | 246 | |
| ccusage | нет | 19 415 | читает локальные логи одного набора агентов; OpenUsage добавляет API-платформы, демон и tmux |
| Claude Code Usage Monitor | нет | 8 799 | следит за использованием одного Claude Code; OpenUsage собирает данные по 37 провайдерам |
Коротко о README
Описание проекта сначала знакомит с панелью, ставит три способа установки и показывает команды отчетов с таблицей поддержки по провайдерам. Затем идут интеграции с tmux и статусной строкой, раздел возможностей и справочник по 37 провайдерам с примерами определения.