Cada cuenta de CliAI tiene tres contadores independientes. Juntos responden a la pregunta ¿estoy a punto de chocar con un límite? sin sorpresas. Cómo funcionan, exactamente.
Tres ventanas
Saldo total. Decrementa con cada solicitud facturable. Se recarga al pagar.
Ventana diaria. Presupuesto rodante de 24 horas. Se reinicia continuamente — sin acantilado a medianoche.
Ratio por minuto. Límite de corto plazo. Evita que picos accidentales (un loop fuera de control en un script) drenen tu saldo.
$ clai statsAccount: u_8a7c…─ Total balance ──────── 2,847 / 5,000─ Daily window ──────── 37 / 200 (reset en 14h)─ Per-minute rate ────── 1 / 5─ Top tools today ───── find (12), git (8), kubectl (6)Si cualquiera de los tres se agota, la siguiente solicitud devuelve un error claro y el panel muestra cuál ventana lo bloqueó — sin 429 misterioso.
Cuándo el caché te ahorra una solicitud
CliAI cachea comandos generados por el hash de prompt + shell + locale. Manda la misma tarea exacta en la misma shell exacta y la segunda vez recibes el comando del caché — sin llamada al LLM, sin descontar saldo.
$ clai find files larger than 100MB→ find . -type f -size +100M[cache: hit · saldo intacto]$ clai find files larger than 100MB→ find . -type f -size +100M[cache: hit · saldo intacto]El caché es por cuenta y vive en el servidor. Se invalida al cambiar de locale, cambiar de shell, o refinar — refinar es por definición una solicitud nueva.
Si los hits del caché cuentan
Por defecto, los hits del caché no descuentan saldo total — los contadores diario y por minuto sí, porque son protección de ratio sin importar si hubo trabajo real. Si tienes opinión opuesta (auditoría, equidad), tu administrador puede invertir un flag del servidor; mira la documentación.
Ver tu uso
clai stats es la fuente de verdad. Los mismos números aparecen en el cabinet, pero si haces algo programático — envolver clai en un paso de CI, embedirlo en una herramienta — clai stats --json es lo que quieres.
Ver también
- Precios — cómo se dimensiona el saldo total.
- Del one-liner al script — cuando una solicitud se vuelve un paso recurrente de CI, el ratio por minuto es el contador a vigilar.