어쩐지 오늘은

안녕하세요. 이번 글은 Google의 Antigravity 사용법에 대해 작성한 글입니다.
키워드 : Google Antigravity, Google Antigravity 사용법
Antigravity
이름의 유래
Antigravity 소개글에 작성되어 있는 비전
    
Our vision is to ultimately enable anyone with an idea to experience liftoff and build that idea into reality.
Liftoff라는 용어는 항공기 전체가 지면에서 완전히 떨어지는 시점을 의미하는데, 구글은 자신의 아이디어 구현할 때 누구나 사용할 수 있는 도구를 만들고 싶었던 것 같음. 즉, 개발할 때 생기는 여러 이슈들을 중력이라 생각하고 그것을 대항할 수 있는 도구
여담으로 Python에서 import antigravity를 하면 XKCD 만화(353번)를 웹 브라우저로 열어주는 이스터에그가 발생하는데, 관련은 없지만 익숙한 용어였음
핵심 원칙
Antigravity의 핵심 원칙은 Trust, Autonomy, Feedback, Self-improvement
Trust
오늘날의 대부분의 제품은 두 케이스에 속함
    
(1) 에이전트가 수행한 모든 Action과 Tool 호출을 사용자에게 보여줌
(2) 작업의 컨텍스트나 검증할 방법 없이 최종 코드 변경 사항만 보여줌
이런 제품들은 에이전트가 왜 이 작업을 했는지, 어떻게 확인해야 하는지를 알기 어려움.
Antigravity는 사용자가 에이전트가 수행할 작업에 대한 신뢰를 가질 수 있도록 Actifact와 Verfication result(검증 결과)를 제공해 컨텍스트를 제공함
    
단순히 개별 Tool 호출이 전부 보이는 것이 아닌, 호출들이 Task 단위로 묶어서 표시함
Task에 대한 추상화된 정리와 진행 상황을 확인할 수 있음
사용자가 검증하기 쉬운 형식의 Artifact를 생성함. 예를 들어 Task list(작업 목록), Implementation plan(구현 계획), Walkthrough(단계별 설명서), 스크린샷, 브라우저 녹화 영상
사용하면서 인상 깊은 부분은 웹브라우저 작업을 할 때 녹화가 되는 기능으로 작업을 어떻게 진행했는지 확인할 수 있었음. Plan 버전으로 실행할 때 Implementation plan, Walkthrough를 제공하는 것도 좋았음
Autonomy
요즘 가장 직관적인 제품의 형태는 여러 Surface(편집기, 브라우저, 터미널)에 내장된 에이전트와 동기적으로 동작하는 형태
    
에이전트가 자율적으로 프론트엔드 코드를 구현하고, 터미널에서 로컬호스트 실행하고, 브라우저를 작동시켜 새로운 기능이 작동하는지 테스트하는 형태
이런 자율성을 최적으로 사용하기 위해 사용자가 에이전트와 비동기적으로 상호 작용할 수 있도록 Manager View를 만들었음
Agent Manager View는 여러 에이전트를 병렬로 생성하고 모니터링할 수 있는 관제탑 스타일의 화면
기존에 자주 사용하던 VSCode, Cursor 같은 스타일은 Editor View로 존재함(Editor View와 Manager View로 전환하는 단축키는 커맨드(컨트롤) + e)
Feedback
에이전트의 지능이 좋아지면서 여러 작업이 가능해졌지만, 아직 완벽하지 않음
    
이런 상황에서 피드백을 제공하면 도움이 됨
Antigravity는 모든 Surface나 Artifact에서 비동기 사용자 피드백을 허용함
Text Artifact에선 주석을 달 수 있고, 스크린샷에서 영역을 선택해서 주석을 달 수 있음
Self-improvement
에이전트가 일하면서 배운 내용을 저장하고, 나중에 비슷한 일을 할 때 참조함
    
명시적 정보 : 유용한 코드 snippet, 아키텍처 정보
설치
웹페이지에서 다운로드 가능
Mac 사용자라면 brew로도 설치 가능
  brew install --cask antigravity
    
처음에 설치하면 기존에 사용하던 IDE(VS Code, Windsurf, Cursor 등)의 설정을 불러올 수 있고, Start fresh를 눌러서 시작할 수 있음
Agent 설정은 Agent-assisted development으로 설정했음
Antigravity - 크롬 확장 프로그램 설치
위와 같은 구성을 확인할 수 있고, VSCode와 다르게 우측 상단에 크롬 아이콘이 있어서 눌러봄
설치가 필요한데, 이미 크롬이 설치되어 있어서 경로를 직접 수정함
    
Set custom Chrome binary path 클릭해서 경로 지정함
설정에서 Browser로 이동해서 Chrome Binary Path를 지정할 수 있음
다시 크롬 버튼을 누르니 온보딩 페이지로 나오고, 확장 프로그램을 설치함. 이를 통해 Antigravity에서 크롬을 제어할 수 있음
Agent
Agent의 Core Compoent
    
Reasoning model
Tools
Artifacts
Knowledge
Customization(커스텀 요소)
    
Agent Modes / Settings
MCP
Rules / Workflow
Models
Google Vertex Model Garden을 통해 모델 제공
    
사용자가 원하는 모델을 선택할 수 있음
Gemini 3 Pro (high)
Gemini 3 Pro (low)
Claude Sonnet 4.5
Claude Sonnet 4.5 (thinking)
Claude Opus 4.5 (thinking)
GPT-OSS
사용량 제한은 Plans 문서에서 확인할 수 있음
    
현재(25년 12월 기준) Preview라서 무료로 사용 가능하며, Google AI Plan 구독 여부에 따라 제공량이 다름
기본 제공
        
위에 제공하는 Model에 대한 기본 사용
Tab completion 무제한 제공
Command requests 무제한 제공
Agent Manager, Borwser integration 사용 가능
Google AI Ultra : 제일 많은 사용량, 5시간마다 쿼타 갱신
Google AI Pro : 많은 사용량, 5시간마다 쿼타 갱신
Google AI Plan에 가입하지 않은 경우 적당한 사용량을 제공하고 주마다 쿼타 갱신
아직 key를 사용하는 방식은 지원하지 않으나, 추후에 지원할 가능성이 높음
Antigravity 내부에서 사용하는 모델
Antigravity가 동작하는 과정에서 모델을 사용하고 있으며, 사용자가 설정할 수 없음
UI 목업 생성, 웹페이지나 앱에서 사용할 이미지 생성, 아키텍처 다이어그램 생성 : Nano Banana Pro
브라우저 서브 에이전트가 브라우저에서 클릭, 스크롤, 입력 등 브라우저를 제어할 때 : Gemini 2.5 Pro UI Checkpoint(내부적으로 커스텀한 모델로 추측)
체크포인팅, 컨텍스트 요약할 때 : Gemini 2.5 Flash
코드의 Semantic Search(의미 기반 검색) : Gemini 2.5 Flash Lite
Tools(MCP)
MCP를 사용해 Antigravity가 데이터베이스에 직접 접근해서 정보를 가져올 수 있음
연결 방법
우측 상단에 있는 Agent의 우측에 …을 클릭 -> MCP Servers 클릭
필요한 MCP 검색(저는 supabase)
Install 클릭 후, 환경 설정
이제 MCP의 Tool을 사용할 수 있음
Artifacts
Artifacts는 에이전트가 작업을 완료하거나 작업과 생각을 사용자에게 전달하기 위해 생성하는 모든 것
예시
    
Task list(할 일 목록)
Implementation plan(구현 계획)
Walkthrough(워크스루) : 변경 사항, 작업 과정 요약
Screenshots(화면 캡처)
Browser Recordings(브라우저 녹화)
Knowledge(지식)
아래 실제로 실행하는 부분에서 확인 가능
Agent Modes / Settings
에이전트의 모드나 설정에 대한 이해가 필요함
대화 모드
대화할 때 2가지 모드 중 선택할 수 있음
    
Planning, Fast
Planning : 작업 실행 전에 Plan을 세움. 복잡한 작업에서 활용하는 것이 좋으며, 작업에 따라 아티팩트 생성, 계획 등을 수행
Fast : 에이전트가 작업을 바로 실행함. 간단한 작업에 사용하며, 속도가 중요하고 품질 저하에 대한 걱정이 적을 때 사용
대화할 때 바로 설정할 수 있음
전반적인 설정
Antigravity Settings에서 설정할 수 있으며, Artifact Review Policy, Terminal Command Auto Execution Policy를 정의할 수 있음
Artifact Review Policy(아티팩트 리뷰 정책)
    
에이전트가 아티팩트에 대해 리뷰를 어떻게, 언제 물어볼지 결정하는 정책
Always Proceed : 에이전트가 리뷰를 요청하지 않고 작업 진행
Agent Decides : 에이전트가 리뷰 요청 시점을 스스로 결정
Request Review : 에이전트가 항상 리뷰 요청
Terminal Command Auto Execution Policy(터미널 커맨드 자동 실행 정책)
    
에이전트가 터미널 컴맨드를 자동으로 실행할지 결정하는 정책
Always Proceed : 에이전트가 터미널 명령을 실행하기 전에 확인하지 않고 실행
Agent Decides : 에이전트가 터미널 명령을 실행하기 전에 스스로 판단
Request Review : 에이전트가 터미널 명령을 실행하기 전에 항상 확인
두가지 설정 모두 Agent Decides로 설정하고 사용 중
유사하게 Browser Javascript Execution Policy도 존재함(설정 - Browser)
    
Disabled : 에이전트가 브라우저에서 자바스크립트 코드를 실행하지 않음
Always Ask : 에이전트가 항상 자바스크립트 코드를 실행하기 전에 확인
Model Decides : 에이전트가 자바스크립트 코드를 실행하기 전에 스스로 판단
Turbo : 확인 없이 자바스크립트 코드를 실행함
그 외에 Agent Non-Workspace File Access 설정은 Agent가 지금 작업 폴더와 Antigravity 루트 폴더(`~/.antigravity/) 외의 폴더에 접근할 수 있게 설정할 수 있음
Rules / Workflows
Rules : 지켜야 할 원칙
Workflows : AI가 행동해야 하는 순서 제공
Agent의 … 클릭 후 Customization을 누르면 설정할 수 있음
Rules
Agent가 따라야 하는 작업 스타일, 가이드를 작성한 마크다운 파일
Claude Code나 Gemini CLI를 사용하면 CLAUDE.MD, GEMINI.MD를 만드는데, 이 개념과 같다고 보면 됨
Global Rules와 Workspace Rules로 나뉨
    
Global Rules : ~/.gemini/GEMINI.md에 저장
Workspace Rules : 워크스페이스의 .agent/rules에 저장하고, 해당 워크스페이스에서만 적용
Rules 파일 제한 : 12,000자(character)
Customizations에서 +workspace를 눌러서 Workspace Rules를 추가할 수 있음(현재 있는 Global 설정은 한국어 응답하라는 내용이 저장되어 있음)
Workspace Rule도 어떤 상황에 활성화를 할 것인지 옵션이 존재함
    
Manual : 사용자가 에이전트 채팅창에서 @로 명시적으로 호출할 때 적용
Always On : 항상 모든 상황에 적용
Model Decision : Rule 파일을 읽고 현재 작업에 이 Rule이 필요한지 모델이 스스로 결정
Glob : 특정 파일 패턴과 일치하는 파일을 다룰 때 적용
Workflows
workflow는 반복되는 작업을 정리한 파일
    
작업들을 단계별로 정의하면 에이전트가 그 순서에 맞춰 일을 처리함
실행할 때 채팅창에서 /워크플로우이름을 입력하면 실행됨
.agent/workflows 폴더에 저장됨
Customizatios - Workflows - +workspace를 누르면 만들 수 있고, 채팅으로 만들라고 할 수도 있음
실행하니 정상적으로 동작함
실제 사용기
웹페이지 취약점 확인 후 동작 테스트
개인적으로 만들고 있던 웹페이지의 취약점을 확인하고, 그 후에 실제로 잘 동작하는지 확인해달라고 함
하나씩 확인하는데, 영상을 찍어서 제시함. 이게 Screen Recording
작업 완료한 후, 하단에서 여러 내용을 확인할 수 있음
    
수정된 파일, Artifact(Implementation Plan, Task, Walkthrough)
이번에는 직접 로그인을 한 후 다시 확인해보라고 하니, 로그인 상황에서 테스트를 진행함
관리자 계정이 아닌 계정으로 테스트하는게 좋을까?라고 물어보니 아래처럼 안내함(일단 false로 주석처리해서 테스트)
그 후 테스트하고 성능 측정 후 내용을 공유함
Walkthrough 문서에 댓글을 남긴 후, 피드백을 제출함
제출한 후에 Agent Manager에서 내가 남긴 댓글에 대한 답변을 볼 수 있음
Screen Recording 기능
Screen Recording은 Antigravity가 browser_subagent라는 도구를 사용해 브라우저를 제어할 때만 자동으로 수행됨
    
녹화 시점:  “브라우저를 열어서 확인해줘”라는 요청을 받거나, 스스로 웹페이지 테스트가 필요하다고 판단하여 브라우저 도구를 실행할 때그 세션의 화면이 녹화
녹화하는 것: 브라우저 창 내부에서 일어나는 일(클릭, 타이핑, 페이지 이동, 콘솔 로그 확인 등)만 녹화됨
Artifact가 어디에 저장하는지 확인해보니 다음 경로에 저장됨(/Users/UserName/.gemini/antigravity/)
    
동영상 용량은 작진 않아서 나중에 관리가 필요할 것으로 예상됨
대화 기록
만약 지난 대화를 찾고 싶다면 이 버튼을 통해서 찾을 수 있음
아키텍처 이미지 생성, 이미지 피드백
이번엔 아키텍처를 그려달라고 함
    
Created Task를 보면 Task가 생성되고, Task의 Progress Updates를 보여줌
생성된 이미지에서 드래그를 하면 의견을 특정 부분에 줄 수 있음. 이 기능이 꽤 유용함
다른 의견도 주고 Submit을 클릭해서 피드백을 제시함
피드백을 반영해 이미지가 변경됨
Agent Manager View
command + e 또는 ctrl + e를 누르면 에이전트 매니저로 전환됨
Inbox
아래 이미지는 Inbox에 진입한 상태
Pending만 확인할 수도 있음. 지금은 모두 다 확인해서 나오지 않음
Workspace
workspace에는 내가 대화한 내용들은 확인할 수 있음. 우측에 Review Changes를 누르면 변환된 부분만 확인할 수 있음
workspace에 질문을 하니, 에디터쪽에도 동일한 workspace가 열려있어서 동기화됨
대화하다가 실수로 Conversation을 껐는데, option + command + b로 Toggle Agent를 다시 살렸음. 우측 최상단에 있는 이 버튼이였음
Playground
Playgrounds are independent workspaces perfect for quick prototypes or following your curiosity. Move to a dedicated workspace to continue exploring with multiple conversations라고 나와있는데, 간단히 요약하면 프로토타입을 만들 때 쓸 수 있는 공간
여기서 구현한 기능을 지금 프로젝트로 move 하는 기능도 제공함
    
다만 지금 에디터로 열었던 파일들을 참고하지 않는다. 제로베이스에서 시작하는 것
~/.gemini/antigravity/playground/ : 경로를 확인해보니 해당 폴더에 저장됨
Knowledge
persistent memory라고 나와있는데, 아직 생성된 지식이 없어서 아무것도 나오지 않음
Changelog
Changelog 페이지를 보면 어떤 기능을 업데이트했는지 확인할 수 있음
25년 12월 4일 기준 Google AI Pro, Ultra 구독자에게 사용량을 늘려주고 Rate limit 주기를 더 빈번하게 수정함. 그 전에는 조금만 쓰면 쿼타가 찼다는 이야기가 나왔는데, Google AI 요금제랑 연동해서 점점 해결될 것으로 보임
전반적인 후기
Antigravity 장점
현재 Preview라 무료 사용 가능(Google AI 멤버십을 사용한다면 더 많은 사용량을 받음. Gemini 구독 중이라면 꼭 써보는 것을 추천)
Gemini 3, Claude Opus도 사용 가능
크롬 브라우저와 통합되어서 브라우저 제어가 수월함
브라우저 작업시 Screen Recording을 해서 확인할 수 있음
Agent Manager 구성으로 Agent가 어떻게 동작하는지 확인할 수 있음(다른 IDE와 차별점)
이미지에 드래그를 해서 피드백을 줄 수 있음(디테일한 피드백)
기존에 VSCode를 사용했는데, Antigravity를 메인으로 사용할 예정
개선하면 좋을 부분
나온지 얼마 되지 않아서 오류가 존재할 수 있음. 이는 Preview 단계라 그렇고 점점 개선될 것으로 예상
BigQuery MCP 설정할 때 오류가 발생했는데, 디버깅이 어려웠음