Claude Usage Widget

Что показывает

Всё обновляется само каждые 30 секунд.

Что понадобится

• macOS 12 Monterey или новее.
• Übersicht — бесплатное приложение для виджетов на рабочем столе.
• Node.js 18 или новее.
• Claude Code с подпиской Claude Pro или Max. У API-аккаунтов нет лимитов подписки, показывать нечего.

Установка

Минут пять. Команды для Homebrew, обычные установщики тоже подойдут.

1. Установите Übersicht

   Через Homebrew:

   brew install --cask ubersicht

   Или скачайте с tracesof.net/uebersicht и перенесите в «Программы». Откройте Übersicht: его значок появится в строке меню. В настройках включите запуск при входе в систему, чтобы виджет был всегда.

2. Установите Node.js

   Сборщик данных виджета работает на Node.js. Через Homebrew:

   brew install node

   Или установщиком с nodejs.org. Виджет сам найдёт Node из Homebrew, официального установщика, Volta, nvm и fnm.

3. Добавьте виджет

   Скачайте архив выше и распакуйте его. Нажмите на значок Übersicht в строке меню, выберите Open Widgets Folder и перенесите туда папку claude-usage.widget. Имя папки не меняйте.

   Через полминуты виджет появится в левом нижнем углу экрана.

4. Подключите статус-лайн Claude Code

   Расход по подписке Claude Code отдаёт только своему статус-лайну, поэтому виджет берёт данные оттуда. Добавьте в ~/.claude/settings.json:

   {
     "statusLine": {
       "type": "command",
       "command": "node \"$HOME/Library/Application Support/Übersicht/widgets/claude-usage.widget/lib/statusline.cjs\""
     }
   }

   Перезапустите Claude Code и отправьте любое сообщение. В статус-лайне появится короткая сводка вида ◆ Opus 5.5 5ч 47% 7д 30%. Если у вас уже есть свой статус-лайн, оставьте его: допишите к команде --then "ваша-команда", и хук передаст ей те же данные и выведет её результат.

5. Разрешите доступ к Keychain, если спросят

   Лимиты моделей виджет берёт у Anthropic по токену, который Claude Code хранит в Keychain. Обычно macOS ничего не спрашивает. Если появится запрос для security, разрешите его или отключите эту часть: "oauth": { "enabled": false } в конфиге.

Обновление: скачайте новый архив и замените папку claude-usage.widget. Перед этим сохраните свой config.json и потом верните его на место.

Настройки

Правьте config.json в папке виджета. Изменения подхватятся при следующем обновлении, а неверные значения заменятся значениями по умолчанию.

Откуда берутся данные

Статус-лайн — единственный официальный источник расхода по подписке, но он обновляется, только пока работает Claude Code. Лимиты общие с claude.ai, поэтому, когда статус-лайн молчит, виджет спрашивает Anthropic.

Приватность. Единственный сетевой запрос идёт на api.anthropic.com. Токен читается из Keychain по необходимости и никогда не сохраняется, не логируется и не обновляется. В кеше ~/.cache/claude-usage-widget только проценты, время сброса и сводки по логам, его можно удалить. Эндпоинт неофициальный: если он изменится, пропадут только лимиты моделей и запасной источник.

Если что-то не так