Claude Powerline — плагин
Статусная строка для Claude Code: расход токенов и денег, остаток контекста, лимиты и ветка git в четырех стилях и шести темах
- 1 175 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Строка запускает пакет командой npx -y с тегом latest при каждом обновлении, поэтому на машине исполняется свежая версия пакета из npm без закрепления
- Мастер /powerline записывает файл настроек в ~/.claude и правит settings.json
- Для расхода и таймера кеша читает данные сессии Claude Code и хранит кеш расчета в ~/.claude/powerline
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/claude-powerlineОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Строка запускает пакет командой npx -y с тегом latest при каждом обновлении, поэтому на машине исполняется свежая версия пакета из npm без закрепления
- Мастер /powerline записывает файл настроек в ~/.claude и правит settings.json
- Для расхода и таймера кеша читает данные сессии Claude Code и хранит кеш расчета в ~/.claude/powerline
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Claude Powerline — статусная строка для Claude Code в духе vim-powerline. Внизу терминала она показывает, сколько токенов и долларов ушло за сессию, день и месяц, сколько контекста осталось до автосжатия, на какой ветке git вы находитесь и какая модель отвечает. Строка подключается как `statusLine` в `settings.json`: Claude Code передает команде данные текущей сессии, а команда печатает цветную строку из сегментов. Сегменты включаются по одному: каталог, git (ветка, `SHA`, опережение и отставание от удаленной ветки, счетчики изменений), модель, сессия, день, месяц, контекст, окна лимитов на пять часов и на неделю, метрики (время ответов, число сообщений, добавленные и удаленные строки), версия Claude Code, субагент, режим размышления, стиль вывода, таймер кеша промптов, tmux, идентификатор сессии, значение переменной окружения. Стилей четыре (`minimal`, `powerline`, `capsule`, `tui`), тем шесть (`dark`, `light`, `nord`, `tokyo-night`, `rose-pine`, `gruvbox`). Для `tui` можно собрать свою сетку с точками перелома и шаблонами сегментов. Бюджеты на сессию, день, месяц и окно лимитов дают процент и предупреждение, по умолчанию с отметки 80 процентов. Мастер `/powerline` по шагам спрашивает тему, стиль, шрифт, сегменты и бюджеты, пишет `~/.claude/claude-powerline.json` и сам правит `settings.json`. Настройки можно держать в проекте (`.claude-powerline.json`), в домашней папке или по стандарту XDG. Флаги командной строки сильнее переменных окружения, а те сильнее файлов. Файлы перечитываются без перезапуска.
Для кого. Для тех, кто работает в Claude Code каждый день и хочет видеть расход, контекст и состояние git, не вызывая отдельных команд.
Подходит, если
- Нужно видеть в самом Claude Code, сколько токенов и долларов ушло за сессию, день и месяц, и получать предупреждение у границы своего бюджета
- Хочется знать, сколько контекста осталось до автосжатия, и не угадывать момент по ощущениям
- На подписке Pro или Max нужен остаток пятичасового и недельного окон лимитов прямо в строке
- Нужна строка со своей темой или сеткой в стиле `tui`, настроенная мастером или визуальным редактором
- Вы работаете в нескольких рабочих деревьях git: сегмент каталога в таких сессиях показывает путь исходного репозитория
Не подходит, если
- Нужна статусная строка для другого агента: проект описан только для Claude Code
- Нужны таблицы расхода по дням, неделям и проектам из локальных логов: их собирает `ccusage`, а здесь строка показывает только текущие цифры
- На машине нет Node.js 18 или новее либо Git 2.0 или новее: команда строки работает на них
- Нужна строка без запуска пакета из сети: команда в `statusLine` вызывает `npx -y @owloops/claude-powerline@latest`
Пример запроса к агенту
Поставь мне статусную строку для Claude Code с темой nord, расходом за сессию и день и остатком контекстаОграничения
- Нужны Node.js 18 или новее, Claude Code и Git 2.0 или новее. Значки рассчитаны на шрифт Nerd Font, без него включают флаг `--charset=text`, и строка рисуется символами ASCII.
- Сегменты окон лимитов на пять часов и на неделю показываются, только когда Claude Code сам передает данные `rate_limits`, то есть у подписчиков Claude.ai Pro и Max. Без них эти сегменты скрыты.
- Таймер кеша обновляется, когда Claude Code перезапускает строку. Чтобы он шел в простое, в блок `statusLine` добавляют `refreshInterval` в секундах, минимум 1.
- Сумма в долларах считается одним из двух способов: `calculated` по таблице цен в духе `ccusage` или `official` по данным хука Claude Code. Сегмент месяца выключен по умолчанию, бюджет месяца без настройки равен 500, бюджет дня — 50.
- Таблица `modelContextLimits` нужна только для Claude Code старше 2.0.65: новые версии сами сообщают размер окна контекста, включая режим на миллион токенов.
- Версия пакета на момент проверки 1.32.4, лицензия MIT.
Как отключить. Удалите блок `statusLine` из `~/.claude/settings.json`, и Claude Code вернет обычную строку. Плагин с мастером снимается через менеджер плагинов Claude Code. Файл `~/.claude/claude-powerline.json` и кеш расхода в `~/.claude/powerline` можно удалить вручную.
Частые вопросы
Как показать в статусной строке Claude Code расход токенов и денег?
Включите сегменты `session`, `today` и `month` и выберите для каждого `type`: `cost`, `tokens`, `both` или `breakdown`. Способ подсчета задает `costSource`: `calculated` или `official`. Бюджет с полем `amount` добавляет процент и предупреждение у порога `warningThreshold`.
Как узнать, сколько контекста осталось до автосжатия?
Сегмент `context` показывает заполнение окна с учетом резерва `autocompactBuffer`, по умолчанию 33000 токенов. Если автосжатие у вас выключено, поставьте 0, и строка покажет сырое заполнение. Режим `percentageMode` переключает отсчет с остатка на израсходованное.
Почему в статусной строке не видно остатка пятичасового и недельного лимитов?
Сегменты `block` и `weekly` берут официальные данные `rate_limits`, которые Claude Code передает подписчикам Claude.ai Pro и Max. Если данных нет, сегменты скрыты. Опция `showPace` добавляет рядом цифру равномерного расхода за окно.
Почему вместо значков в строке квадраты?
Значки unicode рассчитаны на шрифт Nerd Font. Установите его или запустите команду с флагом `--charset=text`: тогда ветка, статус git и сегменты рисуются символами ASCII.
Как настроить вид строки, не правя JSON вручную?
Мастер `/powerline` спрашивает тему, стиль и сегменты и сам пишет файл настроек. Есть и визуальный редактор Powerline Studio на powerline.owloops.com: в нем переключают сегменты щелчком, меняют темы и копируют готовый JSON. Существующий файл можно вставить туда и править.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныНастраиваемая строка статуса для Claude Code: модель, ветка git, контекст, расход лимитов и другие виджеты
Плагин для Claude Code: строка статуса с контекстом, лимитами за 5 часов и 7 дней, стоимостью и расходом Codex, Gemini и z.ai
Терминальный монитор расхода Claude Code в реальном времени: токены, сообщения и стоимость в пятичасовом окне, прогноз и экспорт
Маркет из 17 модов для Claude Code: расход токенов, временная шкала правок с откатом, учет допущений, доска проверки и живая лента команд
Плагин Claude Code, который показывает оценку выбросов CO2 сессии в статусной строке рядом с ее стоимостью
Считает токены и стоимость сессий Claude Code и Codex по локальным журналам и показывает остаток лимитов в статусной строке
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Claude Powerline (эта запись) | нет | 1 175 | |
| ccstatusline | нет | 13 444 | строку собирают из виджетов в интерактивном интерфейсе, среди виджетов статус CI пулреквеста и состояние сервисов Claude |
| Claude HUD | нет | 28 981 | плагин с полосой контекста и лимитов, показывает активность инструментов, субагентов и прогресс задач из журнала сессии |
| ccusage | нет | 19 238 | отчеты по дням, неделям и сессиям из локальных логов многих агентов, строка статуса там лишь одна из функций |
Коротко о README
Документация открывается установкой: мастер через плагин и ручной блок для `settings.json`. Дальше идет справочник по каждому сегменту с примером настроек, таблицы символов для режимов `unicode` и текстового, описание бюджетов, автопереноса и раскладки `tui` с точками перелома, шаблонами сегментов, заголовком и подвалом. В репозитории лежат шаблоны готовых настроек для плагина, тесты на `jest`, скрипт замера времени работы и страница визуального редактора. Пакет заявлен без зависимостей.