agent-usage-guard — плагин
Мод Claude Code: удерживает веер субагентов, тяжелый контекст и циклы повторов до того, как они съедят окно лимитов.
- 97 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Мод может отклонять запуск агентов и вызовы инструментов, когда окно лимитов почти заполнено.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/agent-usage-guardОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Мод может отклонять запуск агентов и вызовы инструментов, когда окно лимитов почти заполнено.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
agent-usage-guard читает использование вашего плана и срабатывает до траты: перед запуском агента, отправкой промпта или вызовом инструмента. Лимиты на число агентов действуют во всех сессиях Claude Code на машине. Когда вы за клавиатурой, мод спрашивает через родной диалог вопросов Claude Code. Когда отвечать некому, он отказывает и объясняет модели причину, чтобы та подождала, разбила работу или остановилась. По умолчанию новые агенты требуют подтверждения при заполнении окна на 80 процентов и отклоняются при 95. Одно подтверждение действует, пока условие не сменится, поэтому вопрос не повторяется на каждом вызове. Команда `/agent-guard report` показывает, что мод сделал.
Для кого. Тем, кто запускает параллельных субагентов и упирается в пятичасовое или недельное окно лимитов Claude Code.
Подходит, если
- Исследовательский промпт на максимальном усилии порождает сотни субагентов за минуты.
- Длинную сессию возобновили через пару часов, и первая отправка пересоберет протухший кеш на сотни тысяч токенов.
- Ночной цикл повторов или расписание тратит лимит, пока вы спите.
- Нужен отчет, где и как сработала защита.
Не подходит, если
- Подписки нет и лимит окна вас не касается.
- Нужна статистика расходов по проектам: мод хранит только счетчики и грубые корзины.
- Версия Claude Code старше 2.1.287.
Пример запроса к агенту
Покажи, что видит agent-usage-guard, и смоделируй вопрос при слишком большом числе параллельных агентов.Ограничения
Мод требует Claude Code версии 2.1.287 или новее и поддержки модов, которые включены по умолчанию. Он считывает процент 5-часового и недельного окон, которые сообщает Claude Code, поэтому точность защиты зависит от этих данных. При сбое одного из хуков событие проходит дальше, чтобы сломанная защита не ломала сессию. Исключение составляет агент, который мод не смог оценить: его отклоняют, и Claude запускает его заново. Мод локальный, без сети и процессов, хранит только счетчики и никогда тексты промптов или вывод модели.
Как отключить. Выполните `/plugin uninstall agent-usage-guard@agent-usage-guard` либо выключите моды в настройках Claude Code. Сохраненные счетчики лежат в каталоге данных мода.
Частые вопросы
Как проверить, что мод работает?
Запустите `/agent-guard`, чтобы увидеть данные мода. Команда `/agent-guard simulate concurrency` покажет вопрос при слишком большом числе агентов без блокировки и расходов.
Что мод делает при 95 процентах окна?
Отказывает в новых агентах, отклоняет `ScheduleWakeup` и `CronCreate` и один раз просит сессию закончить шаг и сказать, что осталось.
Отправляет ли мод данные в сеть?
Нет. Он работает локально, без сети и процессов, хранит только счетчики и грубые корзины без текста промптов.
Не сломает ли он мою сессию?
Нет, при сбое хука событие проходит дальше. Исключение одно: агента, который мод не смог оценить, отклоняют, и Claude запускает его заново.
Как отключить моды?
Настройки отключения описаны в обзоре модов Claude Code. Сам мод удаляется командой `/plugin uninstall`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныНабор для Claude Code: восемь агентов по фазам работы, 21 скилл и хуки, которые держат агента в заданных рамках.
Готовая сборка для Claude Code: агенты, слеш-команды, скиллы, защитные хуки, правила и MCP-подключения одной установкой
agentplay превращает локальные сессии Claude Code, Codex и Cursor в карту файлов и таймлайн с повтором шагов.
Три плагина для Claude Code: оркестратор savvy-flow с субагентами по уровням и два мода с панелью прогресса и таймером кэша
Плагин для Claude Code и Codex: ищет код под задачу по символам и истории Git, собирает контекст и подбирает роль специалиста.
Плагин для Claude Code с семью специализированными субагентами и гейтами одобрения: агент предлагает план и ждет подтверждения перед изменением кода
Коротко о README
Мод держит расходы лимитов под контролем по правилам: окна плана, скорость роста, число агентов и тяжесть контекста. Автор приводит свои логи за 60 дней с 12 блокировками по лимитам как причину создания.