Antigravity 2.0 사용법: 무료 한도·한글 설정·CLI 설치

Antigravity는 만 18세 이상이면 개인 Google 계정으로 무료로 쓸 수 있다. 화면에서 여러 프로젝트를 관리하려면 2.0 앱을, 터미널에서 쓰려면 CLI(agy)를 설치한다. 무료는 매주 초기화되는 한도이고, AI Pro·Ultra는 5시간마다 초기화되는 더 큰 한도를 주간 한도 안에서 받는다. 한국어로 답하게 하려면 전역 규칙 파일에 한 줄을 적는다.

Antigravity는 무엇인가

Google의 에이전트 개발 도구다. 에이전트가 파일을 읽고 고치고, 명령을 실행하고, 웹을 조사하고, 하위 에이전트까지 부려 긴 작업을 맡는다. 코드를 직접 타이핑하는 IDE보다 할 일을 정하고 에이전트를 지휘하는 방식에 가깝다. 2026년 I/O에서 2.0 데스크톱 앱, CLI, SDK로 넓어졌다. (Antigravity 개요, I/O 2026 발표)

방식	맞는 경우
Antigravity 2.0 앱	여러 프로젝트와 에이전트를 화면에서 관리
Antigravity CLI	같은 기능을 터미널에서 사용
Python SDK	코드로 에이전트를 제어

개인용 Gemini CLI는 2026년 6월 18일 종료됐다. (Google 발표) 옮겨 오는 경우는 Gemini CLI 종료와 Antigravity CLI 전환을 본다.

무료로 쓸 수 있나: 요금제별 사용량

모든 계정이 Gemini 3.1 Pro·3.8 Flash 같은 모델을 에이전트로 쓸 수 있고, Tab 자동 완성은 무제한이다. 예약 작업과 CLI를 포함한 모든 기능을 쓸 수 있고, 차이는 사용량, 초기화 주기, Ultra의 외부 모델 사용이다. (요금제 안내)

계정	사용량	초기화
무료(개인 Google 계정)	기본 사용량	매주
Google AI Pro	더 많은 사용량	5시간마다(주간 한도까지)
Google AI Ultra	가장 많은 사용량, 외부 모델 사용	5시간마다(주간 한도까지)

• 한도는 질문 수가 아니라 에이전트가 한 작업량만큼 준다. 긴 작업은 금방 쓴다.
• 남은 양: CLI에서 /usage(또는 /quota)로 모델별 남은 사용량을, /credits로 AI 크레딧 잔액을 본다. 앱은 설정 화면에서 본다. (사용량 명령, CLI 명령)
• 한도를 넘겨 쓰려면: AI Pro·Ultra는 구매한 AI 크레딧으로 이어 쓴다. 설정의 “AI Credit Overages”를 Never로 두면 크레딧을 쓰지 않고 초기화를 기다린다. 자기 API 키로 한도를 늘리는 방식은 지원하지 않는다.
• Antigravity 로그인을 다른 도구에 쓰면 안 된다. Claude Code·OpenCode 같은 외부 도구에서 쓰는 것은 약관 위반이고, 계정이 정지되거나 해지될 수 있다. (FAQ)

한국은 지원 국가지만 만 18세 이상이어야 한다. 회사·학교 계정에서 막히면 @gmail.com 개인 계정으로 시도하라고 FAQ가 안내한다. (FAQ)

한국어로 답하게 하려면

Antigravity는 ~/.gemini/GEMINI.md(또는 AGENTS.md)를 모든 프로젝트에 적용되는 규칙으로 읽는다. (규칙 문서)

1. PowerShell에서 폴더를 만들고 메모장으로 파일을 연다.

New-Item -ItemType Directory -Force "$env:USERPROFILE\.gemini" | Out-Null
notepad "$env:USERPROFILE\.gemini\GEMINI.md"

2. 다음 줄을 적고 저장한다. 파일이 이미 있으면 이 줄만 추가한다.

- 모든 답변, 계획, 작업 요약은 한국어로 작성한다. 코드와 명령어는 원문 그대로 둔다.

3. Antigravity를 다시 열고 새 대화를 시작한다.

Antigravity IDE 2.1.1이 설치된 Techies Note PC의 %USERPROFILE%\.gemini 폴더를 9월 28일 확인하니 GEMINI.md가 없었다. 설치만으로는 규칙 파일이 생기지 않으니 직접 만든다. 한 프로젝트에서만 한국어로 받으려면 그 프로젝트 폴더에 같은 파일을 만든다. 겹치면 더 구체적인 폴더 규칙이 우선한다.

2.0 앱 설치와 첫 프로젝트

다운로드 페이지에서 받는다. Windows 10 64비트 이상(x64·ARM64), macOS 12 이상(Apple Silicon·Intel), Linux(x64·ARM64)를 지원한다.

1. 앱 왼쪽 사이드바의 폴더 + 아이콘 → New Project를 누른다.
2. Add Folder로 로컬 폴더나 Git 저장소를 붙이고 Create를 누른다.
3. 입력창에 할 일을 적으면 모드를 고르는 창이 뜬다. Local Mode는 폴더에서 바로 작업하고, New Worktree Mode는 새 Git worktree에서 작업해 지금 작업 폴더를 건드리지 않는다. (시작하기)

기본 권한 설정에서 Windows는 터미널 명령을 실행하기 전에 승인을 묻는다. (프로젝트 문서) 첫 요청은 파일을 바꾸지 않는 읽기 작업으로 한다.

이 프로젝트를 먼저 읽고 실행 방법과 핵심 폴더를 설명해줘. 아직 파일은 수정하지 마.

앱의 슬래시 명령으로는 /goal(중간에 되묻지 않고 끝까지 진행), /grill-me(구현 전에 세부 사항을 먼저 되물음), /schedule(한 번 또는 반복 예약 실행), /browser(Chrome 브라우저 동작 제어)가 있다. (시작하기)

Windows에 CLI 설치하기

PowerShell에서 실행한다. 설치 위치는 %LOCALAPPDATA%\agy\bin이다. (CLI 시작하기)

irm https://antigravity.google/cli/install.ps1 | iex

Antigravity IDE를 설치했다고 agy가 생기지는 않는다. Techies Note PC에는 Antigravity IDE 2.1.1이 설치돼 있지만, 9월 28일 확인하니 antigravity-ide 명령만 있고 agy와 그 설치 폴더는 없었다. 터미널에서 쓰려면 위 스크립트를 따로 실행한다. 설치 뒤에도 agy를 찾지 못하면 설치 폴더가 PATH에 없는 것이니, PATH에 넣고 터미널을 다시 연다. (CLI 문제 해결)

CLI는 파일을 고치기 전에 확인하는 정도를 Shift+Tab으로 바꾼다. (실행 모드)

모드	동작
default	수정 전에 변경 내용을 보여 주고 승인받는다
accept-edits	파일 수정·생성을 자동 승인한다
plan	코드를 쓰기 전에 분석하고 단계 계획부터 세운다

셸 명령 실행 승인은 이 모드와 따로, /permissions 설정이나 --dangerously-skip-permissions 옵션을 따른다.

Gemini API 키로 CLI 쓰기

브라우저 로그인이 어려운 서버에서는 API 키로 쓴다. %USERPROFILE%\.gemini\antigravity-cli\settings.json에 "modelProvider": "gemini"를 넣고, 같은 창에서 $env:GEMINI_API_KEY="키"를 설정한 뒤 agy를 실행한다. 연결되면 헤더에 계정 대신 Gemini API key가 표시된다. (설치·인증)

증상	원인
시작하자마자 키가 없다며 종료	modelProvider는 있는데 환경 변수에 키가 없다
계정 로그인으로 넘어감	modelProvider 철자가 틀렸다(gemini만 허용)
.env에 넣었는데 안 됨	CLI는 GEMINI_API_KEY 환경 변수만 읽는다

계정 로그인으로 되돌릴 때는 modelProvider 항목을 지운다. 키만 지우면 CLI가 시작되지 않는다. API 키 만드는 법은 Gemini API 키 발급에 있다.