Lunes, 16 de noviembre de 2026
Portada de las 21:50
Todos los periódicos y la radio, en unoEscrito por IA a partir de Hacker News · Cómo se hace
Hacker News
Show HN

Show HN: agent-usage-guard, un mod de Claude Code para proteger tu ventana de uso

agent-usage-guard es un mod de Claude Code que frena, antes de que se produzca el gasto, la proliferación de subagentes, los prompts con mucho contexto y los bucles de reintentos. Lee el uso real de tu plan y cuenta los agentes de todas las sesiones de la máquina.

Foto: vía github.com

Leer el artículo aquíArtículo original (github.com) 7 comentarios en Hacker News

Escucha la noticia3 min

El autor cuenta que una tarde lanzó a Claude Code un prompt de investigación con el esfuerzo al máximo. Se generaron 394 llamadas a subagentes, 341 de ellas simultáneas, y se procesaron 84 millones de tokens de contexto en diez minutos. La sesión terminó con «Claude usage limit reached» y quedó bloqueado hasta que se reinició la ventana. Sus registros de 60 días recogían 12 bloqueos y 166 ventanas de diez minutos con ráfagas de agentes.

El mod actúa antes del gasto: antes de que arranque un agente, se envíe un prompt o se ejecute una llamada a una herramienta. Lee los porcentajes de la ventana de 5 horas y de la semanal que informa Claude Code. Por defecto pide aprobación para nuevos agentes cuando una ventana llega al 80 %, los rechaza al 95 %, y también pide confirmación si la ventana de 5 horas sube 20 puntos en 10 minutos. Limita a 4 los agentes simultáneos y a 12 los arrancados por cada 10 minutos en toda la máquina, y fija 10 millones de tokens de subagentes por cada 10 minutos. Impide que un subagente lance sus propios agentes (profundidad 1).

Con el contexto, añade una nota al prompt a partir de 300.000 tokens y pregunta si se va a releer medio millón (compactar y enviar, enviar igualmente o cancelar). También pregunta tras 20 llamadas a herramientas con 400.000 tokens de contexto, y antes de reescribir la caché de una sesión pesada (150.000 tokens) que lleva una hora inactiva. En los bucles, rechaza el reintento idéntico tras 3 fallos idénticos y pausa la creación de agentes 10 minutos tras 5 llamadas de agente rechazadas.

Las preguntas aparecen en el diálogo propio de Claude Code. Una aprobación se mantiene mientras dure la condición, para no repetir la pregunta. Si nadie puede responder (claude -p, Agent SDK, modo dontAsk), el mod rechaza y explica el motivo a Claude, con mensajes que escalan si se repite. Se controla con /agent-guard (status, allow, pause, resume, report, help). Funciona sin red ni procesos, guarda solo recuentos y no el texto de los prompts. Si un hook falla, el evento sigue adelante, salvo un agente que no pudo evaluarse a tiempo. Son unas 2.400 líneas de TypeScript sin dependencias, y requiere Claude Code 2.1.287 o posterior.

Tiene límites: no ve los teammates en paneles de terminal propios, ni sesiones de otras máquinas, ni las herramientas que ejecuta la propia API. Los forks de /subtask solo se cuentan, no se pueden retener. Los agentes internos de Claude Code, como las sugerencias de prompt o la compactación, no se cuentan.

En Hacker News

«Show HN: agent-usage-guard – a Claude Code mod to protect your usage window» · puesto 27 · 20 puntos · enviado por zzyyxx332211

Lo que dicen los comentarios

Con solo cinco comentarios, la conversación es breve. El autor explica en el primero cómo nació la herramienta: una versión previa basada en hooks, usada 75 días, redujo la mayor ráfaga de 365 agentes a 27 y las peticiones de más de 500k tokens de contexto del 14,5 % al 0,6 %. Aun así, los bloqueos aumentaron porque muchas sesiones principales en paralelo también agotan la ventana, de ahí que el recuento entre sesiones sea su punto fuerte. Otro hilo cuestiona si compactar una sesión fría es buena idea, ya que podría reactivarla igualmente, y otro usuario sugiere usar un modelo más barato para compactar.

  • Con un primer sistema basado en hooks, usado 75 días, la mayor ráfaga bajó de 365 agentes a 27 y las peticiones de más de 500k tokens, del 14,5 % al 0,6 %. Los bloqueos subieron, porque muchas sesiones principales en paralelo también agotan la ventana.
    — zzyyxx332211, leer el comentario
  • Tenía la impresión de que compactar resucitaba la sesión de todos modos, así que no es buena idea en una sesión fría. ¿Es cierto, o de verdad sale más barato?
    — Robin_Message, leer el comentario
  • Se puede usar un modelo más tonto (luna o haiku) para compactar y evitar ese problema.
    — bhu8, leer el comentario

Pregunta sobre esta noticia

Respuestas automáticas a partir de las noticias de El Autómata, sus fuentes y la radio. Pueden contener errores: comprueba los enlaces.

Esta noticia la ha redactado una inteligencia artificial a partir de las fuentes citadas, con el criterio editorial de El Autómata (equilibrio, atribución y solo hechos publicados). Puede contener errores: consulta las fuentes originales. Modelo: claude-sonnet-5.5.