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.
| 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
Atualize primeiro quando o app abre, mas falha em recursos. Um build antigo pode mostrar o editor e ainda bloquear agente, completions ou login. Depois da atualização, abra pelo lançador normal e confira a versão em About.
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
Abra About se possível, anote a versão e copie a mensagem antes de reinstalar.
Teste um workspace limpo
Abra uma pasta pequena com um arquivo e rode um prompt mínimo para separar falha global de problema do repositório.
Repare a camada certa
Atualize para problemas de versão, corrija PATH ou Node.js para npx, política aprovada para PowerShell e MCP para falhas do repositório.
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.
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
Use quando o app não abre, About mostra build antigo ou a interface informa versão sem suporte.
Camada de agente e modelo
Use em erros de agente, API de modelo, cota, tráfego alto ou local. Um prompt limpo e segunda rede ajudam a confirmar a causa.
Camada de terminal, Node.js e MCP
Use quando o erro menciona npx, node, npm, PATH, MCP ou PowerShell. Verifique comandos fora e alinhe o ambiente.
Como evitar novas falhas no Antigravity
Mantenha IDE, Node.js, npm, npx e ambiente shell alinhados. Muitas falhas aparecem quando Node é instalado em um perfil de terminal, mas o app aberto por ícone não herda o mesmo PATH.
Trate MCP como dependências reais. Fixe versões importantes, evite vários servidores experimentais ao mesmo tempo e mantenha um workspace mínimo para testar o agente base.
Use controle de versão e backup. Solução de problemas não deve exigir apagar o repositório. Antes de limpar cache ou remover instalação antiga, confirme que código e configuração são recuperáveis.
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
- Última versão do Antigravity - use quando o cliente está antigo ou sem suporte
- 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