agent-usage-guard es un complemento para Claude Code que actúa antes de que se produzca el gasto. Lee el uso en tiempo real de tu plan y retiene la expansión de subagentes, los prompts de mucho contexto y los bucles de reintento antes de que un agente se inicie, se envíe un prompt o se ejecute una llamada a herramienta. Los límites de agentes se aplican a todas las sesiones de Claude Code de tu equipo, y la expansión y el contexto elevado se limitan a cualquier nivel de uso, no solo cuando se está cerca del límite.
Cuando estás frente al teclado, el guardián te pregunta mediante el cuadro de diálogo de preguntas propio de Claude Code. Cuando nadie puede responder, lo rechaza y le explica a Claude el motivo, para que el modelo pueda esperar, agrupar el trabajo o detenerse. Los porcentajes de 5 horas y semanales que informa Claude Code determinan sus límites según el plan, y una aprobación levanta su condición hasta que la ventana se reinicia o expira, de modo que la misma pregunta no se repite llamada tras llamada.
El proyecto surgió tras un único prompt de investigación con esfuerzo máximo que generó 394 llamadas a subagentes, con 341 ejecutándose a la vez, y envió 84 millones de tokens de contexto a través de la API en diez minutos, lo que provocó un bloqueo. Los propios registros del autor contenían 12 bloqueos en 60 días. Cada protección elimina un factor de ese patrón de fallo.
El guardián es local y mínimo en cuanto a privacidad. No realiza llamadas de red, solo almacena recuentos y rangos aproximados, y nunca conserva el texto de los prompts, las entradas de las herramientas ni la salida del modelo. Falla en modo abierto, de modo que un hook defectuoso nunca interrumpe una sesión. La única excepción es un agente que no pudo evaluar a tiempo, que se rechaza para que Claude pueda volver a iniciarlo. Instálalo dentro de Claude Code v2.1.287 o posterior y luego ejecuta /agent-guard para ver lo que detecta.
Fuente: Hacker News · Resumido por HeadlinesBriefing