라핀의 Google Antigravity 완벽 가이드 | 설치부터 안전 사용법까지 (드라이브 날린 실수 주의)
Google Antigravity를 사용하다 잘못 설정하면 드라이브 전체가 삭제될 수 있습니다. 실제로 일어난 사건입니다. 라핀이 Antigravity 완전 입문 가이드로 설치·세팅·안전 수칙부터 나에게 맞는 도구인지 판단하는 기준까지 한 번에 정리합니다.
Google Antigravity란 무엇인가?
Google Antigravity는 2025년 11월 18일 Gemini 3과 함께 출시된 Google의 AI 코딩 에이전트 IDE입니다.
한 줄 정리: 코드 에디터 + 터미널 + 브라우저를 한 화면에 붙여놓고, AI 에이전트가 그 사이를 직접 이동하며 작업해주는 개발 도구입니다.
"투두리스트 웹 만들어줘"라고 말하면 AI가 알아서 파일 생성 → 패키지 설치 → 서버 실행 → 브라우저 자동 테스트까지 완료합니다. 손을 대지 않아도 됩니다.
Cursor, Claude Code와 비교하면?
| 항목 | Cursor | Claude Code | Google Antigravity |
|---|---|---|---|
| 브라우저 자동화 | ❌ 직접 열어야 함 | ❌ 직접 열어야 함 | ✅ AI가 직접 조작 |
| 설계 철학 | 사람 주도, AI 보조 | 사람 주도, AI 보조 | AI가 계획·실행, 사람은 지시만 |
| 가격 | 월 $20 | 월 $20 | 무료 (사용량 제한 있음) |
| Firebase 연동 | 별도 설정 | 별도 설정 | ✅ 원클릭 통합 |
| 입문자 진입 장벽 | 중간 | 높음 | 낮음 |
Antigravity의 최대 강점: 브라우저까지 AI가 직접 클릭하고 테스트합니다. 파란색 테두리가 보이면 AI가 현재 브라우저를 조작 중이라는 표시입니다.
설치 및 초기 세팅 방법
설치: antigravity.google 접속 → 본인 OS 맞는 파일 다운로드 → 실행 → Google 계정 로그인
필수 세팅 4가지:
① AGQ 익스텐션 설치 (사용량 모니터링)
- 좌측 익스텐션 아이콘 클릭
- "AGQ" 검색 → Henrik이 만든 AGQ 설치
- 하단 상태바에 실시간 사용량 표시, 클릭 시 잔여량·리셋 시간 확인 가능
② 한국어 답변 설정
- 우측 상단 Additional Options → Customize → Rules
- "+Global" 클릭 → "모든 답변은 한국어로 해줘" 입력 → Ctrl+S 저장
- 주의: Gemini Pro 모델은 규칙 준수율이 낮습니다. Gemini Flash를 기본으로 사용하세요.
③ 모델 선택
- 기본: Gemini Flash → 속도 빠름, 규칙 잘 따름, 성능 충분
- 복잡한 오류 해결 시: Gemini Pro로 전환 (단, 지시를 덜 따르는 편)
④ 터미널 설정 (⚠️ 가장 중요)
- 우측 상단 Editor Specific Settings → Editor Settings → Antigravity Settings
- 터미널 옵션: Auto 선택
- 절대로 Turbo 선택 금지 → 아래 위험 사례 참고
⚠️ D드라이브 전체 삭제 사건 - 반드시 알아야 할 안전 수칙 3가지
실제 사건: 한 개발자가 "캐시 지워줘"라고 했더니, Antigravity가 프로젝트 폴더가 아닌 D드라이브 전체를 삭제했습니다. 터보(Turbo) 모드 설정으로 확인 없이 즉시 실행했기 때문입니다. 복구 불가였습니다.
안전 수칙 3가지
수칙 1: 터미널은 반드시 Auto 설정
- Turbo 모드: 확인 없이 즉시 실행 (위험)
- Auto 모드: 위험한 작업 전에 "이거 실행해도 되나요?" 확인 요청 (안전)
- 이전에 Turbo로 설정했다면 지금 바로 Auto로 변경하세요.
수칙 2: 작업 전용 폴더만 열기
- 사진, 문서, 회사 자료가 있는 폴더 절대 열지 말 것
- 해당 프로젝트 파일만 있는 전용 폴더를 따로 만들어서 열기
- AI는 열린 폴더 안의 모든 파일에 접근·수정·삭제 권한을 가집니다.
수칙 3: Git 커밋 필수
- AI가 파일 전체를 통째로 바꿀 때가 있습니다.
- 중요한 작업 전에는 "커밋 해줘"라고 요청하거나 직접 커밋
- Git을 모르면 Antigravity한테 "지금 변경사항 커밋해줘"라고 요청 가능
추가 팁: 범위를 좁혀서 요청하세요.
- ❌ "프로젝트 전체 구조 다 바꿔줘" → 위험
- ✅ "이 파일의 이 함수만 고쳐줘" → 안전
무료로 계속 쓸 수 있나? 사용량 정책
무료 계정 (2025년 12월 기준):
- 주간 단위로 쿼터(사용량) 리셋
- 간단한 프로그램은 가능하지만 충분하지 않음
유료 (Google AI Pro/Ultra 구독 시):
- 5시간마다 쿼터 리셋
- 하루 종일 개발하는 분들에게 사실상 필수
사용량 확인은 AGQ 익스텐션으로 실시간 모니터링 가능합니다.
나에게 맞는 도구인가? 추천 기준
Antigravity 추천 대상:
- 코딩 처음 시작하는 입문자 (Git, npm, 서버 몰라도 결과물 즉시 확인)
- Google 생태계(Firebase) 활용자 (로그인, DB, 배포까지 원클릭)
- 전체 흐름을 빠르게 체험하고 싶은 분
Claude Code / Cursor 추천 대상:
- VS Code에 익숙하고 한 줄씩 세밀하게 컨트롤하고 싶은 분
- 파일이 통째로 바뀌는 것이 불안한 분
- diff 뷰로 변경사항을 꼼꼼히 리뷰하며 적용하고 싶은 분
자주 묻는 질문 (FAQ)
Q. Google Antigravity 터보 모드가 왜 위험한가요?
A. 터보 모드에서는 AI가 터미널 명령을 확인 없이 즉시 실행합니다. "캐시 삭제" 같은 요청이 드라이브 전체 삭제로 이어질 수 있습니다. Auto 모드로 설정하면 위험한 작업 전에 사용자에게 확인을 요청하므로 안전합니다.
Q. Antigravity에서 Git을 몰라도 커밋할 수 있나요?
A. 네. "지금 변경사항 커밋해줘"라고 AI에게 요청하면 됩니다. Antigravity가 Git 명령을 대신 실행해줍니다.
Q. Gemini Flash와 Gemini Pro 중 어느 것을 써야 하나요?
A. 기본은 Gemini Flash를 사용하세요. 속도가 빠르고 설정한 규칙을 더 잘 따릅니다. 복잡한 오류가 해결이 안 될 때만 Gemini Pro로 전환하되, Pro는 지시를 덜 따르는 경향이 있습니다.
Q. Antigravity와 Firebase Studio의 차이는 무엇인가요?
A. Antigravity는 로컬에 설치하는 IDE로 에이전트가 브라우저까지 직접 조작합니다. Firebase Studio는 브라우저 기반의 클라우드 개발 환경입니다. 두 도구 모두 Firebase 연동이 쉽고, 각각 장단점이 있습니다.
정리
Google Antigravity 핵심 정리:
- AI 에이전트가 코드 작성 + 터미널 + 브라우저 테스트까지 자동 수행
- 무료 사용 가능 (주간 쿼터 제한)
- 필수 안전 설정: 터미널 Auto / 전용 폴더만 열기 / Git 커밋 습관화
- 입문자·Google 생태계 사용자에게 최적
라핀은 Claude Code를 주력으로 쓰지만, 입문자나 빠른 프로토타입에는 Antigravity가 진입 장벽이 낮고 즉시 결과를 볼 수 있어 AI 자동화 시작점으로 추천합니다.
