rbartoli/agent-usage-guard

Что это?

Ключевые возможности

• 01Запрашивает подтверждение перед запуском новых агентов, если использование превышает заданные пороги 5-часового или недельного лимита плана.
• 02Ограничивает число одновременно работающих агентов, запусков агентов и токенов субагентов во всех сессиях на машине.
• 03Запрашивает подтверждение перед выполнением запросов, которые повторно прочитают большой контекст, и ограничивает всплески вызовов инструментов при большом контексте.
• 04Отказывает в повторном выполнении идентичных вызовов инструментов после нескольких неудач.
• 05Работает локально, без доступа к сети, и не хранит содержимое запросов или вызовов инструментов.
• 06Команда /agent-guard report подводит итог выполненным вмешательствам.

Сценарии использования

• Параллельные исследования и многоагентные процессы в Claude Code без исчерпания 5-часового лимита использования.
• Автоматизация задач через claude -p или Agent SDK, которые должны отказывать при чрезмерном запуске субагентов, а не приводить к блокировке.
• Защита от циклических повторных попыток, расходующих контекст в длительной сессии.

Быстрый старт

1. 1

   Добавьте marketplace в Claude Code

   /plugin marketplace add rbartoli/agent-usage-guard
2. 2

   Установите плагин

   /plugin install agent-usage-guard@agent-usage-guard
3. 3

   Перезагрузите плагины

   /reload-plugins
4. 4

   Выполните команду status, чтобы узнать, что обнаруживает guard

   /agent-guard

Что важно знать

• !Требуется Claude Code версии v2.1.287 или новее.
• !Некоторые сценарии не поддерживаются, например форки /subtask и участники команды, работающие в собственных вкладках терминала.
• !Просмотр окна Plan недоступен в сессиях с ключом API.
• !Не запускается в WSL-сессии приложения Desktop.

В подборках

Темы

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

Что такое agent-usage-guard?

Мод для Claude Code, который ограничивает запуск субагентов, запросы с большим контекстом и циклы повторных попыток, прежде чем они израсходуют лимит плана. agent-usage-guard — мод для Claude Code, который проверяет каждый запуск агента, запрос и вызов инструмента перед выполнением. Он считывает процент использования 5-часового и недельного лимитов плана и подсчитывает активных и недавно запущенных агентов во всех сессиях Claude Code на машине. При достижении лимита мод задаёт вопрос во встроенном диалоговом окне Claude Code или отказывает в выполнении и объясняет причину, если ответить некому, например при запуске через claude -p или Agent SDK.

agent-usage-guard можно использовать бесплатно? Какая у него лицензия?

agent-usage-guard распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

agent-usage-guard всё ещё поддерживается?

Активно поддерживается. Последний коммит в agent-usage-guard — 6 нояб. 2026 г..

Для чего можно использовать agent-usage-guard?

Параллельные исследования и многоагентные процессы в Claude Code без исчерпания 5-часового лимита использования. Автоматизация задач через claude -p или Agent SDK, которые должны отказывать при чрезмерном запуске субагентов, а не приводить к блокировке. Защита от циклических повторных попыток, расходующих контекст в длительной сессии.

Как установить agent-usage-guard?

Добавьте marketplace в Claude Code: /plugin marketplace add rbartoli/agent-usage-guard Установите плагин: /plugin install agent-usage-guard@agent-usage-guard Перезагрузите плагины: /reload-plugins Выполните команду status, чтобы узнать, что обнаруживает guard: /agent-guard

Где скачать agent-usage-guard?

Исходный код и инструкции по установке — на GitHub: https://github.com/rbartoli/agent-usage-guard