Problemas comuns
O Windows diz que o app é perigoso (SmartScreen)
O instalador ainda não tem assinatura de código, então na primeira execução o Windows mostra "O Windows protegeu o computador". Clique em Mais informações → Executar assim mesmo. Baixe sempre de kraniqa.com.
O antivírus apagou o app ou o instalador
Alguns antivírus, como o Kaspersky, já marcaram o KraniQA por engano. Instale a versão mais recente do site, que corrige os casos conhecidos. Se o antivírus ainda assim colocar o arquivo em quarentena, restaure-o pela quarentena e adicione uma exceção para a pasta do KraniQA, e nos avise em suporte@kraniqa.com com o nome do antivírus.
"Node não encontrado" ou "Node antigo"
O Playwright do seu projeto roda no Node do computador. Instale o Node 20 ou mais novo (a versão LTS de nodejs.org), feche e abra o KraniQA, e o primeiro uso confere de novo.
Minha conta do Claude é gratuita
O agente do KraniQA roda no Claude Code, que precisa de uma assinatura paga do Claude: Pro, Max, Team ou Enterprise. Com a conta gratuita o login funciona, mas o agente não responde. Assine em claude.ai/upgrade e entre de novo.
"O login do Claude estava sendo renovado"
Acontece na primeira mensagem depois de um tempo sem usar o app, quando o login do Claude está sendo renovado. O app já tenta de novo sozinho uma vez; se a mensagem aparecer, clique em Tentar de novo alguns segundos depois.
O app pede para confirmar o e-mail
O plano (e o teste grátis) é liberado depois de confirmar o e-mail da sua conta Claude com um código de 6 dígitos, uma vez por computador. Clique em "Confirmar e-mail" em Configurações → Geral e digite o código que chegar. Não chegou? Confira o spam e peça de novo depois de um minuto.
O teste passa no app e falha no CI
Veja Rodar os testes no CI: quase sempre é a URL, uma credencial que não foi para os secrets ou o login salvo, que não vai para o git.
O Jev parou
O indicador ao lado do modo, no chat, diz o motivo: cota da semana esgotada, chave inválida ou sem crédito na OpenRouter. Veja Jev.
Mandar o diagnóstico para o suporte
Configurações → Geral → Escrever para o suporte copia o diagnóstico (versão, estado do app e o fim do log, sem e-mails, pastas ou chaves) e abre um e-mail para o suporte: é só colar.