Преамбула
При сбое прогона в чате появляется блок с заголовком, подсказкой и кнопками: Как установить, Открыть настройки, Выбрать другую модель, Диагностика.
Типовые коды
| Симптом / код | Что делать |
|---|---|
cli_not_found | Установите CLI провайдера (claude, cursor-agent, gemini) или смените провайдер |
missing_api_key | Ключ в настройках провайдера → Проверить → Сохранить |
missing_endpoint | Укажите адрес (Ollama, эндпоинт) |
| 401 / authentication_failed | claude auth login, cursor-agent login, проверьте ключ облака |
| 402 / quota_exhausted | Баланс провайдера или модель Призмы; смените модель |
| 429 / rate_limit | Подождите или резервная модель |
| 5xx / сеть | Интернет, firewall; для Ollama — «Проверить»/«Обнаружить» |
resume_failed | Новая ветка/чат — сессию CLI не восстановить |
Шаги диагностики
- Нажмите Диагностика в карточке ошибки или откройте #diag-modal из «Состояния системы».
Окно диагностики - Проверьте статус каждого провайдера (настроен / ошибка).
- При наличии другого настроенного провайдера карточка может предложить переключиться.
Если что-то не работает
Оркестрация пустая
MCP оркестратора не стартовал — toast при запуске; Claude идёт встроенными субагентами.
cursor_mcp_barrier_failed
Битый .cursor/cli.json или hooks — проверьте cursor-agent и node из его установки.