Toda conta CliAI tem três medidores independentes. Juntos respondem à pergunta estou prestes a bater num limite? sem surpresas. Como funcionam, exatamente.
Três janelas
Saldo total. Decresce a cada requisição cobrável. Recarrega quando você compra.
Janela diária. Orçamento rolante de 24 horas. Reseta continuamente — sem cliff da meia-noite.
Taxa por minuto. Limite de curto prazo. Evita que picos acidentais (um loop fora de controle num script) drenem seu saldo.
$ clai statsAccount: u_8a7c…─ Total balance ──────── 2,847 / 5,000─ Daily window ──────── 37 / 200 (reset em 14h)─ Per-minute rate ────── 1 / 5─ Top tools today ───── find (12), git (8), kubectl (6)Se qualquer um se esgota, a próxima requisição volta com erro claro e o painel mostra qual janela bloqueou — sem 429 misterioso.
Quando o cache te economiza
O CliAI faz cache do comando gerado pelo hash de prompt + shell + locale. Mande a mesma tarefa exata na mesma shell exata, e na segunda vez você recebe o comando do cache — sem chamada ao LLM, sem queima de 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]O cache é por conta e fica no servidor. Invalida ao trocar de locale, trocar de shell, ou refinar — refinar é, por definição, requisição nova.
Se hits de cache contam
Por padrão, hits de cache não descontam saldo total — diária e por-minuto ainda incrementam, porque são proteção de taxa independente de ter havido trabalho real. Se você prefere o contrário (auditoria, justiça entre contas), o admin pode virar um flag no servidor; veja a documentação.
Vendo seu uso
clai stats é a fonte da verdade. Os mesmos números aparecem no cabinet, mas se você está fazendo coisa programática — envolver clai num passo de CI, embutir numa ferramenta — quer clai stats --json.
Veja também
- Preços — como o saldo total é dimensionado.
- Do one-liner ao script — quando uma requisição vira um passo recorrente de CI, a taxa por minuto é o medidor para observar.