설정을 바꾸기 전에 Antigravity 오류를 먼저 분류하기
Antigravity가 작동하지 않는다는 말은 여러 원인을 포함합니다. 모델 서비스, 계정, 네트워크 문제일 수도 있고 Node.js 누락, 잘못된 PATH, PowerShell 정책, MCP 서버 충돌, 오래된 설치본 때문일 수도 있습니다.
먼저 정확한 오류 문구를 복사하고 어디에서 나타나는지 확인하세요. 앱이 열리지 않으면 설치 파일, 운영체제, 보안 도구를 봅니다. 로그인 루프라면 브라우저, 쿠키, 시스템 시간, 프록시를 봅니다. Agent가 멈추면 모델, 할당량, MCP, 컨텍스트, 네트워크를 봅니다. 터미널 오류라면 PATH, Node.js, npx, npm, shell 정책을 확인합니다.
| 증상 | 가능한 원인 | 첫 조치 |
|---|---|---|
| Agent execution terminated due to error | 일시적인 모델 경로, 세션 문제, 불안정한 네트워크, MCP 충돌, 컨텍스트 한도. | Agent를 재시작하고 깨끗한 workspace에서 짧은 prompt를 테스트한 뒤, 그 테스트가 통과할 때만 MCP를 의심합니다. |
| Model API cannot be reached | 방화벽, 프록시, DNS, 지원되지 않는 지역, 만료된 로그인, 서비스 상태. | 로그인을 확인하고 신뢰할 수 있는 다른 네트워크에서 테스트하며 Google AI endpoint 접근을 허용합니다. |
| exec: "npx": executable file not found in PATH | Antigravity가 일반 터미널과 다른 환경을 상속했거나 Node.js가 설치되지 않았습니다. | Node.js LTS를 설치하고 외부 터미널에서 npx를 확인한 뒤 사용자 또는 시스템 PATH를 수정합니다. |
| PowerShell execution policy is blocking npx | Windows 정책이 npm shim script 실행을 차단합니다. | 승인된 정책 변경만 사용하거나 MCP 명령을 호환되는 방식으로 실행하도록 조정합니다. |
| 설치 파일은 열리지만 앱이 시작되지 않음 | 잘못된 아키텍처, 남아 있는 프로세스, 미지원 OS, 보안 소프트웨어, 손상된 폴더. | 요구 사항을 확인하고 모든 프로세스를 닫은 뒤 x64, ARM64, Apple Silicon, Intel, apt, dnf 중 맞는 build를 설치합니다. |
자주 발생하는 실패에 대한 빠른 수정
앱은 열리지만 기능이 실패한다면 먼저 업데이트하세요. 오래된 build는 에디터 화면을 보여주면서도 Agent, 자동완성, 로그인 기능이 실패할 수 있습니다. 업데이트 후 일반 런처로 실행하고 About에서 버전을 확인합니다.
설정을 크게 바꾸기 전에 Agent를 재시작합니다. 작은 폴더에서 짧은 prompt를 실행하세요. 이것도 실패하면 계정, 네트워크, 버전, 전역 도구 문제입니다. 성공한다면 원래 repository 쪽 문제일 가능성이 큽니다.
Model API, 지역, timeout, high traffic 같은 문구가 보이면 네트워크 경로를 확인합니다. 신뢰할 수 있는 두 번째 네트워크 테스트는 설치 문제와 프록시, DNS, 지역 차단 문제를 분리하는 데 도움이 됩니다.
Antigravity 복구 절차
정확한 오류와 버전 기록
가능하면 About을 열어 버전을 확인하고, 재설치 전에 오류 문구를 그대로 저장합니다.
깨끗한 workspace 테스트
작은 폴더와 파일 하나로 최소 prompt를 실행해 전역 문제인지 repository 문제인지 분리합니다.
맞는 계층만 수정
version 문제는 업데이트, npx 문제는 PATH/Node.js, PowerShell 문제는 승인된 policy, repository crash는 MCP를 확인합니다.
오류 문구별 해결 경로
표시된 오류와 일치하는 부분만 적용하세요. 정상적인 설정까지 건드릴 위험을 줄일 수 있습니다.
agent execution terminated due to error 해결
최소 폴더를 열고 작은 파일 하나를 읽도록 Agent에 요청합니다. 거기서도 실패하면 로그인을 갱신하고 Antigravity를 재시작하며 가능하면 모델을 바꾸고 잠시 후 다시 시도합니다. 실제 repository에서만 실패하면 MCP, 큰 파일, workspace rules, 과도한 context를 확인합니다.
npx가 PATH에 없는 문제 해결
Node.js LTS를 설치하고 새 터미널에서 node -v, npm -v, npx -v를 실행합니다. 외부에서는 되는데 Antigravity 안에서 안 되면 터미널에서 앱을 실행하거나 PATH에 Node.js를 추가한 뒤 완전히 재시작합니다.
PowerShell 차단 해결
Windows에서는 npm과 npx가 PowerShell 정책에 막힐 수 있습니다. 알 수 없는 script를 실행하지 마세요. 승인된 사용자 정책을 사용하거나 MCP 명령을 호환되는 방식으로 조정합니다.
로그인 루프와 Model API 실패 해결
시스템 시간, 기본 브라우저, 쿠키, 세션을 확인합니다. 오류에 지역, 할당량, 트래픽 문구가 있으면 재설치로 해결되지 않는 경우가 많습니다.
설치와 업데이트 실패 해결
Windows x64/ARM64, macOS Apple Silicon/Intel, Linux repository 중 맞는 설치 방식을 선택하세요. 오래된 프로세스를 닫고 새 버전이 정상 실행되는 것을 확인한 뒤 오래된 바로가기를 교체합니다.
앱과 버전 계층
앱이 시작되지 않거나 About에 오래된 build가 보이거나 UI가 지원되지 않는 version을 말할 때 확인합니다.
Agent와 모델 계층
Agent, Model API, quota, high traffic, 지역 오류에 사용합니다. 짧은 prompt와 다른 네트워크 테스트가 원인 분리에 도움이 됩니다.
터미널, Node.js, MCP 계층
npx, node, npm, PATH, MCP, PowerShell policy가 보이면 확인합니다. 외부 terminal과 Antigravity 내부 환경을 맞춥니다.
Antigravity 문제가 반복되지 않게 하는 방법
IDE, Node.js, npm, npx, shell 환경을 일관되게 유지하세요. Node.js를 터미널 profile에 설치했지만 아이콘으로 실행한 Antigravity가 같은 PATH를 상속하지 못하는 경우가 많습니다.
MCP 서버를 실제 의존성처럼 관리하세요. 안정성이 중요하면 version을 고정하고 여러 실험적 서버를 한 번에 추가하지 마세요. 기본 Agent가 되는지 확인할 최소 workspace를 남겨두면 진단이 빨라집니다.
코드는 version control과 backup으로 보호하세요. 문제 해결을 위해 repository를 삭제할 필요는 없습니다. cache나 오래된 설치를 지우기 전에 코드와 주요 설정을 복구할 수 있는지 확인하세요.
안전 참고
이해하지 못한 PowerShell, curl, shell 명령을 임의의 페이지에서 복사해 실행하지 마세요. IDE 수정 때문에 코드, token, 브라우저 세션을 위험하게 만들어서는 안 됩니다.
공식 및 내부 참고 링크
원인을 분리한 뒤 설치 파일, 호환성, 업데이트 경로를 확인할 때 사용하세요.
- Antigravity 공식 다운로드 페이지 - Google의 공식 설치 파일 위치
- Antigravity CLI 공식 문제 해결 - CLI와 command 관련 공식 참고 문서
- Antigravity 최신 버전 - 오래되었거나 지원되지 않는 client 문제일 때 확인
- Antigravity 시스템 요구 사항 - OS, 아키텍처, 메모리, 저장 공간, 네트워크 확인
- Antigravity 업데이트 가이드 - 구버전 경고와 오래된 shortcut 문제 해결