구글 안티그래비티(Antigravity)는 AI 에이전트에게 코드 작성과 조사 같은 일을 맡기는 구글의 개발 도구입니다. 결론부터 말하면 개인 구글 계정만 있으면 한국에서도 무료로 쓸 수 있고, 데스크톱 앱(2.0)·터미널용 CLI(agy)·IDE 세 가지 방식 중 하나를 고르면 됩니다. 다만 무료는 주 단위 할당량이고, 쓸 수 있는 모델이 요금제마다 다릅니다. 이 글은 2026년 10월 12일 antigravity.google 공식 문서를 기준으로 정리했습니다.
구글 안티그래비티는 어떤 도구인가요?
안티그래비티는 한 가지 앱이 아니라 같은 에이전트 엔진을 쓰는 세 가지 사용 방식의 묶음입니다. 공식 문서는 셋이 같은 에이전트 하네스(에이전트를 돌리는 핵심 구조)를 공유하고 설정도 자동으로 동기화된다고 설명합니다.
| 방식 | 무엇인가 | 맞는 사람 |
|---|---|---|
| 안티그래비티 2.0 | IDE와 독립된 데스크톱 앱. 여러 에이전트를 띄우고 지켜보는 관제실 | 여러 작업을 동시에 맡기고 결과를 화면으로 확인하고 싶은 사람 |
| 안티그래비티 CLI(agy) | 터미널에서 돌아가는 가벼운 화면 | SSH·tmux로 서버에서 일하거나 키보드만 쓰는 사람 |
| 안티그래비티 IDE·확장 | 편집기 안의 에이전트와 탭 자동완성 | VS Code, JetBrains, Xcode 같은 편집기를 그대로 쓰고 싶은 사람 |
2.0 앱에서 에이전트는 명령 실행, 파일 읽기·쓰기, 웹 검색, Chrome 조작, 서브에이전트 관리까지 합니다. 기존 제미나이 CLI가 2026년 6월 18일 무료·AI Pro 사용자에게 막히면서, 구글이 그 자리에 내놓은 후속 도구가 이 안티그래비티 CLI입니다.
안티그래비티는 무료인가요, 한국에서도 되나요?
무료로 쓸 수 있고, 한국도 됩니다. 공식 FAQ의 이용 가능 국가 목록 아시아 항목에 대한민국이 들어 있습니다. 조건은 세 가지입니다.
- 만 18세 이상이어야 합니다. 나이 확인이 안 되면 확인 절차를 거쳐야 합니다.
- 개인 구글 계정으로 로그인합니다. 회사 Google Workspace 계정으로 문제가 생기면 @gmail.com 계정을 쓰라고 안내합니다.
- 무료 사용자는 주 단위로 갱신되는 할당량을 받습니다.
무료에도 Gemini 3.1 Pro와 Flash 모델, 무제한 탭 자동완성, 예약 작업과 CLI를 포함한 모든 기능이 들어갑니다. 구독 요금제 자체의 차이는 제미나이 요금제 정리에서 보시면 됩니다.
요금제마다 쓸 수 있는 모델은 어떻게 다른가요?
안티그래비티는 제미나이만 쓰는 도구가 아닙니다. 모델 선택 메뉴에서 클로드와 오픈 모델도 고를 수 있는데, 범위가 요금제에 따라 갈립니다.
눈여겨볼 점은 두 가지입니다. Claude Sonnet·Opus 5.5는 Google AI Pro(체험 구독 제외)와 Ultra부터 열립니다. 무료에서 고를 수 있는 Claude 4.6 모델과 GPT-OSS-120b는 2026년 11월 2일 제거될 예정이라, 지금 4.6에 맞춰 작업 흐름을 짰다면 곧 바꿔야 합니다. 대화 중간에 모델을 바꾸면 진행 중인 단계가 끝난 뒤부터 새 모델이 적용됩니다.
안티그래비티는 어떻게 설치하고 시작하나요?
데스크톱 앱(2.0)
antigravity.google/download에서 운영체제에 맞는 파일을 받습니다. macOS는 12(Monterey) 이상, Windows는 10 64비트, Linux는 glibc 2.28 이상(우분투 20 등)이 필요합니다. 실행 후 왼쪽의 폴더 아이콘에서 New Project → Add Folder로 작업할 폴더를 묶고, 목표를 입력한 뒤 모드를 고릅니다. Local mode는 지금 폴더에서 바로 고치고, New worktree mode는 Git 워크트리를 따로 만들어 원본과 분리해서 작업합니다. 처음에는 워크트리 모드로 결과를 확인한 뒤 합치는 편이 안전합니다.
CLI(agy)
# macOS, Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
# Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex
# 설치 확인과 업데이트
agy --version
agy update
처음 실행하면 브라우저가 열려 로그인합니다. SSH로 원격 서버에서 실행하면 인증 URL을 출력하고, 로컬 브라우저에서 받은 코드를 붙여 넣는 방식으로 바뀝니다. 설치 스크립트는 셸 프로필의 PATH를 고치는데, 이게 싫다면 --skip-path 옵션이 있습니다.
IDE 확장
VS Code, Visual Studio, JetBrains 계열, Zed, Xcode용 확장이 있습니다. 편집기의 안티그래비티 아이콘에서 Sign In을 누르면 같은 계정의 할당량을 그대로 씁니다. MCP 서버는 2.0 앱의 Settings → Customizations에서 MCP Store로 추가하고, 반복 작업 규칙은 .agents/skills 폴더의 SKILL.md로 둡니다. MCP를 연결하기 전에 어떤 서버를 믿어도 되는지는 클로드 MCP 연결 방법의 보안 주의점이 그대로 적용됩니다.
무료 할당량은 얼마나 되고, 넘기면 어떻게 되나요?
공식 문서는 할당량을 숫자로 밝히지 않습니다. 대신 방식만 설명합니다.
| 요금제 | 할당량 갱신 | 초과 사용 |
|---|---|---|
| 무료·Plus | 주 단위 | 갱신까지 대기 |
| Google AI Pro | 5시간마다(주간 한도까지) | AI 크레딧 구매 |
| Google AI Ultra | 5시간마다, 가장 큰 한도 | AI 크레딧 구매 |
할당량은 프롬프트 개수가 아니라 에이전트가 한 일의 양에 비례합니다. 간단한 수정은 여러 번 보낼 수 있지만, 여러 파일을 고치는 큰 작업은 빨리 소진됩니다. Pro·Ultra는 크레딧 초과 설정을 Never(갱신까지 대기)와 Always(자동으로 크레딧 사용) 중에 고르는데, 처음에는 Never로 두고 Settings 화면에서 모델별 사용량을 본 뒤 정하는 편이 안전합니다. 자기 API 키를 꽂아 한도를 늘리는 방식(BYOK)은 아직 지원하지 않습니다.
클로드 코드·커서와 비교하면 무엇이 다른가요?
| 항목 | 안티그래비티 | 클로드 코드 | 커서AI |
|---|---|---|---|
| 무료로 시작 | 가능(주간 할당량) | 불가(Pro 연간 결제 시 월 $17부터) | 무료 플랜 있음, Pro 월 $20 |
| 쓰는 곳 | 데스크톱 앱·터미널·편집기 | 터미널·IDE | 자체 편집기 |
| 모델 | 제미나이 중심, 요금제별 클로드 | 클로드 | 여러 회사 모델 |
무료로 에이전트형 코딩을 시작해 보려는 사람에게는 안티그래비티가 가장 진입 장벽이 낮습니다. 이 블로그는 클로드 코드로 만들고 운영하고 있어서, 규칙 파일(CLAUDE.md)과 MCP를 중심으로 일하는 흐름에는 클로드 코드가 익숙하다는 점도 적어 둡니다.
안티그래비티를 쓰면 안 되는 경우는?
- 안티그래비티 로그인을 다른 도구에서 쓰려는 경우: FAQ는 클로드 코드, OpenClaw, OpenCode 같은 서드파티 도구로 안티그래비티에 접근하는 것을 약관 위반으로 보고, 계정 정지·해지로 이어질 수 있다고 명시합니다. 다른 도구에서 Gemini를 쓰려면 Google AI Studio API 키를 쓰세요.
- agy를 자동화 도구 안에 감싸거나 계정을 돌려 쓰려는 경우:
agy -p무인 모드는 직접 스크립트와 CI용이고, 개인 요금제에서 서드파티 에이전트로 감싸거나 계정을 자동으로 바꾸는 것은 지원하지 않습니다. - 회사 엔터프라이즈 계정으로 IDE를 쓰려는 경우: 안티그래비티 IDE는 엔터프라이즈를 지원하지 않습니다. 회사 환경이면 2.0 앱이나 CLI를 써야 합니다.
- 만 18세 미만이거나 Workspace 계정만 있는 경우: 로그인 단계에서 막힐 수 있습니다.
- 코드가 외부로 나가면 안 되는 경우: 데이터 수집은 설정에서 끌 수 있지만, 개인 계정은 구글 서비스 약관을 따릅니다. 회사 코드라면 엔터프라이즈 조건을 먼저 확인하세요.
정리: 지금 무엇부터 하면 되나요?
- 화면으로 보며 맡기고 싶으면 2.0 앱, 서버·터미널이면 CLI, 편집기를 바꾸기 싫으면 IDE 확장을 고릅니다.
- 개인 @gmail.com 계정으로 로그인하고, 첫 작업은 워크트리 모드로 돌려 결과를 확인합니다.
- 무료 주간 할당량으로 한 주를 써 보고, 부족하면 Google AI Pro를 검토합니다.
- Claude 4.6이나 GPT-OSS에 기대고 있다면 2026년 11월 2일 전에 다른 모델로 옮깁니다.
AI 도구로 만든 서비스를 실제 운영까지 가져갈 때 어디서 막히는지는 바이브코딩이란?에 따로 정리했습니다.
