Google Antigravity 사용법 — 다운로드·설치·첫 에이전트까지 단계별 정리

Google Antigravity를 설치는 해놨는데 "Agent Manager가 뭐고 Manager View는 어디서 여는 건지" 감이 안 잡혀 창만 열고 닫는 분이 많습니다. 그대로 묵히면 퍼블릭 프리뷰 기간에 Gemini 3 Pro를 무료로 붙여볼 수 있는 멀티 에이전트 감각을 놓치고, 나중에 유료화된 뒤 기초 메뉴 위치부터 다시 익혀야 합니다. AI 코딩 도구 릴리스 노트를 꾸준히 정리해 온 블로그 운영자 시각에서, Google 공식 사이트(antigravity.google)와 Codelabs 튜토리얼을 기준으로 Google Antigravity 사용법을 단계별로 정리했습니다.

 

이 글을 끝까지 읽으면 다운로드 URL부터 시스템 요구사항, 초기 설정 3가지 선택지, Agent Manager에서 첫 미션 쏘기, 5개 에이전트 병렬 실행, 모델 선택 기준까지 한 번에 잡힙니다.

1. Google Antigravity가 뭔가 (간단 소개)

Google Antigravity는 구글이 공개한 에이전트 우선(agent-first) 개발 환경입니다. 공식 사이트 주소는 https://antigravity.google/ 이며, 공식 튜토리얼은 https://codelabs.developers.google.com/getting-started-google-antigravity 에 올라와 있습니다.

 

기존 AI IDE가 "에디터 옆에 채팅창이 붙어 있는 형태"라면, Antigravity는 반대입니다. 앱을 처음 실행하면 에디터 화면이 아니라 Agent Manager라는 대시보드가 뜹니다. 코드 파일을 여는 것보다 "어떤 에이전트에게 무슨 미션을 맡길 것인가"를 먼저 결정하게 만드는 구조라고 Codelabs 문서가 설명합니다.

 

Gemini 3 Pro가 기본 엔진이지만, 같은 도구 안에서 Gemini 3 Flash / Claude Opus / Claude Sonnet 도 함께 선택할 수 있습니다. 한 미션 내에서도 에이전트마다 다른 모델을 배정할 수 있다는 점이 차별점입니다.

2. 시스템 요구사항과 가격

본격 설치 전에 사용 환경이 요구사항을 맞추는지 확인할 필요가 있습니다. 공식 다운로드 페이지에 명시된 스펙을 표로 정리하면 다음과 같습니다.

항목	요구사항
macOS	Monterey 12 이상
Windows	Windows 10 이상 (64-bit)
Linux	64-bit, glibc 2.28+, glibcxx 3.4.25+
계정	Google 계정
가격	퍼블릭 프리뷰 기간 무료
Rate Limit	Gemini 3 Pro에 대해 "generous rate limit" 제공

"generous rate limit"이 구체 숫자로 공개돼 있지는 않지만, 공식 발표는 퍼블릭 프리뷰 기간 동안 개인 개발자가 체감 수준에서 제한을 느끼기 어려운 수준이라는 표현을 쓰고 있습니다. 단, 프로덕션 배포용이 아니라 실험·학습용 할당량이라는 점은 주의가 필요합니다.

3. 다운로드·설치 단계 (Windows 기준)

공식 Codelabs 튜토리얼에 안내된 설치 절차는 다음과 같습니다. Windows 11 환경을 예로 정리합니다.

1. 브라우저로 https://antigravity.google/ 접속
2. 상단 다운로드 버튼에서 본인 OS 선택 → Windows 64-bit 인스톨러 받기
3. 다운받은 .exe 파일 실행 → 기본 옵션으로 설치 진행
4. 설치 완료 후 Antigravity 앱 실행
5. 첫 화면에서 Google 계정 로그인
6. 로그인 성공 시 Agent Manager 대시보드가 기본 진입 화면으로 열림

macOS / Linux 도 같은 흐름입니다. 차이는 인스톨러 파일 확장자(.dmg, .deb / .rpm 또는 AppImage)뿐입니다. 사내망 프록시 환경이면 Google 계정 OAuth 팝업이 차단될 수 있으니, 최초 로그인은 제한 없는 회선에서 수행하는 것을 권장합니다.

트러블슈팅 — 설치 후 앱이 뜨지 않는 경우

• 증상: 인스톨러는 정상 종료됐는데 실행 시 창이 뜨지 않거나 "필수 라이브러리 누락" 메시지가 뜸
• 원인: Linux에서 주로 발생합니다. 배포판의 glibc / glibcxx 버전이 요구치(glibc 2.28+, glibcxx 3.4.25+)보다 낮은 경우
• 해결: ldd --version 으로 glibc 버전 확인 후, 충족하지 못하면 배포판을 최신 LTS로 업그레이드. Windows 10 미만도 동일한 증상이 보고됩니다

4. 첫 실행 — 초기 설정 3가지

로그인 직후 Antigravity는 작업 스타일을 정하는 초기 설정 3가지를 묻습니다. 공식 Codelabs 튜토리얼은 일반 개발자에게 아래 조합을 권장합니다.

설정 항목	선택값	의미
개발 모드	Agent-assisted development	에이전트가 대부분의 작업을 수행, 사람은 계획과 변경 리뷰 담당
터미널 실행	Terminal execution (Auto)	ls, npm install 같은 안전한 루틴 명령은 자동 실행 허용
리뷰 정책	Review policy (Agent decides)	에이전트가 스스로 "사람 리뷰가 필요한 시점"을 판단

이 조합은 AI에게 충분한 자율성을 주면서도, 리스크 있는 변경에서는 사람 개입이 걸리도록 설계돼 있습니다. 처음부터 수동 리뷰로 강제하면 에이전트의 흐름이 끊겨 멀티 에이전트 가치가 절반으로 줄어든다는 얘기가 공식 문서에 언급돼 있습니다.

 

장점은 자동 실행 덕에 진행 속도가 빠르다는 점이고, 단점은 팀 규모가 커서 변경 추적이 민감한 환경에서는 Auto 실행 범위가 예상보다 넓게 잡힐 수 있다는 점입니다. 팀원이 5명 이상이거나 프로덕션 리포지토리에 직접 붙일 계획이라면 Terminal execution을 Manual로 내리고 Review policy도 수동으로 바꾸는 게 낫습니다.

5. 핵심 개념 5가지 — Agent Manager / Manager View / Workspace / Artifacts / Multi-Model

Google Antigravity 사용법의 뼈대는 이 다섯 개념으로 정리됩니다. 공식 Codelabs 튜토리얼이 반복해서 등장시키는 용어이기도 합니다.

① Agent Manager — 앱을 실행했을 때 처음 보이는 화면 자체를 말합니다. 여러 에이전트를 한눈에 띄우고 지시·모니터링하는 홈 대시보드 역할입니다.

② Manager View — 왼쪽 사이드바에 작은 아이콘이 있고, 클릭하면 Mission Control이 열립니다. 여기서 여러 에이전트를 동시에 생성하고 상태를 확인할 수 있습니다. 예를 들어 서로 다른 버그 5개를 잡아야 한다면, 에이전트 5개를 만들어 각각 한 버그씩 배정하는 식의 사용이 가능합니다.

③ Workspace — VS Code의 "폴더 열기"와 동일한 개념입니다. 상단 메뉴에서 File → Open Folder를 선택하고 로컬 프로젝트 폴더를 지정하면 해당 폴더가 워크스페이스가 됩니다.

④ Artifacts System — 에이전트가 만들어내는 검증 가능한 산출물 체계입니다. 코딩을 바로 시작하지 않고, 먼저 기술 로드맵(technical roadmap)을 Artifact로 생성한 뒤 그 로드맵을 따라 구현을 진행합니다. 사람이 중간에 로드맵만 리뷰해도 방향이 크게 빗나가는 것을 잡을 수 있도록 설계돼 있습니다.

⑤ Multiple Models — 한 도구 안에서 Gemini 3 Pro, Gemini 3 Flash, Claude Opus, Claude Sonnet 을 고를 수 있습니다. 같은 미션 안에서도 에이전트마다 다른 모델을 붙일 수 있는 점이 핵심입니다.

6. 첫 미션 실행 — Manager View에서 미션 보내기

초기 설정을 마쳤으면 첫 미션을 실행할 차례입니다. 공식 Codelabs 튜토리얼이 추천하는 흐름은 다음과 같습니다.

1. 왼쪽 사이드바의 Manager View 아이콘 클릭 → Mission Control 화면이 열립니다
2. 상단 메뉴의 File → Open Folder로 작업할 로컬 프로젝트 폴더를 엽니다 (새 프로젝트면 빈 폴더 OK)
3. Mission Control 상단 입력 필드에 미션 문장을 타이핑합니다
4. 첫 미션으로 튜토리얼이 권장하는 문장은 다음과 같습니다

Look at this project and tell me what it does.

5. 엔터를 누르면 에이전트가 프로젝트 전체를 스캔 → 기술 로드맵 Artifact를 먼저 생성 → 단계별로 실행 결과를 보여줍니다

이 첫 미션은 의도적으로 "코드 수정이 없는 읽기 전용 탐색"이라, Artifacts 시스템이 어떻게 로드맵을 만들고 보여주는지를 안전하게 관찰하기 좋습니다. 결과 화면에서 로드맵을 클릭하면 에이전트가 무엇을 단계별로 확인했는지 트리 형태로 확인할 수 있습니다.

7. 멀티 에이전트 활용 — 5개 에이전트 병렬 실행

Manager View의 진짜 가치는 에이전트를 여러 개 띄울 때 드러납니다. 예컨대 서로 다른 이슈 5건을 처리해야 하는 상황이라면 다음처럼 쓸 수 있습니다.

1. Manager View 상단의 New Agent 버튼을 5번 눌러 에이전트 5개를 만듭니다
2. 각 에이전트에 서로 다른 미션을 줍니다 (예: 버그 #101 재현·수정, 문서 오타 정리, README 업데이트, 로그 포맷 통일, 의존성 마이너 업그레이드)
3. 에이전트들이 각자 로드맵을 만들고 동시에 진행합니다
4. Mission Control 대시보드에서 진행률·변경 파일·완료 여부를 한 보드에서 확인합니다

팀에서 500건+ 코드 리뷰를 해오면서 본 패턴 중에, 작은 변경 다수를 병렬로 굴리는 시나리오가 실제로 제일 잘 맞습니다. 하나의 큰 기능을 에이전트 하나한테 맡기면 아직은 중간 이탈이 적지 않게 보이는데, 작게 쪼갠 미션 여러 개를 병렬로 돌리는 방식이 퍼블릭 프리뷰 단계에서 가장 안정적으로 쓰입니다.

 

단, 에이전트 5개를 동시에 굴리면 rate limit 체감이 훨씬 빨라집니다. 모든 에이전트를 기본값인 Gemini 3 Pro로 두면 할당량이 빠르게 소모되니, 단순 작업은 다음 섹션에서 다루는 모델 교체를 병행하는 편이 낫습니다.

8. 모델 선택 전략 — Gemini 3 Pro / Flash / Claude Opus / Sonnet

같은 도구 안에서 네 가지 모델을 골라 쓸 수 있다는 점이 Antigravity의 실용 포인트 중 하나입니다. 각 모델의 성격과 추천 용도를 공식 설명 기준으로 정리합니다.

모델	성격	어울리는 미션
Gemini 3 Pro	기본·균형형, Antigravity 기본 모델	일반 코딩·기획·리팩토링
Gemini 3 Flash	응답 속도 우선, 경량	대량 파일 스캔, 단순 수정, 문서 생성
Claude Opus	복잡한 추론·긴 문맥·디버깅 강점	큰 기능 설계, 아키텍처 결정, 까다로운 버그
Claude Sonnet	Opus 대비 빠르고 가벼움, 범용	일반 구현 작업, 코드 리뷰 보조

에이전트별로 모델을 섞을 수 있다는 점이 핵심입니다. 예를 들어 버그 5개를 병렬 처리할 때, 단순 오타나 의존성 업그레이드는 Gemini 3 Flash에 맡기고, 재현 조건이 복잡한 버그 한 건만 Claude Opus로 돌리는 식의 운용이 가능합니다. 정답은 없습니다. 반복 작업이 많으면 Flash·Sonnet 쪽, 설계·추론 비중이 크면 Pro·Opus 쪽으로 무게중심을 옮기는 감각 정도로 충분합니다.

9. 퍼블릭 프리뷰 주의사항과 마무리

Google Antigravity 사용법 전체를 정리했지만, 현재가 퍼블릭 프리뷰 단계라는 점에서 운용상 몇 가지 주의점이 있습니다.

• 프로덕션 금물: 할당량·가용성 보장이 없는 프리뷰 단계입니다. 회사 중요 리포지토리나 실제 고객 데이터에 직접 붙이는 용도는 피하는 게 낫습니다
• Auto 실행 범위 체크: 초기 설정에서 Terminal execution을 Auto로 뒀다면 어떤 명령이 자동 실행됐는지 Mission Control 로그에서 주기적으로 확인할 필요가 있습니다
• Git 병행 권장: 에이전트가 여러 파일을 동시에 건드리기 때문에, 별도 브랜치에서 작업하고 자주 커밋·푸시하는 흐름을 유지해야 변경 추적이 안전합니다
• 할당량 관리: Gemini 3 Pro 기본값으로 멀티 에이전트를 돌리면 rate limit 체감이 빠릅니다. 단순 작업은 Flash·Sonnet 쪽으로 분산시키는 편이 낫습니다

정리하면 Google Antigravity 사용법의 뼈대는 "Agent Manager로 들어가 → Manager View에서 에이전트를 만들고 → Workspace를 열고 → 미션을 타이핑하면 → Artifacts로 로드맵이 먼저 나오고 → 구현이 이어진다" 입니다. 오늘은 Google Antigravity 사용법의 다운로드·설치·초기 설정·첫 미션·멀티 에이전트·모델 선택까지 핵심 동선만 정리했습니다. 동일 환경이면 위 단계 그대로 따라가도 됩니다.

자주 묻는 질문

Q. Google Antigravity는 유료인가요?
A. 2026년 4월 기준 퍼블릭 프리뷰 단계이며 Google 계정만 있으면 무료로 사용할 수 있습니다. Gemini 3 Pro에 대한 관대한(generous) rate limit이 포함된다고 공식 발표에 명시돼 있습니다. 단, 프리뷰 특성상 할당량·가용성이 보장되지는 않으며, 추후 유료화 또는 요금제 분리 가능성은 열려 있습니다.

 

Q. Windows 10에서도 돌아가나요?
A. 네, 공식 다운로드 페이지에 Windows 10 이상(64-bit)이 요구사항으로 명시돼 있습니다. macOS는 Monterey 12 이상, Linux는 64-bit에 glibc 2.28+, glibcxx 3.4.25+ 가 충족되면 됩니다. Linux에서 실행되지 않는 경우 대부분 glibc 버전 미달이 원인입니다.

 

Q. Agent Manager와 Manager View는 같은 건가요?
A. 다릅니다. Agent Manager는 앱을 켜면 처음 뜨는 대시보드 화면 자체를 말합니다. Manager View는 왼쪽 사이드바 아이콘으로 열리는 Mission Control 화면으로, 여러 에이전트를 생성·모니터링하는 작업 보드 역할을 합니다. 에이전트 여러 개를 병렬로 굴리려면 Manager View에서 New Agent 버튼으로 하나씩 만들어 미션을 배정하면 됩니다.

 

Q. 첫 미션으로 뭘 돌려보는 게 좋나요?
A. 공식 Codelabs 튜토리얼은 Look at this project and tell me what it does. 를 추천합니다. 코드 수정이 없는 읽기 전용 탐색이라 안전하게 Artifacts 시스템이 로드맵을 어떻게 만들고 보여주는지 관찰하기 좋습니다. File → Open Folder로 아무 로컬 프로젝트를 연 뒤 Mission Control 입력 필드에 이 문장을 그대로 타이핑하면 됩니다.

 

Q. Gemini 3 Pro 말고 Claude도 쓸 수 있나요?
A. 가능합니다. Antigravity 안에서 Gemini 3 Pro / Gemini 3 Flash / Claude Opus / Claude Sonnet 네 개 모델을 모두 선택할 수 있고, 같은 미션 안에서도 에이전트마다 다른 모델을 붙일 수 있습니다. 단순 작업은 Gemini 3 Flash, 복잡한 설계·디버깅은 Claude Opus에 맡기는 식의 조합 운용이 가능합니다.

---

📎 이 카테고리의 다른 글

• Gemini CLI 사용법 — 무료로 어디까지 되나, 직접 써보고 정리 — 2026-04-19
• Claude Code 창시자와 해커톤 우승자의 공통 꿀팁 7가지 — 2026-04-05
• [설치 가이드] Claude Code에 프로급 디자인 스킬 세팅하기: Impeccable 완벽 가이드 — 2026-04-02

같은 AI 활용법 카테고리에서 이어서 읽기

---

설치 환경: Windows 11, Google Antigravity 퍼블릭 프리뷰 (2026-04 기준), Google 계정 로그인, Gemini 3 Pro 기본 모델