claude-pace — плагин
Строка статуса для Claude Code показывает расход лимитов за 5 часов и 7 дней и темп: хватит ли остатка до сброса окна
- 245 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает Bash-скрипт на каждое обновление строки статуса, примерно каждые 300 мс
- Меняет настройки Claude Code: прописывает `statusLine` в `~/.claude/settings.json`
Установка
- Работает в
В терминале, через 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
Статусная строка для Claude Code: расход токенов и денег, остаток контекста, лимиты и ветка git в четырех стилях и шести темах
Строка состояния Claude Code с 15 пресетами: модель, уровень размышлений, контекст и лимиты подписки Pro, Max и Ultra
Монитор лимитов и расхода токенов для Claude Code, Codex, Antigravity и Grok CLI: меню macOS, трей Windows, отчеты в HTML
claudetop выводит в строке состояния Claude Code стоимость сессии, кэш, окна лимитов тарифа и предупреждения о перерасходе
Настраиваемая строка статуса для Claude Code: модель, ветка git, контекст, расход лимитов и другие виджеты
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| 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, сеть и исходный код.