antigravity 설치 — 2.0과 IDE 차이
Antigravity는 antigravity.google/download 한 곳에서 받고 개인은 월 $0로 씁니다. 그런데 받기 전에 알아야 할 게 하나 있습니다 — Antigravity는 제품이 넷이고, 그중 "Antigravity 2.0"은 IDE가 아닙니다. 공식 문서는 2.0을 "IDE와 무관하게 동작하는 독립 데스크톱 애플리케이션"이라고 못 박습니다. 국내 소개 글 상당수가 "구글이 만든 IDE"라고만 쓰는 바람에 엉뚱한 걸 받고 헤매게 됩니다. 제품 구분부터 OS별 요구 사항, 첫 프로젝트 만들기까지 공식 문서 원문으로 확인해 정리했습니다. (2026년 9월 6일 확인 · Antigravity 2.0 v2.12.2 기준)
먼저 정리 — 제품이 네 가지다
다운로드 페이지에 여러 개가 보이는데, 이름이 비슷해서 헷갈립니다. 문서 기준으로 정리하면 이렇습니다.
| 제품 | 정체 | 이럴 때 |
|---|---|---|
| Antigravity 2.0 | 독립 데스크톱 앱. 에이전트를 띄우고 지켜보는 관제실. IDE가 아니다 | 에이전트 여러 개를 굴리고 결과를 보고받고 싶을 때 |
| Antigravity IDE | 에디터. 탭 자동완성·에이전트 패널이 들어간 진짜 IDE | 코드를 직접 쓰면서 옆에 에이전트를 두고 싶을 때 |
| Antigravity CLI | 터미널에서 쓰는 가벼운 버전 | 셸에서 다 해결하는 게 편할 때 |
| Antigravity SDK | 파이썬 SDK. 에이전트·도구·MCP를 직접 짠다 | 내 서비스에 에이전트를 붙일 때 |
기존 Gemini CLI를 쓰다 넘어온 경우라면 gemini cli 서비스 종료 글에 이전 과정을 정리해 뒀습니다.
antigravity 설치 — OS별 요구 사항
다운로드는 antigravity.google/download 한 곳입니다. OS를 고르면 됩니다.
| OS | 받는 것 | 요구 사항 |
|---|---|---|
| Windows | .exe (x64 / ARM64) |
Windows 10 (64비트) 이상 |
| macOS | .dmg (애플 실리콘 / 인텔) |
최소 macOS 12 (Monterey). 보안 업데이트를 받는 버전(보통 최신과 직전 두 개) |
| Linux | .tar.gz (x64 / ARM64) |
glibc 2.28 이상, glibcxx 3.4.25 이상(Ubuntu 20, Debian 10, Fedora 36, RHEL 8 정도) |
파일 크기는 작지 않습니다. 실제로 확인해 보니 윈도우 x64 설치 파일이 약 131MB, 맥 애플 실리콘 dmg가 약 178MB입니다. 네트워크가 느린 환경이면 시간을 좀 잡아 두세요.
설치 도중 "Keep Both"(둘 다 유지)와 "Replace"(교체) 중 무엇을 할지 묻는 창이 뜰 수 있습니다. 공식 문서는 Replace를 고르라고 안내합니다. 설치 과정에서 IDE를 다시 설치할지도 묻는데, 지금 안 받아도 나중에 같은 다운로드 페이지에서 받으면 됩니다.
첫 실행 — 프로젝트부터 만든다
Antigravity에서는 에이전트가 프로젝트 안에서만 움직입니다. 프로젝트가 곧 "이 폴더까지만 건드려도 된다"는 경계선입니다. 그래서 뭘 시키기 전에 프로젝트부터 만들어야 합니다.
- 왼쪽 사이드바에서 폴더에 + 가 붙은 아이콘을 누릅니다.
- New Project를 고릅니다.
- Add Folder로 로컬 폴더나 깃 저장소를 붙입니다. 여러 개를 붙이면 에이전트가 저장소를 넘나드는 문맥까지 함께 봅니다.
- Create를 누릅니다.
프로젝트마다 설정과 보안 정책이 따로입니다. 회사 코드와 개인 프로젝트를 한 프로젝트에 몰아넣지 말고 갈라 두는 편이 안전합니다.
에이전트 띄우기 — Local과 Worktree
프로젝트를 만들었으면 입력창에 목표를 적고 엔터를 칩니다. 그러면 모드를 고르는 창이 뜨는데, 여기가 중요합니다.
| 모드 | 어디서 작업하나 |
|---|---|
| Local Mode | 지금 열어 둔 폴더에서 직접 고친다 |
| New Worktree Mode | 격리된 깃 워크트리에서 고친다 — 지금 작업 중인 브랜치를 안 건드린다 |
감을 잡기 전이라면 워크트리 모드를 권합니다. 결과가 마음에 안 들면 그 워크트리만 버리면 되니, 작업 중이던 코드가 섞이지 않습니다.
단축키와 슬래시 명령
| 동작 | Windows / Linux | macOS |
|---|---|---|
| 대화 목록 열기 | Ctrl + K | Cmd + K |
| 파일 검색 | Ctrl + P | Cmd + P |
| 입력창으로 이동 | Ctrl + L | Cmd + L |
| 새 대화 | Ctrl + N | Cmd + N |
| 이전 / 다음 대화 | Alt + ↑ / ↓ | Option + ↑ / ↓ |
슬래시 명령은 입력창에 /를 쳐서 씁니다. 문서에 실린 것 중 실제로 손이 자주 가는 건 넷입니다.
| 명령 | 하는 일 |
|---|---|
/goal |
중간에 안 묻고 끝날 때까지 돌린다 |
/grill-me |
시작 전에 거꾸로 나에게 질문해 계획을 맞춘다 |
/schedule |
한 번만 예약하거나 주기적으로 돌린다 |
/browser |
크롬을 쓰는 디버깅 동작을 제어한다 |
요구 사항이 애매한 채로 시키면 엉뚱한 걸 만들어 놓습니다. 큰 작업일수록 /goal보다 /grill-me로 먼저 질문을 받는 쪽이 결과가 낫습니다.
요금 — 개인은 무료다
공식 요금 페이지 기준으로 개인용(For Individuals)은 월 $0이고, 구독 없이 그냥 받아 쓸 수 있습니다. 무료 플랜에 들어 있는 것이 생각보다 많습니다.
- 모델: Gemini 3.8 Flash · 3.7 Flash · 3.6 Flash · 3.1 Pro, Claude Sonnet 및 Opus 4.6, gpt-oss-120b
- 탭 자동완성 무제한
- 명령 요청 무제한
- 기본 주간 사용 한도 적용
구글 도구인데 클로드 모델이 목록에 함께 들어 있는 게 눈에 띕니다. 더 넉넉한 한도가 필요하면 Google AI Pro나 Ultra로 올리는데, 둘 다 "한도 완화 + AI 크레딧 풀"이라는 설명만 있고 구체적 숫자는 공개돼 있지 않습니다. 회사에서 쓸 거라면 Google Cloud를 통한 조직 플랜이 따로 있습니다.
권한과 샌드박스 — 받기 전에 볼 것
에이전트가 내 컴퓨터에서 명령을 돌리는 도구라 권한 설계를 보고 시작하는 게 좋습니다. Antigravity는 Deny(차단) · Ask(승인 요청) · Allow(자동 허용) 세 목록으로 관리하고, 충돌하면 Deny > Ask > Allow 순으로 강한 쪽이 이깁니다.
기본값은 대부분 Ask입니다. 파일 읽기·쓰기는 작업 공간 안에서는 자동 허용이지만 그 바깥은 물어보고, 웹 접근과 명령 실행도 기본이 물어보기입니다.
터미널 샌드박스는 셸 명령을 격리해 돌리는 기능입니다. ~/.ssh와 .env 같은 민감한 파일은 막고, 네트워크는 승인한 도메인으로만 열립니다. 가상 머신이나 도커 없이 OS 기능을 그대로 씁니다.
sandbox-exec를 쓴다고 적혀 있는데 윈도우는 그 표에 없습니다(문서 전체에서 언급을 찾지 못했습니다). 윈도우에서 쓴다면 샌드박스에 기대지 말고 권한 목록을 직접 좁혀 두는 편이 안전합니다.
자주 묻는 질문 (FAQ)
Q. "구글이 만든 IDE"라고 들었는데 받아 보니 에디터가 아닙니다.
Antigravity 2.0을 받으신 겁니다. 2.0은 에이전트 관제용 독립 앱이고, 에디터가 필요하면 Antigravity IDE를 따로 받아야 합니다. 같은 다운로드 페이지에 있습니다.
Q. 정말 무료인가요? 카드 등록이 필요한가요?
개인용 플랜이 월 $0이고, 요금 페이지에는 "구독 플랜 없이 경험한다"고 적혀 있습니다. 다만 주간 사용 한도가 걸리고 그 수치는 공개돼 있지 않으니, 많이 쓸 계획이면 한도부터 확인하는 게 좋습니다.
Q. 윈도우 7이나 32비트에서도 되나요?
안 됩니다. Windows 10 64비트 이상이 요구 사항입니다. 맥은 최소 12(Monterey)입니다.
Q. 회사 코드에 붙여도 되나요?
IDE는 기업 고객을 지원하지 않는다고 문서에 명시돼 있습니다. 조직 환경이라면 Antigravity 2.0이나 CLI를 쓰고, Google Cloud를 통한 조직 플랜을 확인하세요. 그 전에 프로젝트 단위로 폴더 경계와 권한 목록을 좁혀 두는 것을 권합니다.
마무리
정리하면 ① 뭘 받을지 먼저 정하고(2.0은 관제 앱, IDE는 에디터) → ② antigravity.google/download에서 OS에 맞는 파일 → ③ 프로젝트를 만들어 폴더 경계를 정한 뒤 → ④ 워크트리 모드로 첫 작업 순서입니다.
버전이 빠르게 올라가는 도구라 화면과 메뉴 이름은 바뀔 수 있습니다. 이 글은 Antigravity 2.0 v2.12.2 기준이며, 요금과 모델 목록은 특히 자주 바뀌니 실제 값은 공식 요금 페이지에서 다시 확인하시길 권합니다.
📚 참고 출처 (2026년 9월 6일 확인)
· Antigravity 2.0 — Overview
· Antigravity 2.0 — Getting Started
· Antigravity IDE — Overview
· Antigravity — Agent Permissions
· Antigravity — Terminal Sandbox
· Antigravity — Pricing
COMMENTS