CLI AI

Was als Anfrage zählt: Kontingente, Caching und ein Zähler, dem du trauen kannst

2026-04-03

Jeder CliAI-Account hat drei unabhängige Zähler. Zusammen beantworten sie die Frage gleich erreiche ich ein Limit? — ohne Überraschungen. So funktioniert das Ganze.

Drei Fenster

Gesamtguthaben. Wird mit jeder abrechnungsrelevanten Anfrage dekrementiert. Steigt beim Aufladen.

Tagesfenster. Rollendes 24-Stunden-Budget. Wird kontinuierlich zurückgesetzt — keine Mitternachts-Klippe.

Pro-Minute-Rate. Kurzzeitiges Rate-Limit. Verhindert, dass eine ausgebrochene Schleife im Script dein Guthaben leert.

clai
$ clai statsAccount: u_8a7c…─ Total balance ──────── 2,847 / 5,000─ Daily window ────────  37 / 200 (Reset in 14h)─ Per-minute rate ──────  1 / 5─ Top tools today ─────  find (12), git (8), kubectl (6)

Ist eines erschöpft, gibt die nächste Anfrage einen klaren Fehler zurück, und das Panel zeigt, welches Fenster blockiert hat — kein mysteriöses 429.

Wann der Cache dir eine Anfrage spart

CliAI cached generierte Befehle per Hash aus Prompt + Shell + Locale. Schick exakt dieselbe Aufgabe in exakt derselben Shell, und beim zweiten Mal kommt der Befehl aus dem Cache — kein LLM-Call, kein Guthaben-Abzug.

clai
$ clai find files larger than 100MB→ find . -type f -size +100M[cache: hit · Guthaben unverändert]$ clai find files larger than 100MB→ find . -type f -size +100M[cache: hit · Guthaben unverändert]

Der Cache ist pro Account und liegt auf dem Server. Er invalidiert beim Locale-Wechsel, Shell-Wechsel oder Refining — Refining ist per Definition eine neue Anfrage.

Ob Cache-Treffer zählen

Standardmäßig dekrementieren Cache-Treffer das Gesamtguthaben nicht — Tagesfenster und Pro-Minute-Rate ticken trotzdem, weil sie Schutz-Limits sind, unabhängig davon, ob echte Arbeit anfiel. Wenn du anderer Meinung bist (Audit-Trail, Fairness), kann dein Administrator einen Server-Flag umlegen; siehe Doku.

Verbrauch einsehen

clai stats ist die Quelle der Wahrheit. Dieselben Zahlen stehen im Cabinet, aber wenn du programmatisch arbeitest — clai in einen CI-Schritt packen, in ein Tool einbetten — willst du clai stats --json.

Siehe auch

  • Preise — wie das Gesamtguthaben dimensioniert wird.
  • Vom Einzeiler zum Script — wenn eine Anfrage zum wiederkehrenden CI-Schritt wird, ist die Pro-Minute-Rate der Zähler, den man im Auge behält.