Google Antigravity 완전 가이드 1편 — 탄생 배경과 설치, 첫 세팅까지

Windsurf가 갑자기 사라졌습니다. 2025년 7월 Google이 Codeium(Windsurf 개발사)을 24억 달러에 인수했고, 4개월 만에 Antigravity를 출시했습니다. IDE 시장이 하룻밤에 재편됐습니다. 기존 Windsurf 사용자는 마이그레이션해야 하고, 나머지는 새로운 선택지를 평가해야 합니다.

[1편 핵심 요약]
→ Antigravity: Google이 Windsurf 팀 인수 후 2025년 11월 출시한 에이전트 퍼스트 IDE
→ 기반: VS Code 포크 — 기존 익스텐션·키바인딩·테마 그대로 사용
→ AI: Gemini 3.1 Pro (2M 토큰 컨텍스트) + Claude Sonnet 4.6 / Opus 4.6 지원
→ 핵심 구조: Editor View(코딩) + Manager View(에이전트 지휘) 듀얼 뷰
→ 가격: 무료 티어(개인 Gmail) / Pro ~$20/월 / Ultra $249.99/월
→ 플랫폼: macOS, Windows, Linux 전부 지원
→ 주의: Google Workspace 계정 미지원 (개인 Gmail만)
→ Product Hunt 4.7/5, 출시 2개월 만에 개발자 6% 채택

---

Windsurf에서 Antigravity로 — 무슨 일이 있었나

2024년 말:
→ Codeium, Windsurf 출시
→ Cascade 에이전트 워크플로우 — 자율 파일 편집 + 명령 실행
→ "Cursor보다 자율적인 IDE" 포지션으로 빠르게 성장

2025년 7월:
→ Google, Codeium 24억 달러 인수
→ Windsurf 팀 전체 Google Developer Tools로 흡수

2025년 11월:
→ Gemini 3 출시와 동시에 Google Antigravity 발표
→ Windsurf 아키텍처 + Gemini 모델 + Google 클라우드 통합
→ Windsurf 독립 제품 단종 시작

2026년 3월:
→ 요금제 개편 — 무료 티어 92% 축소
→ "$20 문진" 논란 (Pro로는 실사용 부족, Ultra $249.99 필요 논란)

2026년 4월:
→ v1.22.2, Product Hunt 4.7/5
→ Google I/O 2026(5/19) 대규모 업데이트 예정

[Cursor vs Windsurf vs Antigravity 포지션]
Cursor:
→ 일상적 코딩 속도 최적화
→ 멀티 에이전트 지원 (3.0부터)
→ 모델 자유 선택
→ 가장 큰 커뮤니티

Windsurf (단종):
→ Cascade 에이전트, 컨텍스트 인식 특화
→ 지금은 Antigravity로 이전 중

Antigravity:
→ 에이전트 퍼스트 — 에이전트가 주인공, 개발자가 지휘관
→ 병렬 에이전트 + 브라우저 통합 (타 IDE에 없는 기능)
→ 2M 토큰 전체 코드베이스 인덱싱
→ Google Cloud 직접 배포 통합

---

실전 1 — 설치

시스템 요구사항

macOS: Monterey 12+
Windows: 64비트 Windows 10+
Linux: 64비트, glibc 2.28+, glibcxx 3.4.25+
기타: Chrome 설치 필수 (브라우저 통합용)
계정: 개인 Gmail (Google Workspace 미지원)

설치

# macOS
# antigravity.google/download 에서 .dmg 다운로드 후 설치

# Linux — Debian/Ubuntu
curl -fsSL https://antigravity.google/download/linux | sh
# 또는
sudo dpkg -i antigravity-linux-amd64.deb

# Linux — Fedora/RHEL
sudo rpm -i antigravity-linux-x86_64.rpm

# Windows
# .exe 인스톨러 실행

설치 후 Gmail로 로그인하면 설정 마법사가 실행됩니다.

VS Code / Cursor에서 마이그레이션

설정 마법사 선택지:
1. VS Code 설정 가져오기
   → settings.json, 익스텐션, 키바인딩 자동 이전
2. Cursor 설정 가져오기
   → 동일하게 자동 이전
3. 새로 시작

→ VS Code 포크 기반이라 익스텐션 호환성 높음
→ VS Code Marketplace 익스텐션 대부분 그대로 작동
→ VS Code 특정 API 의존 익스텐션은 일부 엣지케이스 존재

---

실전 2 — 첫 세팅: 에이전트 자율성 설정

가장 중요한 첫 설정입니다. 에이전트가 얼마나 자율적으로 동작할지 결정합니다.

[3가지 자율성 설정]

1. 터미널 실행 정책
→ 항상 실행: 에이전트가 모든 명령 자동 실행
→ 검토 요청: 터미널 명령 실행 전 승인 필요
→ 허용 목록: 안전한 명령만 자동 실행 (ls, git status, npm test 등)

2. 검토 정책
→ 항상 진행: 에이전트가 중단 없이 실행
→ 에이전트 판단: AI가 체크포인트 시점 결정
→ 검토 요청: 모든 주요 단계에서 일시 정지

3. 브라우저 JS 실행 정책
→ 항상 실행: 가장 자율적, 보안 위험 높음
→ 검토 요청: 실행 전 승인
→ 비활성화: 보안 민감 환경 권장

4가지 프리셋:

Secure Mode (보안 우선):
→ 외부 접근 제한
→ 모든 명령 검토
→ 컴플라이언스 환경 (HIPAA, SOC2) 권장

Review-Driven (균형):
→ 주요 단계마다 체크포인트
→ 처음 시작하는 사람에게 권장
→ 에이전트 학습에 최적

Agent-Driven (자율 우선):
→ 최소 인간 개입
→ 프로토타이핑, 실험적 작업
→ 주의: 프로덕션 환경에서는 비권장

Custom:
→ 3가지 정책 각각 독립 설정

---

실전 3 — AGENTS.md로 에이전트 컨텍스트 설정

# AGENTS.md — Antigravity 에이전트 설정 파일
# 프로젝트 루트에 저장

## 프로젝트 개요
FastAPI 백엔드 + React 프론트엔드 + PostgreSQL

## 기술 스택
backend/   → Python 3.12, FastAPI, SQLAlchemy, Alembic
frontend/  → TypeScript 5, React 18, Vite, TailwindCSS
infra/     → Docker Compose, GitHub Actions

## 코딩 규칙
- Python: type hint 필수, async/await 우선
- TypeScript: strict 모드, any 금지
- API: RESTful, 응답은 {data, error} 구조
- 테스트: 새 기능은 단위 테스트 포함 필수

## 터미널 허용 명령 (자동 실행)
- git, python, pytest, npm, npx, docker

## 절대 수정 금지
- alembic/versions/ (DB 마이그레이션)
- .env 파일

## 배포
- 스테이징: docker compose up -d
- 프로덕션: GitHub Actions CI/CD 경유만

[AGENTS.md vs CLAUDE.md 차이]
→ 역할은 동일: 에이전트에게 프로젝트 컨텍스트 제공
→ AGENTS.md: Antigravity, OpenAI Codex 표준
→ CLAUDE.md: Claude Code 전용
→ 둘 다 있으면 각 에이전트가 자기 파일 우선 참조
→ 내용은 동일하게 써도 무방

---

실전 4 — 듀얼 뷰 구조 이해

Antigravity의 핵심 UI 구조입니다.

[Editor View — 익숙한 IDE]
→ 일반 VS Code처럼 코드 편집
→ 인라인 AI 자동완성
→ 파일 탐색, Git 통합
→ 기존 VS Code 사용자라면 즉시 적응

[Manager View — 에이전트 지휘 센터]
→ 여러 에이전트를 동시에 실행·모니터링
→ 각 에이전트의 현재 작업 실시간 확인
→ 에이전트 간 작업 의존성 조율
→ Artifacts: 에이전트 작업 결과물 투명하게 확인

[전환 단축키]
Cmd/Ctrl + Shift + M → Manager View
Cmd/Ctrl + Shift + E → Editor View

[Artifacts 시스템]
→ 에이전트가 한 모든 작업의 구조화된 기록
→ 변경 파일, 실행 명령, 결정 근거 포함
→ "왜 이렇게 했지?" 추적 가능
→ 에이전트 결과물 수락/거절 단위로 검토
→ Cursor의 diff 뷰보다 더 넓은 컨텍스트 제공

---

1편 마무리

✅ 지금 바로 시작해야 하는 경우
→ Windsurf 사용자 — 단종 전 마이그레이션 필요
→ VS Code에서 에이전트 퍼스트 환경으로 전환하고 싶을 때
→ Google Cloud + Firebase 스택 주로 쓰는 팀
→ 2M 토큰 전체 코드베이스 인덱싱이 필요할 때
→ 무료로 병렬 에이전트 써보고 싶을 때

❌ 아직 기다려야 하는 경우
→ Google Workspace 계정 사용 팀 (아직 미지원)
→ 안정성 최우선 프로덕션 환경 (아직 Preview)
→ Ultra($249.99)가 부담스러운데 무거운 에이전트 작업이 많은 경우
→ 오프라인 환경 필수 (클라우드 의존)

---

관련 글

• Vibe Coding은 끝났다 — Karpathy가 선언한 Agentic Engineering 시대
• Spec-Driven Development — Vibe Coding 다음 단계, AI 에이전트 개발 방법론
• Claude Code 한도 자꾸 걸리는 이유와 요금제 선택 가이드
• GitHub Copilot Agent Mode 실전 가이드