CLI AI

Что считается запросом: квоты, кэш и счётчик, которому можно верить

2026-04-03

У каждого аккаунта CliAI три независимых счётчика. Вместе они отвечают на вопрос я сейчас упрусь в лимит? — без сюрпризов. Подробно про работу каждого.

Три окна

Общий баланс. Счётчик, уменьшающийся на каждый биллинговый запрос. Пополняется при оплате.

Дневное окно. Скользящий 24-часовой бюджет. Сбрасывается непрерывно — без обрыва в полночь.

Минутный лимит. Краткосрочный rate limit. Защищает от случайных всплесков (например, цикла в скрипте), которые могли бы вычерпать баланс.

clai 
$ clai statsAccount: u_8a7c…─ Total balance ──────── 2,847 / 5,000─ Daily window ────────  37 / 200 (сброс через 14ч)─ Per-minute rate ──────  1 / 5─ Top tools today ─────  find (12), git (8), kubectl (6)

Если любой из трёх исчерпан, следующий запрос возвращает понятную ошибку и панель покажет, какое именно окно его заблокировало — без таинственных 429.

Когда кэш экономит запрос

CliAI кэширует сгенерированные команды по хэшу промпта + shell + локали. Отправьте ту же задачу в той же shell — во второй раз получите команду из кэша, без вызова LLM, без списания баланса.

clai 
$ clai find files larger than 100MB→ find . -type f -size +100M[cache: hit · баланс не изменился]$ clai find files larger than 100MB→ find . -type f -size +100M[cache: hit · баланс не изменился]

Кэш per-account и хранится на сервере. Инвалидируется при смене локали, смене shell или уточнении промпта — рефайн по определению новый запрос.

Считаются ли cache-хиты

По умолчанию cache-хиты не списывают общий баланс — а дневной и минутный счётчики тикают всё равно, потому что они защитные независимо от того, реальная ли работа была. Если у вас другое мнение (аудит, честность между аккаунтами), есть серверный флаг, который админ может переключить; см. документацию.

Как смотреть использование

clai stats — источник истины. Те же цифры есть в кабинете, но если вы делаете что-то программное — оборачиваете clai в CI-шаг, встраиваете — берите clai stats --json.

См. также