Google 안티그레비티(Antigravity) 완벽 가이드 — AI 에이전트 IDE 설치부터 실전 사용법까지

📌 이 글에서 알 수 있는 것

• Google 안티그레비티가 기존 AI 코딩 도구(Cursor, Copilot)와 무엇이 다른지
• 설치부터 첫 에이전트 실행까지 맥미니 M4 기준 단계별 가이드
• Editor View·Manager View 두 화면을 언제 어떻게 쓰는지, 요금제는 어떻게 선택하는지

AI 코딩 도구를 쓰면서 한 번쯤 이런 생각을 해봤을 것 같습니다.

"내가 한 줄 한 줄 지시하는 게 아니라, 그냥 목표만 말하면 알아서 다 해줬으면."

Google 안티그레비티(Antigravity)는 바로 그 방향으로 만들어진 도구입니다. 2025년 11월 Google이 Gemini 3 출시와 함께 공개한 에이전트 중심(Agent-First) AI IDE로, AI가 코드 작성·터미널 실행·브라우저 테스트까지 혼자 해내는 구조를 지향합니다. VS Code를 쓰던 분이라면 화면 자체는 익숙하면서도, 작업 방식은 완전히 달라지는 경험을 하게 됩니다.

🚀 Google 안티그레비티란? — 기존 도구와 무엇이 다른가

Google Antigravity는 VS Code의 오픈소스 코드를 기반으로 Google이 대폭 재설계한 AI IDE입니다. 겉모습은 VS Code와 비슷하지만, 안쪽 구조는 "AI 에이전트가 주도하고, 사람이 감독하는" 방식으로 완전히 달라졌습니다.

🔑 기존 AI 코딩 도구와의 결정적 차이

• GitHub Copilot / Cursor — 내가 코드를 쓸 때 옆에서 제안해주는 도구. 최종 타이핑은 내가 함.
• Google 안티그레비티 — 내가 목표를 말하면 에이전트가 계획 수립 → 코드 작성 → 터미널 실행 → 브라우저로 확인까지 스스로 처리. 나는 중간에 승인하거나 방향을 잡아주는 역할.

항목	기존 AI 보조 (Cursor 등)	Google 안티그레비티
작업 방식	줄 단위 제안	목표 단위 자율 실행
터미널 실행	수동	에이전트가 자동 실행
브라우저 테스트	별도 진행	에이전트가 직접 확인
동시 작업	1개 태스크	멀티 에이전트 병렬
결과 검증	코드 직접 확인	Artifacts(계획서·스크린샷) 제공

지원 AI 모델: Gemini 3.1 Pro / Gemini 3 Flash (기본), Claude Sonnet 4.6 / Opus 4.6 (Anthropic), GPT-OSS-120B (OpenAI 오픈소스 계열) — 한 도구에서 모델을 골라 쓸 수 있다는 점이 큰 장점입니다.

🖥️ 두 가지 화면 완전 이해 — Editor View vs Manager View

안티그레비티에서 가장 먼저 이해해야 할 개념입니다. 화면이 두 가지 모드로 나뉘는데, 언제 어떤 화면을 쓸지 알면 훨씬 편합니다.

📝 Editor View — "내가 직접 코딩할 때"

VS Code와 거의 같은 형태의 편집기 화면입니다. 탭 자동완성, 인라인 AI 명령(Ctrl+K), 사이드바 채팅이 있어서 기존 VS Code 사용자라면 바로 적응됩니다. AI가 도와주는 역할을 하는 모드입니다.

• 코드 자동완성 (탭)
• 인라인 수정 명령 (Ctrl+K → 선택 영역에 직접 지시)
• 사이드바 채팅 (Ctrl+L → 파일 전체 맥락으로 대화)

🎛️ Manager View — "에이전트한테 맡길 때"

안티그레비티만의 독자적인 화면입니다. 여러 에이전트를 동시에 띄워서 각각에게 다른 작업을 맡길 수 있는 멀티 에이전트 관제 센터입니다. 에이전트가 만든 Artifacts(계획서, 스크린샷, 코드 diff)를 여기서 확인하고 승인하거나 수정 지시를 줍니다.

• 여러 에이전트 병렬 실행 (기능 A 개발 + 버그 수정 동시 진행)
• Artifacts로 에이전트 작업 흐름 시각적 확인
• 중간 승인·거절·방향 수정 인터페이스

💡 쉬운 비유: Editor View는 "내가 운전하는 차", Manager View는 "택시 여러 대를 동시에 앱으로 배차하는 것". 처음엔 Editor View부터 익히고, 익숙해지면 Manager View로 넘어가는 게 자연스럽습니다.

📋 설치 전 준비물 체크리스트

• 운영체제: macOS 12 이상 / Windows 10 이상 / Linux (Ubuntu 20.04+) — 맥미니 M4는 모두 호환
• RAM: 최소 8GB (16GB 이상 권장 — 멀티 에이전트 사용 시 특히 중요)
• 저장 공간: 최소 2GB 여유 공간
• Google 계정: 로그인 필수. Google Workspace 계정도 사용 가능
• 인터넷 연결: 에이전트 실행 시 클라우드 모델 호출 (오프라인 불가)

⚠️ 맥미니 M4 16GB 사용자라면: 기본 사양으로 충분히 실행되지만, Gemma 4 같은 로컬 모델과 안티그레비티를 동시에 돌리는 경우 메모리 부족이 발생할 수 있습니다. 둘 중 하나를 선택해서 실행하세요.

STEP 1 — 다운로드 & 설치

① 공식 사이트에서 다운로드

antigravity.google 에 접속해서 운영체제에 맞는 설치 파일을 다운로드합니다. 맥미니 M4는 macOS (Apple Silicon) 버전을 선택하세요.

# 또는 Homebrew로 설치 (macOS)
brew install --cask google-antigravity

② 설치 파일 실행

다운로드한 .dmg 파일을 열고 Applications 폴더로 드래그합니다. 처음 실행 시 macOS 보안 경고가 뜨면 시스템 환경설정 → 개인 정보 보호 및 보안 → '확인 없이 열기'를 선택합니다.

③ Google 계정 로그인

앱을 처음 열면 Google 계정 로그인 화면이 나옵니다. 기존 Google 계정으로 로그인하면 됩니다.

STEP 2 — 초기 설정 (3가지 중 선택)

로그인 후 처음 실행하면 시작 방식을 선택하는 화면이 나옵니다. 세 가지 옵션 중 본인 상황에 맞는 것을 고르세요.

옵션	설명	추천 대상
Start fresh	완전히 새로 시작. 기본 설정으로 깔끔하게 시작됨	처음 사용자
Import from VS Code	기존 VS Code의 확장 프로그램·테마·설정을 그대로 가져옴	VS Code 사용자 (추천)
Import from Cursor	Cursor AI IDE의 설정과 규칙 파일을 가져옴	Cursor 사용자

한국어 언어팩 설치 (선택)

안티그레비티는 기본적으로 영어 UI입니다. 한국어로 바꾸려면:

1. 왼쪽 사이드바 확장 아이콘(블록 4개 모양) 클릭
2. 검색창에 Korean Language Pack 입력
3. Korean Language Pack for Visual Studio Code 설치 → 앱 재시작

STEP 3 — 첫 번째 에이전트 작업 실행하기

이제 핵심인 에이전트 사용법입니다. 처음엔 Editor View의 AI 채팅부터 시작하는 게 가장 쉽습니다.

① 채팅 열기

Ctrl + L (Mac: ⌘ + L) 를 누르면 오른쪽에 AI 채팅 패널이 열립니다.

② 모델 선택

채팅 상단의 드롭다운에서 모델을 고릅니다. 무료 플랜에서는 Gemini 3 Pro가 기본이며, 더 강력한 작업은 Claude Sonnet 4.6이나 Gemini 3.1 Pro를 선택할 수 있습니다.

③ 작업 지시 입력

채팅창에 목표를 입력합니다. 짧은 지시보다 구체적인 목표를 주는 게 좋습니다.

✅ 좋은 지시 예시

• "현재 폴더에 있는 Python 파일들의 함수 목록을 README.md에 자동으로 정리해줘"
• "이 CSV 파일에서 매출 데이터를 읽어서 월별 합계를 계산하고 bar chart로 저장해줘"
• "로그인 기능을 만들어줘. JWT 토큰 방식, Python FastAPI 기준"

④ Artifacts 확인 & 승인

에이전트가 작업을 시작하면 채팅 하단에 Artifacts가 생성됩니다. 작업 계획서, 실행 중인 터미널 로그, 완성된 코드 diff, 브라우저 테스트 스크린샷 등이 카드 형태로 표시됩니다.

• ✅ 승인 — 에이전트 작업을 그대로 적용
• ✏️ 수정 지시 — 방향을 바꿀 때 (예: "함수 이름을 snake_case로 바꿔줘")
• ❌ 거절 — 이 방향이 아닐 때, 에이전트가 다시 계획

STEP 4 — Manager View로 멀티 에이전트 운영하기

Editor View에 익숙해졌다면, 이제 안티그레비티의 핵심인 Manager View를 써볼 차례입니다. 여러 작업을 동시에 병렬로 처리할 때 진가가 나옵니다.

① Manager View 열기

왼쪽 상단의 뷰 전환 버튼(또는 단축키 Ctrl + Shift + M)을 눌러 Manager View로 전환합니다.

② 새 에이전트(Agent) 추가

+ New Agent 버튼을 누르면 새 에이전트 카드가 생성됩니다. 각 에이전트에 워크스페이스 폴더를 지정하고 작업을 입력합니다.

🎛️ 멀티 에이전트 활용 예시

• 에이전트 A: "백엔드 API 엔드포인트 3개 추가해줘 (FastAPI)"
• 에이전트 B: "프론트엔드 React 컴포넌트 스타일 정리해줘"
• 에이전트 C: "테스트 코드 커버리지 80% 이상으로 올려줘"

→ 세 작업이 동시에 진행되며, 각 에이전트의 Artifacts를 Manager View에서 한 눈에 확인·승인

③ 에이전트 학습 저장 (Knowledge Base)

에이전트가 작업 중 유용한 코드 패턴이나 프로젝트 규칙을 발견하면 Knowledge Base에 저장하도록 지시할 수 있습니다. 이렇게 쌓인 지식은 다음 작업에 자동으로 활용됩니다. (예: "이 프로젝트는 항상 snake_case를 사용함" 같은 규칙 저장)

💰 요금제 — 무엇을 선택해야 할까

플랜	가격	주요 내용	추천 대상
Free	무료	Gemini 3 Pro 넉넉한 무료 사용량 / Claude Sonnet 4.6 제한적 사용 / 기본 에이전트 기능	입문자, 개인 프로젝트
Pro	$20/월	Gemini 3.1 Pro 우선 접근 / Claude Opus 4.6 사용 가능 / 멀티 에이전트 확장 / 우선 처리	적극적 개발자, 블로거
Ultra	$250/월	모든 모델 무제한 / 팀 협업 / 고급 Knowledge Base / 전용 지원	팀·기업 사용

💡 처음엔 무조건 Free부터: Free 플랜에서 Gemini 3 Pro 사용량이 상당히 넉넉합니다. 한 달 써보고 Claude Opus가 필요하거나 요청 한도에 걸린다 싶을 때 Pro로 올리는 게 현명합니다. Claude Opus 4.6이 무료로 쓰인다는 점도 Pro 플랜의 큰 메리트입니다.

⚖️ Cursor·Windsurf와 비교하면?

항목	Cursor	Windsurf	Google 안티그레비티
기반	VS Code 포크	독자 에디터	VS Code 포크
작업 방식	AI 보조 코딩	AI 보조 코딩	에이전트 자율 실행
멀티 에이전트	제한적	제한적	Manager View 전용
브라우저 자동 테스트	❌	❌	✅
무료 고성능 모델	제한적	제한적	Gemini 3 Pro 무료
VS Code 설정 호환	✅	일부	✅

Cursor가 "AI와 함께 코딩하는 느낌"이라면, 안티그레비티는 "AI한테 프로젝트를 맡기고 나는 감독하는 느낌"입니다. 어느 쪽이 맞는지는 작업 스타일에 따라 다릅니다.

⚠️ 사용 전 알아두면 좋은 것들

• 에이전트가 틀릴 수 있습니다 — Artifacts를 반드시 확인하고 승인하세요. 에이전트가 자율적으로 파일을 수정하기 때문에, 중요한 프로젝트는 Git으로 버전 관리를 먼저 해두는 것이 필수입니다.
• 인터넷 연결 필수 — 로컬 모델(Gemma 4 등)과 달리, 안티그레비티의 AI 기능은 모두 클라우드 기반입니다. 오프라인 환경에서는 일반 에디터로만 사용 가능합니다.
• 보안 패치 주의 — 2026년 4월 Google이 프롬프트 인젝션 취약점을 패치했습니다. 항상 최신 버전을 유지하세요. (Help → Check for Updates)
• 처음엔 작은 작업부터 — 에이전트에게 처음부터 큰 프로젝트를 맡기면 방향을 잡기 어렵습니다. 파일 하나 수정, 함수 하나 작성 같은 작은 작업으로 감을 익히세요.

💬 마치며

안티그레비티를 처음 쓰면 신기하면서도 어색합니다. "내가 코딩하는 게 아니라 에이전트한테 설명하는 일이 더 많아졌다"는 느낌이 오는데, 그게 바로 이 도구가 의도한 방향입니다. OpenClaw로 텔레그램 자동화를 구축한 것처럼, 안티그레비티로 코딩 자동화도 한 번 시도해보세요. 처음 에이전트가 알아서 코드를 완성하고 테스트까지 돌리는 장면을 보면 — 감탄이 나옵니다.