Antigravity가 작동하지 않나요? Agent, 로그인, npx, 설치 오류 9가지 해결법

재설치하기 전에 Agent, 네트워크, PATH, npx, PowerShell, MCP, 구버전, 설치 파일 중 어디에서 실패하는지 먼저 분리합니다.

Antigravity 다운로드 - Google Antigravity IDE 무료 다운로드

Antigravity 문제 해결 가이드

공식 다운로드 링크가 포함된 문제 해결 안내 Windows, macOS, Linux 2026년 9월 28일
Google 공식 다운로드 페이지 열기 진단 시작

먼저 진단하고, 클라이언트 손상이 확인될 때만 재설치하세요

Agent와 터미널 오류를 진단하는 Antigravity 화면
Antigravity가 작동하지 않을 때 코드 에디터에서 진단하는 흐름
Antigravity 문제는 실행, 로그인, 모델, Agent, 터미널 PATH, 설치 단계 중 어디에서 실패하는지 나누면 훨씬 빠르게 해결됩니다.

빠른 답변: Antigravity가 작동하지 않으면 재설치하기 전에 정확한 오류가 어느 계층에서 발생하는지 확인하세요. 로그인과 네트워크를 점검하고 작은 새 작업 공간에서 테스트한 뒤 npx, PATH, PowerShell 정책, MCP 도구와 설치된 빌드를 살펴봅니다. 앱 버전이 원인인 경우에만 Google 공식 배포 페이지를 이용하고 변경 후 같은 짧은 프롬프트로 다시 확인하세요.

문제 해결 목차

설정을 바꾸기 전에 Antigravity 오류를 먼저 분류하기

Antigravity가 작동하지 않는다는 말은 여러 원인을 포함합니다. 모델 서비스, 계정, 네트워크 문제일 수도 있고 Node.js 누락, 잘못된 PATH, PowerShell 정책, MCP 서버 충돌, 오래된 설치본 때문일 수도 있습니다.

먼저 정확한 오류 문구를 복사하고 어디에서 나타나는지 확인하세요. 앱이 열리지 않으면 설치 파일, 운영체제, 보안 도구를 봅니다. 로그인 루프라면 브라우저, 쿠키, 시스템 시간, 프록시를 봅니다. Agent가 멈추면 모델, 할당량, MCP, 컨텍스트, 네트워크를 봅니다. 터미널 오류라면 PATH, Node.js, npx, npm, shell 정책을 확인합니다.

도움을 요청하기 전에 정확한 메시지와 발생 시점, 정보 창의 운영체제와 앱 빌드, 새 작업 공간에서도 발생하는지, Node.js·PATH·프록시·MCP 도구의 최근 변경 사항을 기록하세요. 작은 로컬 프로젝트와 짧은 프롬프트로 재현합니다. 로그를 공유하기 전에 개인 경로, 이메일, 액세스 토큰, 쿠키, API 키, 비공개 코드를 삭제하세요. 전체 진단 아카이브를 공개 게시물에 올리지 마세요. 이 정보로 위험한 재설치를 반복하지 않고 앱, 계정, 네트워크, 터미널, 작업 공간 중 원인을 분류할 수 있습니다.

증상 가능한 원인 첫 조치
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를 설치합니다.

자주 발생하는 실패에 대한 빠른 수정

앱은 열리지만 이상하게 작동한다면 설정을 바꾸기 전에 정보 창과 Google 공식 다운로드 페이지를 확인하세요. 모든 프로세스를 닫고 해당 페이지의 설치 파일만 사용한 뒤 일반 시스템 바로 가기에서 Antigravity를 다시 열고 빌드를 확인합니다. 오래된 버전이 계속 보이면 오래된 바로 가기나 중복 설치를 찾으세요.

설정을 크게 바꾸기 전에 Agent를 재시작합니다. 작은 폴더에서 짧은 prompt를 실행하세요. 이것도 실패하면 계정, 네트워크, 버전, 전역 도구 문제입니다. 성공한다면 원래 repository 쪽 문제일 가능성이 큽니다.

Model API, 지역, timeout, high traffic 같은 문구가 보이면 네트워크 경로를 확인합니다. 신뢰할 수 있는 두 번째 네트워크 테스트는 설치 문제와 프록시, DNS, 지역 차단 문제를 분리하는 데 도움이 됩니다.

Antigravity 복구 절차

1단계

정확한 오류와 버전 기록

앱이 열리면 정보 창에서 빌드를 기록하고 재설치 전에 정확한 오류를 복사하세요.

2단계

깨끗한 workspace 테스트

비어 있는 작은 폴더에서 짧은 프롬프트를 테스트하고, 성공하면 원래 프로젝트의 도구와 규칙을 확인합니다.

3단계

맞는 계층만 수정

빌드 오류에만 업데이트하고 PATH, 셸 정책 또는 해당 MCP 명령을 수정하세요.

오류 문구별 해결 경로

표시된 오류와 일치하는 부분만 적용하세요. 정상적인 설정까지 건드릴 위험을 줄일 수 있습니다.

Agent execution terminated due to error 집중 체크리스트

이 정확한 오류가 보이면 모델 라우팅 문제와 로컬 도구 충돌을 분리하세요. 먼저 깨끗한 폴더에서 한 줄 prompt를 실행합니다. 성공하면 MCP 서버를 하나씩 다시 켜고 context를 줄이며 shell, npx, browser action 중 어디서 종료되는지 확인하세요. 'agent execution terminated due to error' 문구가 나오면 재시도하기 전에 모델 응답, 터미널 명령, 브라우저 작업, 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 중 맞는 설치 방식을 선택하세요. 오래된 프로세스를 닫고 새 버전이 정상 실행되는 것을 확인한 뒤 오래된 바로가기를 교체합니다.

앱과 버전 계층

정보 창과 Google 페이지를 비교하고 모든 프로세스를 닫은 뒤 바로 가기 대상을 확인하세요.

버전을 확인하는 Antigravity About dialog

Agent와 모델 계층

새 작업 공간과 신뢰할 수 있는 다른 네트워크를 시험해 프로젝트, 계정, 네트워크, 서비스 문제를 구분합니다.

Agent 실행을 테스트하는 Antigravity project view

터미널, Node.js, MCP 계층

외부 터미널에서 node, npx, PATH, 셸 정책, 해당 MCP 명령을 확인하세요.

터미널과 MCP를 확인하는 Antigravity panel

Antigravity 문제가 반복되지 않게 하는 방법

Node.js나 PATH를 바꾼 뒤 앱 전체를 다시 시작하고 일반 터미널과 Antigravity 안의 node, npx를 비교하세요.

캐시를 지우기 전에 설정을 백업하고 MCP 서버를 하나씩 시험하며 이해한 명령만 실행하세요.

안전 참고

이해하지 못한 PowerShell, curl, shell 명령을 임의의 페이지에서 복사해 실행하지 마세요. IDE 수정 때문에 코드, token, 브라우저 세션을 위험하게 만들어서는 안 됩니다.

FAQ - Antigravity가 작동하지 않음

재설치 후에도 Antigravity가 작동하지 않는 이유는?

재설치로 네트워크, 로그인, Node.js, PATH, MCP, 모델 서비스 문제를 해결할 수 없습니다. 새 작업 공간에서 오류에 맞는 조치를 시험하세요.

agent execution terminated due to error는 어떻게 고치나요?

Agent를 다시 시작하고 새 작업 공간에서 짧은 프롬프트를 시험하세요. 한 저장소만 실패하면 MCP와 규칙을 확인합니다.

npx executable file not found in PATH는 어떻게 고치나요?

Node.js를 설치하고 터미널에서 npx -v를 확인한 다음 같은 환경에서 Antigravity를 다시 시작하세요.

VPN이나 proxy가 Antigravity를 막을 수 있나요?

네. 불안정한 VPN, DNS 필터, 엄격한 proxy, 지원되지 않는 지역이 모델이나 로그인을 막을 수 있습니다.

MCP를 모두 꺼야 하나요?

아니요. 최근 추가했거나 log에 나온 MCP부터 확인하세요.

언제 Antigravity를 재설치해야 하나요?

빌드, 설치 파일, 아키텍처, 실행 문제를 확인했을 때만 재설치하고 모델과 npx 오류는 따로 해결하세요.

Antigravity는 열리는데 agent execution이 종료되는 이유는?

데스크톱 앱은 실행되어도 모델 경로, 계정 세션, MCP 서버, terminal PATH, context 크기 차이로 agent process가 나중에 실패할 수 있습니다. 재설치 전 clean prompt를 테스트하세요.

Antigravity agent execution terminated 오류를 어떻게 격리하나요?

빈 폴더에서 한 줄 프롬프트를 시험하고 도구가 시작되는지 확인하세요. 성공하면 MCP 서버를 하나씩 다시 켜고, 도구 시작 전에도 실패하면 로그인과 네트워크를 점검한 후 프로젝트 파일을 변경하세요.