Repolode
Enviar
rbartoli

rbartoli/agent-usage-guard

Mod do Claude Code que segura a expansão de subagentes, prompts com muito contexto e loops de tentativas antes que consumam sua cota de uso.

Ver no GitHub
Estrelas
94
Forks
5
Issues abertas
0
Último commit
ontem

O que é?

agent-usage-guard é um mod para Claude Code que verifica cada inicialização de agente, prompt e chamada de ferramenta antes da execução. Ele lê as porcentagens de uso de 5 horas e semanal informadas para seu plano e contabiliza os agentes em execução e recentes em todas as sessões do Claude Code na máquina. Quando um limite é atingido, ele pergunta no próprio diálogo de perguntas do Claude Code ou recusa a operação e explica o motivo quando não há ninguém para responder, como em claude -p ou no Agent SDK.

As regras padrão limitam a quatro os agentes simultâneos, a doze as inicializações a cada dez minutos e a dez milhões os tokens de subagentes por janela. Também sinalizam contextos grandes, como prompts que releriam 500k tokens, ou rajadas de chamadas de ferramenta com muito contexto. Uma aprovação continua valendo até a condição deixar de existir ou expirar, para que a mesma pergunta não seja repetida a cada chamada. O guard falha em modo aberto: se um dos hooks apresentar erro, o evento prossegue.

Ele roda localmente, sem acesso à rede nem processos em segundo plano. Armazena contagens e categorias aproximadas, não o texto dos prompts, as entradas das ferramentas ou as saídas do modelo. O comando /agent-guard report resume as intervenções feitas.

Recursos principais

  • 01Pergunta antes de iniciar novos agentes quando o uso ultrapassa os limites definidos para a janela de 5 horas ou semanal do plano.
  • 02Limita os agentes simultâneos, as inicializações de agentes e os tokens de subagentes em todas as sessões da máquina.
  • 03Pergunta antes de prompts que releriam contextos grandes e limita rajadas de chamadas de ferramenta quando há muito contexto.
  • 04Recusa novas tentativas idênticas de chamadas de ferramenta após falhas repetidas.
  • 05Roda localmente, sem acesso à rede, e não armazena conteúdo de prompts ou ferramentas.
  • 06/agent-guard report resume as intervenções feitas.

Casos de uso

  • Executar pesquisas em paralelo ou fluxos de trabalho com vários agentes no Claude Code sem esgotar a janela de uso de cinco horas.
  • Criar scripts com claude -p ou tarefas do Agent SDK que devem recusar uma expansão intensa de agentes em vez de atingir um bloqueio de uso.
  • Impedir que tentativas repetidas em loop consumam o contexto de uma sessão longa.

Início rápido

  1. 1

    Adicione o marketplace ao Claude Code

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

    Instale o plugin

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

    Recarregue os plugins

    /reload-plugins
  4. 4

    Execute o comando status para ver o que o guard detecta

    /agent-guard

Antes de usar

  • Requer o Claude Code v2.1.287 ou posterior.
  • Alguns caminhos não são cobertos, como forks de /subtask e colegas de equipe executando em seus próprios painéis do terminal.
  • As leituras da janela Plan não estão disponíveis em sessões com chave de API.
  • Não é executado em uma sessão WSL do aplicativo Desktop.

Em coleções

Ferramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open source

Tópicos

#ai-agents#claude-code#rate-limiting#guardrails#subagents#developer-tools#claude-code-mod#claude-code-plugin#typescript#usage-limits

Perguntas frequentes

O que é agent-usage-guard?
Mod do Claude Code que segura a expansão de subagentes, prompts com muito contexto e loops de tentativas antes que consumam sua cota de uso. agent-usage-guard é um mod para Claude Code que verifica cada inicialização de agente, prompt e chamada de ferramenta antes da execução. Ele lê as porcentagens de uso de 5 horas e semanal informadas para seu plano e contabiliza os agentes em execução e recentes em todas as sessões do Claude Code na máquina. Quando um limite é atingido, ele pergunta no próprio diálogo de perguntas do Claude Code ou recusa a operação e explica o motivo quando não há ninguém para responder, como em claude -p ou no Agent SDK.
agent-usage-guard é gratuito? Qual é a licença?
agent-usage-guard é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
agent-usage-guard ainda é mantido?
Manutenção ativa. O último commit de agent-usage-guard foi em 6 de nov. de 2026.
Para que posso usar agent-usage-guard?
Executar pesquisas em paralelo ou fluxos de trabalho com vários agentes no Claude Code sem esgotar a janela de uso de cinco horas. Criar scripts com claude -p ou tarefas do Agent SDK que devem recusar uma expansão intensa de agentes em vez de atingir um bloqueio de uso. Impedir que tentativas repetidas em loop consumam o contexto de uma sessão longa.
Como instalar agent-usage-guard?
Adicione o marketplace ao Claude Code: /plugin marketplace add rbartoli/agent-usage-guard Instale o plugin: /plugin install agent-usage-guard@agent-usage-guard Recarregue os plugins: /reload-plugins Execute o comando status para ver o que o guard detecta: /agent-guard
Onde consigo agent-usage-guard?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/rbartoli/agent-usage-guard

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados