Google Antigravity 사용법: 설치부터 Skills까지 완전 정복
2026년 3월 9일 기준 · v1.20.4 최신 업데이트 반영 · AGENTS.md 신기능 포함
⚡ Mac · Windows · Linux
🤖 Gemini 3 Pro 탑재
🔴 v1.20.4 NEW
Google Antigravity(안티그래비티)는 구글이 2025년 11월 출시한 에이전트 퍼스트(Agent-First) IDE입니다. 단순히 코드를 제안하는 수준을 넘어서, AI가 직접 계획을 세우고, 코드를 작성하고, 브라우저로 검증까지 마칩니다. 2026년 3월 6일 출시된 v1.20.4에서는 드디어 AGENTS.md 지원이 추가되어, Claude Code와 견줄 수 있는 강력한 프로젝트 제어 기능을 갖추게 됐습니다. 지금 바로 이 가이드를 끝까지 읽으면 오늘부터 실전에서 바로 쓸 수 있습니다.
🤖 Google Antigravity란? — 다른 AI IDE와 결정적으로 다른 점
Google Antigravity는 구글 DeepMind가 2025년 11월 18일 공개한 에이전트 중심 개발 플랫폼입니다. VS Code 기반이지만, Cursor나 Windsurf와는 근본적으로 철학이 다릅니다. Cursor나 Copilot이 “개발자 옆에서 코드를 제안하는 보조자”라면, Antigravity는 “개발 팀장처럼 스스로 계획하고, 실행하고, 테스트까지 완료하는 에이전트”입니다.
실제로 Antigravity의 에이전트는 내장 브라우저를 띄워서 DOM을 직접 탐색하고, 스크린샷을 찍어 UI를 스스로 검증합니다. 코드를 짜다가 에러가 나면 에러 메시지를 읽고, 검색하고, 수정하는 과정을 사람의 개입 없이 완료할 수 있습니다. 이 점이 기존 AI 코딩 도구와 결정적으로 다른 차별점입니다.
탑재 모델은 Gemini 3 Pro와 Gemini 3를 선택할 수 있으며, 구글 계정만 있으면 무료로 시작할 수 있다는 것도 강점입니다. 2026년 3월 현재 Mac, Windows, Linux 모두 지원하며, 매주 지속적으로 업데이트가 이루어지고 있습니다.
💡 핵심 인사이트: Antigravity는 “바이브 코딩(Vibe Coding)” 시대의 본격적인 도구입니다. 아이디어를 말로 설명하면 AI가 기획, 코딩, 테스트를 모두 처리해 줍니다. 비개발자도 충분히 활용 가능한 구조입니다.
⚙️ 설치부터 첫 실행까지 — 5분 만에 끝내는 셋업 가이드
① 설치 방법
구글 계정이 준비됐다면, antigravity.google/download에 접속해 운영체제에 맞는 설치 파일을 내려받으면 됩니다. 설치는 일반 앱 설치와 동일하며, 5분 이내에 완료됩니다. 기존에 VS Code나 Cursor를 쓰던 분이라면 설정과 확장 프로그램을 가져올 수 있어 마이그레이션 부담이 거의 없습니다.
② 첫 실행 시 필수 확인 사항
첫 실행 후 구글 계정으로 Gmail 로그인을 완료하면 에이전트를 바로 사용할 수 있습니다. 단, Antigravity는 크롬 브라우저와 Gmail 계정을 반드시 연동해야 브라우저 에이전트 기능이 작동합니다. 로그인 후 나타나는 설정 화면에서 워크스페이스 폴더를 지정하고, 모델을 선택하면 기본 셋업은 완료됩니다.
③ 모델 선택 가이드
모델은 Gemini 3 Pro High와 Gemini 3 Pro Low, 그리고 기본 Gemini 3 중에서 선택할 수 있습니다. 복잡한 프로젝트나 심층 리서치가 필요할 때는 Planning 모드 + Gemini 3 Pro High 조합이 최적이며, 간단한 변수 수정이나 빠른 작업에는 Fast 모드 + Gemini 3 조합이 효율적입니다.
| 모드 | 특징 | 추천 상황 |
|---|---|---|
| Planning | 실행 전 계획 수립, 태스크 그룹 정리, 아티팩트 생성 | 복잡한 프로젝트, 신규 앱 개발 |
| Fast | 계획 없이 즉시 실행, 빠른 처리 | 변수 수정, bash 명령, 간단한 수정 |
🖥️ 핵심 인터페이스 완전 해부 — Agent Manager, Editor, Browser
Antigravity의 화면은 크게 Agent Manager와 Editor View로 나뉩니다. Agent Manager는 에이전트와 대화하고 작업을 지시하는 공간이며, Editor View는 실제 코드 파일을 편집하는 VS Code 기반 공간입니다. 두 화면을 오가며 작업하는 것이 기본적인 사용 흐름입니다.
Agent Manager 핵심 메뉴
Agent Manager의 좌측 패널에는 다섯 가지 핵심 메뉴가 있습니다. Start Conversation은 새 에이전트 대화를 시작하는 버튼이고, Workspaces는 프로젝트 폴더를 관리합니다. Playground는 실제 파일을 건드리지 않고 에이전트를 테스트해볼 수 있는 샌드박스 공간이며, Browser는 Antigravity 내장 크롬 기반 브라우저입니다. Editor View는 에디터 화면으로 전환하는 버튼입니다.
Editor View 단축키 필수 3가지
Editor View에서 가장 많이 사용하는 단축키는 세 가지입니다. Cmd + L은 에이전트 채팅창을 열고, Cmd + I는 인라인 편집 모드, Tab은 자동완성 제안 수락입니다. 에이전트 채팅창에서 @를 입력하면 파일, MCP, 폴더를 참조할 수 있으며, /로는 워크플로우를 바로 호출할 수 있습니다.
💡 실전 팁: 에디터에서 오류가 발생하면 하단 Problems 탭에서 “Send all to Agent” 버튼 하나로 모든 오류를 에이전트에게 한 번에 전달할 수 있습니다. 수동으로 오류를 복사해서 붙여넣는 번거로움을 완전히 없애줍니다.
🎛️ Rules·Workflows·Skills 삼종 세트 — AI 행동을 내 기준으로 고정하는 법
Antigravity를 단순히 쓰는 사람과 제대로 쓰는 사람의 차이는 바로 이 세 가지 커스터마이즈 기능에 있습니다. 이 기능들을 설정하지 않으면, 에이전트는 매번 다른 방식으로 코드를 작성하게 됩니다. 반대로 잘 설정해두면, 팀 전체가 일관된 코드 스타일을 유지하고 반복 작업을 자동화할 수 있습니다.
에이전트가 항상 따라야 하는 코드 스타일이나 주석 규칙을 정의합니다. 워크스페이스 Rules는 your-workspace/.agents/rules/ 폴더에 마크다운 파일로 저장하면 됩니다. 예를 들어 “PEP 8 스타일 준수”, “모든 메서드에 주석 작성” 같은 규칙을 한 번 정의해두면, 이후 모든 에이전트 작업에서 자동으로 적용됩니다.
반복적인 작업 절차를 자동화합니다. 워크플로우를 만들어두면 에디터 채팅창에서 /워크플로우명을 입력하는 것만으로 실행됩니다. 예를 들어 “유닛 테스트 자동 생성” 워크플로우를 만들어두면, /generate-unit-tests 입력 한 번으로 해당 파일의 모든 메서드에 대한 테스트 코드가 자동으로 생성됩니다.
AI에게 특정 전문 역할을 부여하는 가장 강력한 커스터마이즈 도구입니다. 스킬은 SKILL.md 파일에 이름, 설명, 실행 지침을 작성하는 방식으로 만들며, 선택적으로 스크립트 파일과 참고 자료를 함께 포함할 수 있습니다. “코드 리뷰 스킬”, “라이선스 헤더 자동 추가 스킬” 처럼 프로젝트나 팀에 맞는 역할을 직접 정의할 수 있다는 점이 매우 강력합니다.
💡 개인 의견: Rules·Workflows·Skills 세트는 Antigravity가 단순한 AI 보조 툴이 아니라 “팀의 AI 개발 표준을 정의하는 플랫폼”임을 보여주는 핵심 기능입니다. 이 세 가지를 잘 세팅해둔 팀과 그렇지 않은 팀의 생산성 차이는 시간이 지날수록 극명하게 벌어질 것입니다.
🆕 v1.20.4 신기능 AGENTS.md — 프로젝트 단위 AI 지침서의 등장
2026년 3월 6일 출시된 v1.20.4의 가장 중요한 변화는 바로 AGENTS.md 지원입니다. AGENTS.md는 프로젝트 루트 디렉토리에 생성하는 마크다운 파일로, 해당 프로젝트에서 에이전트가 어떻게 동작해야 하는지를 정의하는 일종의 “AI 행동 지침서”입니다. Claude Code에 이미 존재하던 방식을 Antigravity가 공식 채택한 것으로, 이제 두 툴 간의 프로젝트 맥락을 공유하기 훨씬 쉬워졌습니다.
AGENTS.md 파일에는 프로젝트의 기술 스택, 코딩 컨벤션, 금지 사항, 폴더 구조 설명, 자주 쓰는 명령어 등을 자유롭게 기술하면 됩니다. 이 파일이 있으면 에이전트는 새 대화를 시작할 때마다 이 지침서를 먼저 읽고 작업을 시작하므로, 매번 반복해서 설명할 필요가 없어집니다. 특히 팀 프로젝트에서 여러 사람이 같은 AI 설정으로 일관된 작업을 할 수 있게 해주는 강력한 도구입니다.
📄 AGENTS.md 작성 예시
# 프로젝트 AI 행동 지침 ## 기술 스택 - Backend: Python 3.12 + FastAPI - Frontend: Next.js 15 + TypeScript ## 코딩 규칙 - 모든 코드는 PEP 8 스타일 준수 - 함수마다 한국어 독스트링 필수 작성 - main.py에 직접 로직 작성 금지 ## 금지 사항 - 외부 API 키를 코드에 하드코딩하지 말 것 - print() 대신 logging 모듈 사용
AGENTS.md는 전역 설정인 ~/.gemini/GEMINI.md와 함께 사용하면 더욱 강력합니다. 전역 파일에는 개인 코딩 스타일을 정의하고, AGENTS.md에는 프로젝트별 특수 규칙을 기술하면 두 레이어가 함께 작동해 매우 정밀한 에이전트 제어가 가능합니다.
💡 개인 의견: AGENTS.md 도입은 Antigravity가 “개인 도구”에서 “팀 표준 도구”로 격상되는 이정표입니다. 이제 신입 팀원이 들어와도 AGENTS.md 파일 하나로 AI와의 협업 기준을 즉시 공유할 수 있으니, 팀 온보딩 비용도 크게 줄어들 것입니다.
⚔️ Cursor·Claude Code와 실전 비교 — 뭘 골라야 하나요?
이 질문은 현재 AI 코딩 커뮤니티에서 가장 많이 오가는 논쟁입니다. 솔직하게 말하면, 세 도구 모두 각자의 강점이 있어서 “이게 최고”라고 단언하기 어렵습니다. 하지만 상황별로 어떤 도구가 유리한지는 분명하게 정리할 수 있습니다.
| 비교 항목 | Antigravity | Cursor | Claude Code |
|---|---|---|---|
| 기본 무료 여부 | ✅ 무료 | 🔶 일부 유료 | 🔶 토큰 비용 |
| 자율 브라우저 검증 | ✅ 내장 | ❌ | ❌ (별도 MCP) |
| AGENTS.md 지원 | ✅ (v1.20.4~) | ❌ | ✅ |
| 안정성 | 🔶 프리뷰 단계 | ✅ 높음 | ✅ 높음 |
| 비개발자 접근성 | ✅ 높음 | 🔶 중간 | 🔴 낮음 (CLI) |
현재로서는 Antigravity는 비개발자 또는 입문자, 풀스택 바이브 코딩을 원하는 분에게 최적이고, Cursor는 실무 개발자가 높은 안정성이 필요할 때, Claude Code는 터미널 기반의 고급 에이전트 작업에 각각 유리합니다. 세 가지를 목적에 맞게 조합하는 것이 현재 가장 현실적인 전략입니다.
🎯 비개발자·입문자를 위한 실전 활용 시나리오 3가지
“코딩을 모르는데 쓸 수 있나요?”라는 질문이 많습니다. 결론부터 말씀드리면, 충분히 가능합니다. Antigravity는 자연어로 작업을 지시하면 AI가 계획부터 실행, 검증까지 처리해줘서 코딩 지식 없이도 실용적인 결과를 만들어낼 수 있습니다.
🗂️ 시나리오 1: 개인 업무 대시보드 만들기
“Python으로 할 일 목록을 관리할 수 있는 웹앱을 만들어줘. 완료 체크, 삭제 기능 포함”이라고 입력하면, Planning 모드 에이전트가 기술 스택을 선정하고, 파일 구조를 설계하고, 코드를 작성한 뒤 내장 브라우저로 실제 동작까지 검증합니다. 비개발자도 완성된 앱을 로컬에서 바로 실행할 수 있습니다.
📊 시나리오 2: 엑셀 데이터 자동 분석 스크립트
“이 CSV 파일을 분석해서 월별 매출 추이를 그래프로 그려주는 Python 스크립트를 만들어줘”라고 @파일명과 함께 입력하면 됩니다. 에이전트가 파일을 읽고, pandas와 matplotlib을 활용해 완성된 스크립트를 생성합니다. 코드 한 줄 몰라도 데이터 분석 자동화가 가능합니다.
🌐 시나리오 3: 포트폴리오 웹사이트 자동 제작
“내 이력서 내용을 바탕으로 깔끔한 포트폴리오 웹사이트를 Next.js로 만들어줘. 다크모드 지원, 프로젝트 카드 형식”이라고 지시하면 Antigravity가 설계부터 배포 준비까지 처리합니다. Rules에 “색상 테마는 네이비 계열로” 같은 규칙을 미리 세팅해두면 더욱 정확한 결과를 얻을 수 있습니다.
❓ Q&A — Google Antigravity 자주 묻는 질문 5가지
✍️ 마치며 — Google Antigravity, 지금 써야 하는 이유
Google Antigravity는 현재 프리뷰 단계이기 때문에 입력 지연이나 간헐적 버그가 있습니다. 실제로 2026년 1월 업데이트 이후 에이전트가 멈추는 버그가 Reddit에 보고되기도 했고, Cursor에 비해 안정성이 다소 떨어진다는 평가도 분명히 있습니다. 이 점은 솔직하게 인정해야 합니다.
그럼에도 불구하고 지금 Antigravity를 써야 하는 이유는 분명합니다. 무료로 Gemini 3 Pro를 쓸 수 있는 지금이 가장 좋은 시기이고, v1.20.4에서 AGENTS.md가 추가되면서 실전 팀 환경에서도 충분히 쓸 수 있는 수준으로 올라섰습니다. 또한 구글이라는 플랫폼의 특성상 Firebase, Google Cloud와의 연동이 점점 강화될 것이 분명하며, 이 생태계에 먼저 익숙해지는 것은 중장기적으로 큰 이점이 됩니다.
개인적으로 가장 인상 깊은 기능은 브라우저 자율 검증과 Skills 커스터마이즈입니다. AI가 코드를 짜고 브라우저를 직접 열어서 동작을 확인하는 모습은 처음 봤을 때 실제로 놀라웠습니다. Rules·Workflows·Skills 삼종 세트를 잘 구성하면 반복 업무의 상당 부분을 자동화할 수 있습니다. 지금 바로 설치하고, 오늘 한 가지 작은 프로젝트를 Antigravity에게 맡겨보세요.
본 포스팅은 2026년 3월 9일 기준 공개된 정보를 바탕으로 작성되었습니다. Google Antigravity는 현재 프리뷰(Preview) 단계로, 기능 및 가격 정책은 공식 발표 없이 변경될 수 있습니다. 최신 정보는 공식 홈페이지에서 확인하시기 바랍니다.
댓글 남기기