claude-dashboard — плагин
Плагин для Claude Code: строка статуса с контекстом, лимитами за 5 часов и 7 дней, стоимостью и расходом Codex, Gemini и z.ai
- 584 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Читает учетные данные: токен Claude Code из связки ключей macOS (на Linux и Windows из .credentials.json), файлы входа ~/.codex/auth.json, ~/.gemini/oauth_creds.json и токен Antigravity. С ними плагин обращается только к API самих провайдеров за остатками лимитов, третьим лицам токены не уходят
- Хук SessionStart при каждом запуске сессии проверяет и поправляет запись statusLine в настройках Claude Code
- Команда `/claude-dashboard:setup-alias` дописывает псевдоним `check-ai` в настройки оболочки
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/claude-dashboardОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Читает учетные данные: токен Claude Code из связки ключей macOS (на Linux и Windows из .credentials.json), файлы входа ~/.codex/auth.json, ~/.gemini/oauth_creds.json и токен Antigravity. С ними плагин обращается только к API самих провайдеров за остатками лимитов, третьим лицам токены не уходят
- Хук SessionStart при каждом запуске сессии проверяет и поправляет запись statusLine в настройках Claude Code
- Команда `/claude-dashboard:setup-alias` дописывает псевдоним `check-ai` в настройки оболочки
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
claude-dashboard заменяет строку статуса Claude Code настраиваемой панелью. В компактном режиме на одной строке видны модель, заполнение контекста, стоимость сессии и лимиты за 5 часов и за 7 дней с обратным отсчетом до сброса. Обычный режим добавляет проект и ветку git, идентификатор и длительность сессии, скорость расхода токенов и прогресс списка задач. Подробный режим на шесть строк показывает еще оценку времени до исчерпания лимита, активные инструменты и субагентов, попадания в кэш, разбивку токенов, прогноз почасовой стоимости и дневной бюджет. Панель считает расход не только Claude. Если установлены Codex, Gemini CLI или Antigravity CLI либо работа идет через z.ai, плагин находит их сам и показывает остатки квот. Команда `/claude-dashboard:check-usage` сводит лимиты всех этих CLI на одном экране и подсказывает, где больше свободной квоты, а ключ `--json` отдает данные для скриптов. Любой виджет можно отключить, порядок строк задается коротким кодом вроде `MC$R|BDO` или списком виджетов. Есть девять тем, четыре разделителя и два языка, английский и корейский. Параметр `dailyBudget` предупреждает при расходе 80% и 95% дневного бюджета. Кроме строки статуса, плагин поставляется как мод Claude Code: `/claude-dashboard-pane` открывает панель рядом с диалогом, а `/claude-dashboard-band` рисует ее над строкой ввода.
Для кого. Для тех, кто работает в Claude Code на подписке с лимитами и хочет видеть остаток контекста, квоты и расходы без лишних команд, а также для пользователей нескольких агентов сразу.
Подходит, если
- Нужно видеть в Claude Code заполнение контекста и остаток лимитов за 5 часов и 7 дней, не выходя из сессии
- Вы работаете с Claude Code, Codex и Gemini CLI одновременно и хотите знать, где осталась свободная квота: для этого служит `/claude-dashboard:check-usage`
- Нужен контроль расходов: стоимость сессии, расход токенов в минуту, прогноз почасовой стоимости и дневной бюджет с предупреждениями
- Хочется понимать, сколько осталось до лимита: виджет depletionTime дает приблизительную оценку времени до исчерпания
- Нужно вынести панель в отдельную область рядом с диалогом или над строкой ввода командами мода: панель и полоса
Не подходит, если
- Нужны отчеты за недели и месяцы: плагин показывает текущую сессию и сегодняшние траты
- Вы работаете не в Claude Code: плагину нужен Claude Code версии 1.0.80 или новее и Node.js версии 18 или новее
- Плагину нельзя давать доступ к токенам других CLI: он читает файлы входа Codex, Gemini и Antigravity
- Нужен интерфейс на русском: поддерживаются английский и корейский
Пример запроса к агенту
Запусти `/claude-dashboard:check-usage` и скажи, в каком из подключенных CLI сейчас больше всего свободной квотыОграничения
Нужны Claude Code 1.0.80 или новее и Node.js версии 18 или новее. Лимиты берутся из API с OAuth-токеном Claude Code. Если токен просрочен, рядом с лимитами появляется предупреждающий значок, а повторный вход в Claude Code это исправляет. Ответы API кэшируются в папке ~/.cache/claude-dashboard/, кэш чистится автоматически через час.
Оценка времени до исчерпания лимита приблизительная: расчет исходит из того, что весь расход пришел из текущей сессии, и становится точнее по мере работы. На macOS токен берется из связки ключей, где одна запись на все аккаунты, поэтому при нескольких учетных записях через `CLAUDE_CONFIG_DIR` запросы лимитов идут с тем токеном, который хранится в связке.
Моды панель и полоса — ранний доступ, проверены на Claude Code 2.1.289 и рисуются только в терминале и на вкладке Code приложения, но не в панели VS Code и не в режиме `claude -p`. При ручной установке клонированием версия автоматически не подхватывается: после каждого релиза делайте `git pull` и правьте путь в настройках.
Как отключить. Удалите плагин командами /plugin и уберите запись statusLine из settings.json, если она остается. Кэш лежит в ~/.cache/claude-dashboard/ и удаляется командой `rm -rf ~/.cache/claude-dashboard/`. Файл настроек ~/.claude/claude-dashboard.local.json можно стереть вручную.
Частые вопросы
Как поставить claude-dashboard в Claude Code?
Выполните три команды: `/plugin marketplace add uppinote20/claude-dashboard`, `/plugin install claude-dashboard` и `/claude-dashboard:setup`. Можно поставить и вручную, клонировав репозиторий в папку plugins. Тогда в statusLine.command нужно указать путь к dist/index.js из клона.
Какие режимы отображения есть у claude-dashboard?
Три готовых режима. Компактный занимает одну строку: модель, контекст, стоимость и лимиты за 5 часов и 7 дней. Обычный на две строки добавляет проект, сессию, расход токенов и задачи. Подробный на шесть строк показывает еще прогноз исчерпания, кэш, разбивку токенов, бюджет и расход других CLI. Режим выбирают командой, например `/claude-dashboard:setup normal en pro`.
Как показывать расход Codex и Gemini рядом с Claude?
Отдельная настройка не нужна: виджеты codexUsage, geminiUsage и antigravityUsage скрываются, если нужных файлов входа нет, и появляются, когда они найдены. Плагин ищет ~/.codex/auth.json, ~/.gemini/oauth_creds.json и файл токена Antigravity. Сводку по всем CLI дает `/claude-dashboard:check-usage`.
Как настроить виджеты и тему?
Запустите `/claude-dashboard:setup` без аргументов для диалога или правьте файл ~/.claude/claude-dashboard.local.json: там задаются режим, строки, одна из девяти тем, разделитель, дневной бюджет и список disabledWidgets. Свой набор строк можно собрать режимом `custom`: виджеты в строке перечисляют через запятую, а строки разделяют вертикальной чертой.
Что делать, если лимиты показывают предупреждающий значок?
Автор называет три причины: просрочен токен, нет сети или API сработал по лимиту запросов. Войдите в Claude Code заново, проверьте соединение и подождите обновления кэша. Если строка статуса не видна вообще, проверьте `/plugin list` и запись statusLine в settings.json, затем перезапустите Claude Code.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныСтатусная строка для Claude Code: расход токенов и денег, остаток контекста, лимиты и ветка git в четырех стилях и шести темах
Терминальный монитор расхода Claude Code в реальном времени: токены, сообщения и стоимость в пятичасовом окне, прогноз и экспорт
Настраиваемая строка статуса для Claude Code: модель, ветка git, контекст, расход лимитов и другие виджеты
Плагин Claude Code, который показывает оценку выбросов CO2 сессии в статусной строке рядом с ее стоимостью
cc-lens
Claude Code Lens (cc-lens)
Локальная аналитика Claude Code: панель по сессиям, токенам, расходам и проектам из данных каталога ~/.claude, без облака
Маркет из 17 модов для Claude Code: расход токенов, временная шкала правок с откатом, учет допущений, доска проверки и живая лента команд
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| claude-dashboard (эта запись) | нет | 584 | |
| ccstatusline | нет | 13 462 | настраиваемая строка статуса: модель, ветка git, контекст и расход лимитов |
| Claude HUD | нет | 29 003 | выводит в строку статуса контекст, активные инструменты, субагентов и прогресс задач |
| ccusage | нет | 19 238 | отчеты по токенам и стоимости по локальным логам: по дням, месяцам и сессиям |
Коротко о README
README начинается с однострочного описания и демонстрации, затем идут установка через магазин плагинов или клонированием и три режима отображения со снимками. Большая таблица описывает виджеты по группам, от ядра и лимитов до аналитики, квот других CLI и информации о версии. Дальше показаны настройки с пресетами, темами и разделителями, четыре команды плагина, моды pane и band, раздел решения проблем с несколькими аккаунтами и кэшем и короткий блок про разработку.