claude-pace — плагин

Строка статуса для Claude Code показывает расход лимитов за 5 часов и 7 дней и темп: хватит ли остатка до сброса окна

  • 245 ★ репозитория
  • Последний коммит
  • MIT
Плагин

Расширенный доступ

Почему такой уровень

  • Запускает Bash-скрипт на каждое обновление строки статуса, примерно каждые 300 мс
  • Меняет настройки Claude Code: прописывает `statusLine` в `~/.claude/settings.json`
Все причины и проверки

astro-han/claude-pace

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add plugins/claude-pace

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Запускает Bash-скрипт на каждое обновление строки статуса, примерно каждые 300 мс
  • Меняет настройки Claude Code: прописывает `statusLine` в `~/.claude/settings.json`

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

claude-pace выводит в строке статуса Claude Code модель, уровень усилий, проект с веткой и сводку `git` diff, а во второй строке расход лимитов в окнах 5 часов и 7 дней со временем до сброса. Главное в нем темп. Показатель `⇡15%` красного цвета означает, что лимит уходит на 15% быстрее устойчивого темпа, а `⇣15%` зеленого цвета означает запас на те же 15%. Сам процент использования без привязки ко времени окна мало что говорит: 60% за полчаса до сброса и 60% за четыре часа до сброса требуют разных решений. Весь инструмент состоит из одного файла на `Bash` с зависимостью только от `jq`. Данные о лимитах приходят из поля `rate_limits` во входном JSON, которое Claude Code передает строке статуса начиная с версии 2.1.80. Сетевых запросов скрипт не делает. Если поля нет, для лимитов показывается `--`, устаревшие значения из кэша не выводятся. Кэш с ветками `git` хранится пять секунд в личном каталоге с правами 700. Ставят плагином через `/plugin marketplace add`, командой `npx claude-pace` или вручную: скрипт скачивают из релиза в `~/.claude/statusline.sh` и прописывают в `~/.claude/settings.json` блок `statusLine`. Команда `/claude-pace:setup` копирует скрипт, который идет вместе с плагином, поэтому запускается та версия, что установлена.

Для кого. Тем, кто работает в Claude Code на подписке и хочет видеть расход лимитов за 5 часов и 7 дней прямо в терминале.

Подходит, если

  • Лимит окна 5 часов исчерпывается неожиданно, и нужно видеть темп расхода заранее
  • Рабочая неделя идет к недельному лимиту, и надо решать, замедлиться ли
  • Нужна строка статуса без Node.js и без папки node_modules: достаточно `Bash` и `jq`
  • Скрипт хочется прочитать целиком перед установкой: он один и лежит в репозитории
  • Строка статуса должна показывать ветку, объем правок и модель в одной компактной строке

Не подходит, если

  • Нужны темы, powerline-оформление или настройка через TUI: для этого авторы советуют ccstatusline
  • Claude Code старше версии 2.1.80: поле с лимитами не передается, и вместо процентов будет `--`
  • Работа идет через провайдера, который не отдает `rate_limits`: лимиты покажутся прочерками
  • Нужно считать стоимость и токены по логам задним числом: инструмент показывает только живое состояние окна

Пример запроса к агенту

Поставь claude-pace как строку статуса Claude Code, проверь, что `jq` установлен, и покажи, как читать значки темпа

Ограничения

  • Нужен Claude Code версии 2.1.80 или новее, потому что поле `rate_limits` во входных данных строки статуса появилось в этой версии.
  • Для работы нужен установленный `jq`. Без него скрипт не запустится.
  • При отсутствии `rate_limits`, например у некоторых провайдеров, лимиты отображаются как `--`. Прежние значения из кэша инструмент не показывает: автор убрал такой запасной вариант, чтобы не выводить устаревшие цифры.
  • Поддерживается только строка статуса Claude Code. Оформление фиксировано.

Как отключить. Уберите блок `statusLine` из `~/.claude/settings.json`. Плагин снимает команда `/plugin uninstall claude-pace`, а скрипт, поставленный вручную, можно удалить: `~/.claude/statusline.sh`.

Частые вопросы

Как поставить claude-pace в Claude Code?

Выполните `/plugin marketplace add Astro-Han/claude-pace`, затем `/plugin install claude-pace`, `/reload-plugins` и `/claude-pace:setup`. Запасной путь: `npx claude-pace`. После любого способа перезапустите Claude Code.

Что означают значки ⇡ и ⇣ в строке статуса?

Стрелка вверх красного цвета показывает, что вы тратите лимит быстрее устойчивого темпа, стрелка вниз зеленого цвета показывает запас. Число рядом задает разницу в процентах между фактическим расходом и долей прошедшего времени окна.

Делает ли claude-pace сетевые запросы?

Нет. Данные о лимитах берутся из `rate_limits` во входном JSON, а остальное скрипт собирает командами `git` и локальным кэшем на пять секунд.

Нужен ли Node.js для claude-pace?

Нет, нужен только `jq`. Команда `npx claude-pace` лишь запускает установку, сама строка статуса работает на `Bash`.

Почему вместо лимитов стоит `--`?

Claude Code не передал поле `rate_limits`: версия старше 2.1.80 или провайдер его не отдает. Устаревшие значения инструмент не подставляет.

Обсуждение

Вопросов и отзывов пока нет.

Плагины

Плагин для Claude Code: строка статуса с контекстом, лимитами за 5 часов и 7 дней, стоимостью и расходом Codex, Gemini и z.ai

ПлагинШирокий доступ585Звезды репозитория

Статусная строка для Claude Code: расход токенов и денег, остаток контекста, лимиты и ветка git в четырех стилях и шести темах

ПлагинРасширенный доступ1,2 тыс.Звезды репозитория

Строка состояния Claude Code с 15 пресетами: модель, уровень размышлений, контекст и лимиты подписки Pro, Max и Ultra

ПлагинРасширенный доступ212Звезды репозитория

Монитор лимитов и расхода токенов для Claude Code, Codex, Antigravity и Grok CLI: меню macOS, трей Windows, отчеты в HTML

CLIРасширенный доступ345Звезды репозитория

claudetop выводит в строке состояния Claude Code стоимость сессии, кэш, окна лимитов тарифа и предупреждения о перерасходе

ПлагинРасширенный доступ212Звезды репозитория

Настраиваемая строка статуса для Claude Code: модель, ветка git, контекст, расход лимитов и другие виджеты

CLIРасширенный доступ13,5 тыс.Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
claude-pace (эта карточка)нет245
ccstatuslineнет13 533настраиваемые виджеты и оформление на Node.js, а здесь один Bash-файл и показатель темпа расхода лимита
Claude Code Statusline Proнет239строка состояния на Rust с темами Classic, Powerline и Capsule, а claude-pace работает на Bash и сравнивает расход лимита со временем окна

Коротко о README

Страница объясняет задачу строки статуса, показывает смысл значков темпа и дает три способа установки: плагином, через `npx` и вручную. Далее идут обновление, таблица сравнения с тремя другими строками статуса по рантайму и времени запуска, описание источников данных и ответы на частые вопросы про Node.js, сеть и исходный код.

Бейдж для README

Сообщить о проблеме

Foxx AIclaude-pace
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.