Conteúdo da guia
Diagnostique o erro do Antigravity antes de alterar qualquer coisa
Antigravity não funciona pode indicar causas diferentes. Algumas vêm do serviço de modelos, conta ou rede; outras são locais, como Node.js ausente, PATH incorreto, política PowerShell, MCP quebrado ou instalação antiga.
Copie a mensagem exata e observe onde ela aparece. Falha ao abrir aponta para instalador, sistema ou segurança. Loop de login aponta para navegador, cookies, hora e proxy. Erro do agente envolve modelo, cota, MCP, contexto ou rede. Erro de terminal envolve PATH, Node.js, npx, npm ou shell.
Antes de pedir ajuda, anote a mensagem exata, quando aparece, sistema operacional e versão do app em Sobre, se ocorre num espaço limpo e mudanças recentes no Node.js, PATH, proxy ou ferramentas MCP. Reproduza o problema num projeto local pequeno com um comando curto. Remova caminhos pessoais, e-mails, tokens de acesso, cookies, chaves de API e código privado antes de compartilhar registros. Não publique um arquivo completo de diagnóstico. Esses dados ajudam a identificar se o problema do Antigravity está no app, na conta, na rede, no terminal ou no espaço de trabalho sem repetir reinstalações arriscadas.
| Sintoma | Causa provável | Primeira correção |
|---|---|---|
| Agent execution terminated due to error | Rota temporária do modelo, sessão, rede instável, queda de MCP ou limite de contexto. | Reinicie o agente, teste um prompt pequeno em workspace limpo e desative MCP apenas se esse teste funcionar. |
| Model API cannot be reached | Firewall, proxy, DNS, local sem suporte, sessão expirada ou disponibilidade do serviço. | Confirme o login, teste outra rede confiável e permita endpoints do Google AI. |
| exec: "npx": executable file not found in PATH | Antigravity herdou ambiente diferente do terminal ou Node.js não está instalado. | Instale Node.js LTS, verifique npx no terminal e corrija o PATH do usuário ou sistema. |
| PowerShell execution policy is blocking npx | A política do Windows bloqueia scripts shim do npm. | Use uma mudança de política aprovada ou configure o comando MCP com invocação compatível. |
| O instalador abre, mas o app não inicia | Arquitetura errada, processo antigo, OS sem suporte, antivírus ou pasta corrompida. | Confira requisitos, feche processos e instale o build correto x64, ARM64, Apple Silicon, Intel, apt ou dnf. |
Correções rápidas para falhas comuns
Se o app abre, mas se comporta de forma estranha, confira Sobre e a página oficial de downloads do Google antes de mudar configurações. Feche todos os processos, use somente o instalador publicado ali, abra o Antigravity pelo atalho normal e confira a versão. Se uma versão antiga continuar aparecendo, procure atalhos obsoletos ou instalações duplicadas.
Reinicie o agente antes de mudar configurações. Teste um prompt curto em uma pasta pequena. Se falhar, olhe conta, rede, versão ou ferramentas globais. Se funcionar, o problema provavelmente está no repositório.
Verifique a rede quando a mensagem cita API de modelo, local, timeout ou tráfego alto. Uma segunda rede confiável ajuda a separar instalação quebrada de proxy, DNS ou bloqueio regional.
Fluxo de recuperação do Antigravity
Registre o erro exato e a versão
Se o app abrir, anote a versão em Sobre e copie o erro exato antes de reinstalar.
Teste um workspace limpo
Teste uma instrução curta numa pasta limpa; se funcionar, confira as ferramentas e regras do projeto original.
Repare a camada certa
Atualize apenas em falhas de versão; corrija PATH, a política do shell ou o comando MCP indicado.
Correções por texto de erro
Use apenas o caminho que combina com a mensagem para não danificar uma configuração que já funcionava.
Agent execution terminated due to error: checklist focada
Quando esse erro exato aparece, separe roteamento de modelo de falhas de ferramentas locais. Primeiro teste um prompt de uma linha em uma pasta limpa. Se funcionar, reative MCP um a um, reduza contexto e veja se shell, npx ou navegador é o passo que termina. Para a mensagem exata 'agent execution terminated due to error', registre a etapa que falhou antes de tentar novamente: resposta do modelo, comando de terminal, acao do navegador ou ferramenta MCP. Se a mesma ferramenta local falhar sempre, revise a configuracao; falhas antes de qualquer ferramenta apontam mais para login, rede, cota ou roteamento.
Corrigir agent execution terminated due to error
Abra uma pasta mínima e peça ao agente para ler um arquivo pequeno. Se falhar também, renove login, reinicie o app, troque de modelo se possível e tente mais tarde. Se só o repositório real falhar, revise MCP, arquivos grandes, regras do workspace e prompts com contexto excessivo.
Corrigir npx fora do PATH
Instale Node.js LTS, abra um terminal novo e execute node -v, npm -v e npx -v. Se funcionar fora, mas não dentro do Antigravity, inicie o app pelo terminal ou adicione Node.js ao PATH.
Corrigir bloqueios do PowerShell
No Windows, npm e npx podem chamar scripts bloqueados pela política. Não rode scripts aleatórios. Use política de usuário aprovada ou um comando MCP compatível.
Corrigir loops de login e API de modelo
Confira hora do sistema, navegador padrão, cookies e sessão. Se o erro fala de local, cota ou tráfego alto, reinstalar normalmente não ajuda.
Corrigir instalação e atualização
Escolha o instalador certo: Windows x64 ou ARM64, macOS Apple Silicon ou Intel, e pacotes de repositório em Linux suportado. Feche processos antigos e substitua atalhos só depois de confirmar a nova versão.
Camada de app e versão
Compare Sobre com a página do Google, feche os processos e confira o destino do atalho ao reabrir.
Camada de agente e modelo
Teste uma instrução limpa e outra rede confiável para separar falhas de projeto, conta, conexão ou serviço.
Camada de terminal, Node.js e MCP
Confira node, npx, PATH, a política do shell e o comando MCP indicado num terminal externo.
Como evitar novas falhas no Antigravity
Depois de mudar Node.js ou PATH, reinicie o app inteiro e compare node e npx com seu terminal normal.
Faça backup das configurações antes de limpar caches; teste MCP um por vez e execute só comandos compreendidos.
Nota de segurança
Não execute comandos PowerShell, curl ou shell copiados de páginas aleatórias sem entender. Um reparo do IDE não deve expor código, tokens ou sessão do navegador.
Links oficiais e internos úteis
Use estas páginas para verificar instalador, compatibilidade e atualização depois de identificar a falha.
- Página oficial de download do Antigravity - destino oficial de instaladores do Google
- Solução oficial de CLI do Antigravity - referência oficial de CLI e comandos
- Requisitos do Antigravity - verifique OS, arquitetura, memória, armazenamento e rede
- Guia de atualização do Antigravity - corrija avisos de versão antiga e atalhos obsoletos