Claude Quota Guardian

Open source · Gratis · MIT

No pierdas tu trabajo ni tus tokens con Claude.

Que la tecnología trabaje para tu negocio, no al revés.

Cuando trabajas horas con Claude y la sesión se llena o se agota la cuota, el trabajo muere a mitad de camino. Guardian lo evita: guarda dónde ibas justo antes del corte y lo retoma solo, sin re-explicar nada.

CUOTA REAL DE TU CUENTAsesión + semanal → checkpoint
0%límite
Detecta → Guarda checkpoint → Retoma

Usas Claude Code

Instálalo y deja de perder sesiones largas.

  • Checkpoint automático en tu límite real de cuota (sesión 5h + semanal), no una estimación.
  • Retomas gastando casi cero tokens: el checkpoint es denso y la sesión sigue sola.
  • Lee tu cuota real: sesión, semanal y por modelo — el mismo número que ves en la app.
  • Extensión de navegador para ver tu consumo en vivo (badge + popup).
  • Gratis, MIT, cualquier plan (Pro/Max/Team), multi-OS.
$ guardian 
git clone https://github.com/LeonardoIAConsult/claude-quota-guardian.git
cd claude-quota-guardian
npm install
node bin/install.js
# Guardian corre solo: vigila tu cuota real y frena en tu límite.
# El checkpoint y la retoma son automáticos.
# Reporte de actividad cuando quieras:
node scripts/report.js
# Desinstalación limpia — solo quita lo suyo:
node bin/uninstall.js
node bin/uninstall.js --purge  # + borra los checkpoints
Ver en GitHub → Próximamente en el directorio de plugins de Claude (comunidad)
★ ¿Te sirve? Dale una estrella

Tienes un negocio y quieres IA

Guardian es la prueba de que sé implantar IA que aguanta el trabajo real.

No tienes que entender cómo funciona por dentro. Lo que importa: si tú o tu equipo van a apoyarse en IA para trabajar, alguien tiene que hacerlo bien — que sume horas, no que las queme. Eso es lo que hago.

Te ayudo a meter la IA (y Claude) en tu flujo o el de tu equipo, con estrategia y sin humo.

Agenda tu diagnóstico →

Cómo funciona, en 3 pasos

  1. 01

    Detecta el límite

    Vigila en segundo plano tu cuota real de Claude (sesión y semanal). Al llegar a tu límite, actúa.

  2. 02

    Guarda dónde vas

    Fuerza un checkpoint: qué construías, qué funcionó, qué no, y el próximo paso exacto.

  3. 03

    Retomas gastando casi nada

    Al reabrir, Claude lee el checkpoint y sigue solo. Cero re-explicación, mínimos tokens.

) Monitor NUEVO

Ve tu consumo en vivo, en el navegador

Una extensión para Chrome, Edge y Brave que muestra tu cuota real de Claude — sesión, semanal y por modelo— sin abrir Ajustes. Lee tu propia sesión de claude.ai; nunca toca tokens ni secretos.

claude.ai
Clic en el escudo ↗ para ver tu consumo
  • Un vistazo, cero clics. El número en la barra es el % de la ventana más apretada — verde, naranja o rojo según qué tan cerca estás del tope.
  • Las 3 ventanas reales. Sesión (5h) y semanal bloquean; los límites por modelo (Fable) solo avisan — si se agota uno, sigues con otro.
  • Sin tokens ni secretos. Usa la misma llamada que la pantalla de Uso de Claude, con las cookies de tu sesión. Único permiso: claude.ai.
Instalar la extensión → Carga en 20 segundos: chrome://extensions → Modo desarrollador → Cargar descomprimida
) Arquitectura [01 / 05]

Qué hace por dentro

Cada paso es un hook real de Claude Code — nada de magia, y puedes leer el código.

1

Mide, tras cada acción

En cada PostToolUse, check-usage lee tu cuota real del endpoint de uso de tu cuenta: sesión (5h), semanal y por modelo — el mismo número que ves en Ajustes → Uso.

2

Frena en tu límite real

Cuando tu cuota (sesión o semanal) llega al tope escribe pending.json, notifica al sistema y bloquea con PreToolUse: no más tokens sobre una sesión condenada. Los límites por modelo (Fable) solo avisan.

3

Guarda un checkpoint denso

/continuity-checkpoint escribe checkpoint-<ts>.md: qué construías, qué funcionó (con evidencia), qué no y el próximo paso exacto. Luego cierra el turno.

4

Vigila el reset

Un watcher en segundo plano (cadencia adaptativa 15→3→1 min) detecta cuándo tu cuota se reinicia y te avisa: «listo para continuar».

5

Retoma solo

Al reabrir el proyecto, SessionStart (resume-context) inyecta el checkpoint completo. El agente anuncia el próximo paso y sigue — cero re-explicación.

·

Señal real, no estimada

Lee la cuota account-wide de tu cuenta (sesión/semanal/por-modelo) — el mismo número que ves en la app, no un cálculo local aproximado. Funciona en cualquier plan (Pro/Max/Team) y cualquier OS (token desde archivo o Keychain en macOS).

Sin relanzamiento automático: tú decides cuándo reabrir. Guardian solo se encarga del guardado y la retoma.

Todo local, en ~/.claude/session-continuity/<proyecto>/ — tu asistente los lee al reabrir:

›checkpoint-<ts>.md ›pending.json ›state.json
) Confianza [02 / 05]

El checkpoint dice cómo lo sabe

Guardian no guarda un resumen borroso. Clasifica cada tarea con la evidencia detrás — para que la próxima sesión confíe en lo verificado y no re-intente lo que ya falló.

Una línea de un checkpoint reallib/report.js · L1
reporte HTML — evidencia: lib/report.js:1 · verificación: 4 tests ✓  HECHO
HECHO

Con evidencia de implementación y verificación (test, comando o salida). No basta el plan: necesita prueba de trabajo real.

PARCIAL

Empezado, con lo que falta explícito. La próxima sesión sabe exactamente dónde seguir.

NO HECHO

TODO, test en rojo o artefacto ausente. Pendiente — no marcado como hecho por optimismo.

EN PAUSA

Tu decisión de parar + la condición para reabrir. Guardian no lo reabre solo.

) Specs [03 / 05]

Datos duros

Todo verificable en el repo. Sin promesas que el código no cumpla.

Bloqueo
100% por cuota real: sesión (5h) + semanal bloquean; por modelo (Fable) solo avisa.
Señal
Cuota account-wide (sesión/semanal/por-modelo) del endpoint de uso — el mismo número de tu cuenta, no una estimación.
Monitor
Extensión de navegador (Chrome/Edge/Brave): badge + popup en vivo, sin tokens.
Plataformas
Windows (Task Scheduler) · macOS (launchd) · Linux (systemd/cron).
Instalación
1 comando · desinstalación limpia: no toca tus hooks.
Base
Node.js · licencia MIT · 198 tests (Node 18/20, CI).
Extensible
Arquitectura de adaptadores; hoy OpenAI Codex CLI (notify-only).
Extra
Aviso de downgrade Opus→Sonnet · override «continuar bajo mi riesgo» · Telegram opcional · reporte HTML de actividad.
Privacidad
Corre local, tu código nunca sale · sin cuenta · sin telemetría.
) Casos [04 / 05]

Cuándo te salva

Sesión larga que se corta

Llevas horas construyendo y el contexto se llena a mitad de una tarea. Guardian guarda el estado exacto; retomas sin re-explicar nada.

Cuota agotándose a ciegas

Tu cuota de sesión (5h) o semanal se acaba sin avisar. Guardian te frena antes de quemar tokens en una sesión que va a morir igual.

Varios proyectos a la vez

Cada proyecto tiene su checkpoint aislado (por hash de ruta). No se cruzan ni se pisan entre sí.

) Detalles [05 / 05]

Preguntas y privacidad

¿Cambia mi modelo o relanza solo?

No. Solo guarda y avisa; tú decides cuándo reabrir. El aviso de downgrade (Opus→Sonnet) es exactamente eso, un aviso — no cambia el modelo por su cuenta.

¿Con qué plan funciona?

Con cualquier plan de Claude (Pro, Max o Team): detecta solo tu cuota — sesión (5h), semanal y por modelo — leyendo el token de tu propia sesión de Claude Code. Por defecto el bloqueo es 100% por cuota real; el % de contexto se puede activar como respaldo si trabajas sin cuota de suscripción.

¿Cómo veo mi consumo sin abrir Ajustes?

Con la extensión de navegador (Chrome/Edge/Brave): un badge en la barra con el % de la ventana más apretada y un popup con sesión, semanal y por modelo. Lee tu sesión de claude.ai con tus cookies — sin tokens ni datos a terceros.

¿Toca mi settings.json?

Mergea sus hooks sin borrar los tuyos. El desinstalador solo quita lo suyo y deja el resto intacto.

¿Y otros proveedores de IA?

Hoy incluye monitoreo notify-only de OpenAI Codex CLI (lee sus logs de sesión locales). La arquitectura de adaptadores permite sumar más.

Privacidad primero

  • Corre local en tu máquina; lee las señales que Claude Code ya expone ahí. Tu código nunca sale.
  • Sin cuenta, sin telemetría de Guardian. Es open source (MIT): puedes leer cada línea.
  • Único saliente = notificaciones de Telegram, y solo si tú las activas (el token vive en tu config local, nunca en el repo).

Guardian en uso real

Lo estoy usando en mi propio trabajo y documentando los resultados — checkpoints, cortes evitados y sesiones retomadas. Próximamente: capturas reales de su reporte de actividad.

leonardoantolinez.com