구글 안티그래비티를 설치하고 바로 쓸 수 있는 상태까지 만드는 방법을 OS별로 정리했습니다. 처음 설치해 보는 분들이 가장 많이 막히는 지점이 초기 세팅인데, 운영체제마다 절차가 조금씩 달라서 헷갈리는 경우가 많습니다. 이 글에서는 Windows, macOS, Linux 각각의 설치 흐름과 첫 실행 후 꼭 해야 할 세팅을 순서대로 안내합니다.
목차
구글 안티그래비티(Google Antigravity)는 2025년 11월 구글이 공개한 에이전트 중심 AI IDE입니다. 단순한 코드 자동완성 도구가 아니라, AI 에이전트가 계획을 세우고 실행하고 결과까지 검증하는 흐름을 하나의 환경에서 처리합니다. Gemini 3 Pro를 기본 모델로 탑재하며 공개 프리뷰 기간에는 무료로 사용할 수 있습니다. 안티그래비티로 홈페이지를 직접 만들어보고 싶다면 구글 안티그래비티 홈페이지 만들기 3분 완성 가이드도 참고해 보세요.
구글 안티그래비티란 무엇인가
안티그래비티는 Visual Studio Code 기반 위에 구글이 새롭게 설계한 에이전트 퍼스트 개발 환경입니다. 기존 IDE에 AI 기능을 얹은 형태가 아니라, 에이전트가 프로젝트 전반을 주도하도록 설계되어 있습니다. Agent Manager, Editor, Browser 세 가지 뷰가 유기적으로 연결되며 사용자가 자연어로 지시하면 에이전트가 코드 작성, 터미널 실행, 브라우저 검증까지 직접 처리합니다.
성능 면에서도 WebDev Arena 기준 1487 Elo, SWE-bench Verified 76.2%를 기록하며 Cursor, Windsurf 등 기존 AI IDE와 비교해 경쟁력 있는 수치를 보여주고 있습니다. Gemini 3 Pro 외에 Claude Sonnet이나 GPT 계열 모델도 연동해서 사용할 수 있어 모델 선택의 유연성도 갖추고 있습니다.
OS별 설치 파일 다운로드 및 설치 방법
설치는 공식 사이트인 antigravity.google에서 운영체제에 맞는 파일을 받는 것에서 시작합니다. Windows, macOS, Linux 모두 지원하며 각 OS에 따라 파일 형식과 설치 절차가 다릅니다. 아래에서 OS별로 순서대로 설명합니다.
| 운영체제 | 다운로드 파일 형식 | 권장 사양 | 설치 소요 시간 |
|---|---|---|---|
| Windows | .exe (x64 또는 ARM64) | RAM 16GB 이상 권장 | 약 2~3분 |
| macOS | .dmg (Apple Silicon / Intel 구분) | M1 이상 또는 Intel Mac | 약 2~3분 |
| Linux | .deb 또는 .rpm | Ubuntu, Debian, Fedora 등 주요 배포판 지원 | 약 2분 |
macOS 설치 및 초기 세팅
macOS에서는 공식 사이트에서 .dmg 파일을 다운로드합니다. Apple Silicon(M1, M2, M3, M4 등) 탑재 기기와 Intel Mac 두 가지 버전이 제공되므로 본인의 Mac 칩에 맞는 파일을 선택해야 합니다. .dmg 파일을 열면 Antigravity 아이콘을 Applications 폴더로 드래그하는 화면이 나옵니다. 드래그 후 Applications 폴더에서 안티그래비티를 실행하면 됩니다. 처음 실행 시 macOS의 “확인되지 않은 개발자” 경고가 뜰 수 있는데, 시스템 환경설정의 보안 및 개인 정보 보호 탭에서 허용해 주면 됩니다.
실행 후 Google 계정으로 로그인합니다. 처음에는 개인 Gmail 계정으로 로그인하는 것이 가장 무난합니다. 로그인이 완료되면 워크스페이스(프로젝트 폴더)를 열어 시작하면 됩니다. macOS에서는 단축키 Cmd + , 로 설정 화면을 열 수 있고, Cmd + L 로 에이전트 채팅 패널을 바로 불러올 수 있습니다. 초기에는 에이전트 모드를 “검토 기반 개발(Review-based)”로 설정하는 것을 권장합니다. 에이전트가 작업 전 사용자에게 확인을 요청하기 때문에 처음 사용하는 분들이 흐름을 파악하기에 좋습니다.
Windows 설치 및 초기 세팅
Windows 사용자는 공식 사이트에서 .exe 파일을 다운로드합니다. 일반적인 데스크톱 PC라면 x64 버전을 선택하고, ARM 기반 기기라면 ARM64 버전을 받습니다. 다운로드 받은 .exe 파일을 실행하면 설치 마법사가 시작되고 안내에 따라 진행하면 됩니다. 설치 과정에서 Windows Defender가 “알 수 없는 앱” 경고를 띄울 수 있는데, “추가 정보”를 클릭하고 “실행” 버튼을 누르면 정상적으로 설치가 진행됩니다.
설치가 끝나면 안티그래비티를 실행하고 Google 계정으로 로그인합니다. 로그인 후 워크스페이스 폴더를 지정하면 에디터 화면이 열립니다. Windows에서는 단축키 Ctrl + , 로 설정을 열 수 있습니다. 처음 설치한 뒤에는 Settings에서 언어 및 테마(Light, Dark, Solarized Light 중 선택), 터미널 자동 실행 허용 범위 등을 확인해 두는 것이 좋습니다. 터미널 명령어 자동 실행(Terminal Command Auto Execution) 옵션은 초보자라면 “승인 후 실행” 모드로 두는 것을 권장합니다.
Linux 설치 및 초기 세팅
Linux에서는 배포판에 따라 .deb 또는 .rpm 파일을 공식 사이트에서 다운로드합니다. Ubuntu, Debian 계열은 .deb 파일을 받아 설치하고, Fedora나 RedHat 계열은 .rpm 파일을 사용합니다. 터미널을 열고 다운로드한 패키지 경로에서 설치 명령어를 실행합니다. Ubuntu 기준으로는 sudo dpkg -i [파일명].deb 또는 sudo apt install ./[파일명].deb 형식으로 설치할 수 있으며, 설치 완료 후 터미널에서 antigravity를 입력하면 프로그램이 실행됩니다.
Linux에서도 실행 후 Google 계정으로 로그인하는 과정은 동일합니다. 초기 세팅에서는 브라우저 서브에이전트 기능을 활성화해 두는 것이 유용합니다. 에이전트가 브라우저를 직접 제어해 결과를 검증하는 기능인데, 설치 후 “Install Browser Extension” 옵션을 통해 Chrome 확장 프로그램과 연결하면 됩니다. Linux 환경에서는 GPU 및 RAM 사양에 따라 응답 속도가 달라질 수 있으므로 16GB 이상의 RAM 환경을 권장합니다.
설치 후 공통 초기 세팅 핵심 포인트
OS에 관계없이 처음 설치 후 공통으로 확인해야 할 세팅이 있습니다. 먼저 에이전트 모드 선택입니다. 안티그래비티는 Planning 모드와 Fast 모드 두 가지를 제공합니다. Planning 모드는 에이전트가 계획을 먼저 수립하고 단계별로 실행하는 방식으로, 복잡한 작업이나 처음 사용하는 분들에게 적합합니다. Fast 모드는 계획 없이 빠르게 실행하는 방식으로 간단한 작업에 유리합니다. 초기에는 Planning 모드로 시작하는 것이 안전합니다.
다음으로 브라우저 서브에이전트 연결입니다. 에이전트가 브라우저를 통해 결과를 직접 검증하는 기능으로, Chrome 확장을 설치하고 antigravity.google 도메인을 허용 목록에 추가하면 활성화됩니다. 마지막으로 워크스페이스 규칙(Rules) 설정입니다. 에이전트가 코드를 작성할 때 따를 규칙을 미리 작성해 두면 일관된 코드 스타일을 유지할 수 있습니다. 워크스페이스 루트의 .agents/rules/ 경로에 .md 파일로 작성하면 됩니다.
FAQ
구글 안티그래비티는 무료로 쓸 수 있나요?
공개 프리뷰 기간 동안은 무료로 사용할 수 있으며 Gemini 3 Pro 모델 사용에 일정 한도가 제공됩니다. 다만 사용량이 많아지면 한도가 소진될 수 있고, Google AI Pro 구독을 연결하면 더 넉넉한 한도로 사용할 수 있습니다. 유료 요금제는 별도로 확인이 필요합니다.
설치할 때 어떤 사양이 필요한가요?
공식 권장 사양은 RAM 16GB 이상입니다. 그 이하 환경에서도 실행은 되지만 에이전트 응답 속도가 느려질 수 있습니다. Windows는 x64 또는 ARM64, macOS는 Apple Silicon 및 Intel 모두 지원하며, Linux는 Ubuntu, Debian, Fedora 등 주요 배포판을 지원합니다.
처음 실행했을 때 에이전트 모드는 뭘 선택하면 되나요?
처음 사용하는 분들은 검토 기반 개발(Review-based) 또는 Planning 모드로 시작하는 것을 권장합니다. 에이전트가 작업 전마다 사용자 확인을 요청하기 때문에 어떤 작업이 실행되는지 파악하면서 익숙해질 수 있습니다. 사용에 익숙해지면 Fast 모드나 에이전트 주도 개발 모드로 전환하면 됩니다.
구글 계정 말고 다른 계정으로도 로그인이 되나요?
안티그래비티는 Gmail 계정으로 로그인하는 것이 기본입니다. 개인 Gmail 계정으로 시작하는 것이 가장 간단하며, Google Workspace 계정으로도 로그인이 가능합니다. 다른 서드파티 계정 로그인은 현재 지원되지 않습니다.
정리 — 지금 바로 시작하기 위한 체크리스트
구글 안티그래비티는 설치 자체가 어렵지 않지만, OS별로 파일 형식과 실행 방법이 다르기 때문에 처음 설치할 때 헷갈리는 경우가 많습니다. 위에서 정리한 순서대로 따라가면 어떤 환경에서도 10분 내외로 첫 실행까지 마칠 수 있습니다. 설치 후에는 에이전트 모드 설정, 브라우저 서브에이전트 연결, 워크스페이스 규칙 작성까지 초기 세팅을 마쳐두면 본격적인 사용이 훨씬 수월해집니다.
- OS에 맞는 설치 파일을 antigravity.google 공식 사이트에서 다운로드한다 (Windows: .exe / macOS: .dmg / Linux: .deb 또는 .rpm)
- 실행 후 Gmail 계정으로 로그인하고 워크스페이스 폴더를 지정한다
- 초기 에이전트 모드는 Planning 또는 검토 기반 개발로 설정해 흐름을 익힌다
- 브라우저 서브에이전트 Chrome 확장 프로그램을 연결하고 URL 허용 목록을 설정한다
참고자료: Google Antigravity 공식 사이트 / Google Codelabs — Google Antigravity 시작하기 / Antigravity 공식 문서
