agent-usage-guard é um mod para Claude Code que age antes de o gasto acontecer. Ele lê o uso ao vivo do seu plano e retém a expansão de subagentes, prompts de contexto pesado e laços de nova tentativa antes que um agente inicie, um prompt seja enviado ou uma chamada de ferramenta seja executada. Os limites de agentes se aplicam a todas as sessões do Claude Code na sua máquina, e a expansão e o contexto pesado são limitados em qualquer nível de uso, não apenas perto do limite.
Quando você está diante do teclado, o guardião pergunta na própria caixa de diálogo de perguntas do Claude Code. Quando ninguém pode responder, ele recusa e informa o Claude sobre o motivo, para que o modelo possa esperar, agrupar o trabalho ou parar. As porcentagens de 5 horas e semanais que o Claude Code informa alimentam seus limites adaptados ao plano, e uma aprovação suspende sua condição até que a janela seja reiniciada ou expire, de modo que a mesma pergunta não se repita a cada chamada.
O projeto nasceu depois que um único prompt de pesquisa em esforço máximo gerou 394 chamadas de subagentes, com 341 rodando ao mesmo tempo, e enviou 84 milhões de tokens de contexto pela API em dez minutos, o que acionou um bloqueio. Os próprios registros do autor continham 12 bloqueios em 60 dias. Cada proteção remove um fator desse padrão de falha.
O guardião é local e minimiza a privacidade. Ele não faz chamadas de rede, guarda apenas contagens e faixas aproximadas e nunca mantém o texto dos prompts, as entradas das ferramentas ou a saída do modelo. Ele falha de forma aberta, então um hook quebrado nunca interrompe uma sessão. A única exceção é um agente que não pôde ser avaliado a tempo, que é recusado para que o Claude possa iniciá-lo novamente. Instale-o no Claude Code v2.1.287 ou superior e depois execute /agent-guard para ver o que ele enxerga.
Fonte: Hacker News · Resumido por HeadlinesBriefing