Antigravity 설치 방법: Windows, macOS, Linux

Antigravity 설치 방법과 과정

Antigravity 설치는 호환되는 패키지를 고르는 단계와 첫 실행을 확인하는 단계로 나뉩니다. 설치 프로그램이 성공해도 계정, 폴더 또는 권한이 잘못되면 바로 작업할 수 없습니다.

이 가이드는 Windows, macOS, Linux에 공통인 흐름을 설명합니다. 운영체제별 패키지 세부 사항은 다운로드 시 각 플랫폼 페이지에서 확인해야 합니다.

안전한 기준을 만들려면 한 번에 한 가지씩만 바꾸세요. 공식 소스에서 설치하고 작은 로컬 프로젝트를 연 다음 읽기부터 테스트합니다. 확장 기능, MCP, 터미널, 파일 쓰기는 나중에 필요한 작업에 맞춰 추가합니다.

다운로드 전에 컴퓨터 확인하기

시스템 설정에서 운영체제와 프로세서 아키텍처를 확인한 뒤 다운로드하세요. Windows ARM64와 x64, Mac Intel과 Apple Silicon, Linux 배포판에 맞지 않는 패키지를 혼동하는 실수가 자주 발생합니다.

앱, 캐시, 첫 프로젝트를 위한 여유 공간을 확보하세요. 에이전트가 파일을 검사할 때 메모리와 네트워크도 필요하므로 브라우저만 실행해도 버거운 컴퓨터는 큰 저장소에서 불안정할 수 있습니다.

올바른 Antigravity 설치 패키지 선택하기

Google 공식 다운로드 페이지를 열고 먼저 플랫폼을 선택하세요. 검색 결과, 복사한 저장소 경로, 제3자 미러는 패키지 이름과 릴리스가 바뀔 수 있으므로 영구적인 출처로 취급하지 않는 것이 좋습니다.

관리되는 컴퓨터라면 설치, 로그인, 네트워크 정책도 확인하세요. 회사 장치의 보안 안내는 개인 컴퓨터와 다를 수 있습니다.

현재 패키지, 버전, 아키텍처와 파일 정보는 공식 페이지가 기준입니다. 확인되지 않은 바이너리 URL이나 파일 크기는 이 글에서 주장하지 않습니다.

Antigravity 단계별 설치

시작하기 전에 이전 Antigravity 창을 닫으세요. 여러 버전이 서로 다른 워크스페이스를 사용하거나 오래된 바로 가기가 새 설치처럼 보일 수 있습니다. 소스 코드는 앱 폴더와 분리하세요.

Google에서 현재 패키지를 다운로드하고 파일 이름과 아키텍처를 메모와 비교하세요. 다운로드가 끝난 뒤 파일을 여세요.

일반 설치 프로그램을 실행하고 예상되는 보안 안내를 승인한 뒤, 특별한 이유가 없으면 기본 위치를 사용하고 완료될 때까지 기다립니다.

1. 1. 이전 복사본 닫기Antigravity와 이전 설치 프로그램을 종료하고 설정은 아직 삭제하지 않습니다.
2. 2. 공식 출처 열기다운로드 전에 Google 다운로드 또는 문서 페이지인지 확인합니다.
3. 3. 아키텍처 맞추기Windows x64/ARM64, Mac Intel/Apple Silicon 또는 맞는 Linux 경로를 고릅니다.
4. 4. 설치 프로그램 실행기본 화면을 따르고 가능하면 일반 설치 위치를 유지합니다.
5. 5. 새 복사본 실행설치 프로그램을 닫고 시스템의 일반 앱 항목으로 엽니다.
6. 6. 작게 시작하기큰 원격 저장소보다 작은 로컬 프로젝트를 먼저 엽니다.

• 올바른 바로 가기 — 바로 가기나 Applications가 방금 설치한 복사본을 엽니다.
• 예상된 안내 — 보안 대화상자가 올바른 앱을 표시합니다.
• 프로젝트 분리 — 소스 코드가 의도한 워크스페이스에 남아 있습니다.
• 새 세션 — 재시작으로 이전 프로세스와 PATH 상태를 정리합니다.

첫 실행과 로그인 완료하기

첫 실행에서는 인증, 약관 또는 온보딩 선택이 나타날 수 있습니다. 세션에 사용할 계정으로 로그인하세요. 로그인 화면이 반복되면 설치를 반복하기보다 계정이나 브라우저 연결을 확인해야 합니다.

평소 작업을 대표하는 가장 작은 프로젝트를 엽니다. 작은 폴더라면 파일 접근, 워크스페이스 루트와 편집기 화면을 쉽게 확인할 수 있습니다.

권한은 제한적으로 시작하세요. 첫 확인에는 읽기만으로 충분하며, 터미널, 브라우저, 네트워크, MCP, 쓰기는 구체적인 작업에 필요할 때만 켭니다.

실제 작업 전에 워크스페이스 검증하기

첫 검사는 네 가지를 확인해야 합니다. 예상한 빌드가 실행되었는지, 편집기가 올바른 파일을 보는지, 에이전트가 수정 없이 워크스페이스를 이해하는지, 설치된 버전을 확인할 수 있는지입니다.

변경 없이 최상위 폴더 요약이나 프로젝트 언어 설명을 요청하세요. 답변을 프로젝트 트리와 비교합니다. 부모 폴더, 빈 폴더 또는 다른 체크아웃을 설명한다면 먼저 루트를 수정하세요.

플랫폼, 아키텍처, 버전, 경로와 특이한 네트워크 또는 보안 설정을 기록하세요. 업데이트 뒤 같은 테스트를 반복하기 쉬워집니다.

• 버전 확인 — 정보 화면을 사용하고 파일 이름으로 추측하지 않습니다.
• 파일 확인 — 알려진 파일을 열고 프로젝트 트리를 비교합니다.
• 읽기 작업 테스트 — 쓰기나 삭제 명령 없이 요약 또는 검색을 요청합니다.
• 기준 기록 — 시스템, 아키텍처, 버전, 경로와 첫 증상을 저장합니다.

Antigravity 설치의 일반적인 문제 해결

문제를 실행, 인증, 워크스페이스, 권한 단계로 나누세요. 단계마다 해결 방법이 다릅니다.

설치 프로그램이 열리지 않음

출처, 다운로드 완료 여부, 시스템, 아키텍처와 보안 안내를 다시 확인합니다. 관리 장치에서는 정책 차단 여부를 문의합니다.

앱이 바로 종료됨

오래된 바로 가기 대신 설치 위치에서 실행하고 중복 복사본을 닫습니다. 프로세스가 멈췄다면 재시작하고 요구 사항을 확인한 뒤 설정을 지웁니다.

로그인 화면이 계속 돌아옴

브라우저 연결, 계정, 시계, 네트워크와 조직 정책을 확인합니다. 정확한 메시지를 저장하세요. 재설치로 인증 차단을 해결할 수는 없습니다.

폴더가 틀리거나 비어 있음

정확한 디렉터리를 열고 색인이 끝날 때까지 기다립니다. 원래 프로젝트가 원격, 마운트, 제외 대상 또는 매우 크다면 작은 로컬 폴더로 시험합니다.

바로 가기가 이전 버전을 실행함

정보 화면의 버전과 활성 경로를 비교하고 오래된 바로 가기만 고칩니다. 예전 설치 파일은 기록용으로 보관합니다.

버전 확인과 안전한 업데이트

이 사이트의 데스크톱 기록은 2026년 9월 8일 확인한 v2.12.2입니다. 다운로드 직전에 Google 공식 페이지에서 현재 버전, 패키지와 파일 정보를 다시 확인하세요.

데스크톱, CLI, 확장 기능과 MCP 버전은 따로 관리합니다. 업데이트 전 현재 동작을 기록하고 설치 후 같은 읽기 테스트를 반복하세요.