[특집 1부] 구글 안티그래비티(Google Antigravity) 핵심 기능 완벽 해부: 5대 실행 환경(App·CLI·IDE·확장·SDK), 타사 AI 모델(클로드 5.5·GPT-OSS) 통합 활용법, 아티팩트 사전 검증과 Git 리뷰, 내장 브라우저 서브에이전트와 보안 샌드박스 가이드

[특집 1부] 구글 안티그래비티(Google Antigravity) 핵심 기능 완벽 해부: 5대 실행 환경(App·CLI·IDE·확장·SDK), 타사 AI 모델(클로드 5.5·GPT-OSS) 통합 활용법, 아티팩트 사전 검증과 Git 리뷰, 내장 브라우저 서브에이전트와 보안 샌드박스 가이드

 

2026년 하반기, 인공지능 활용의 중심축이 '채팅창에 질문하고 답변을 복사해 오는 1세대 방식'에서 '내 컴퓨터의 폴더와 브라우저를 직접 제어하는 복수의 AI 에이전트 팀을 지휘하는 2세대 방식'으로 완전히 이동했습니다. 이 거대한 변화를 이끄는 플랫폼이 바로 구글의 차세대 에이전트 개발·업무 환경인 구글 안티그래비티(Google Antigravity)입니다.

안티그래비티가 전 세계 개발자와 실무자들에게 폭발적인 호응을 얻고 있는 결정적인 이유는 두 가지입니다. 첫째, 코드를 한 줄이라도 고치기 전에 시각적인 계획서와 브라우저 실행 증거물을 먼저 제출해 사용자의 시행착오를 줄여줍니다 (Introducing Google Antigravity 2.0). 둘째, 구글이 만든 플랫폼임에도 자사 제미나이 모델만 고집하지 않고 앤트로픽의 클로드 5.5(Claude Sonnet 5.5 · Opus 5.5)와 오픈소스 GPT 모델까지 기본 탑재해 작업 성격에 따라 자유롭게 갈아끼울 수 있는 멀티 모델 개방성을 갖추었기 때문입니다 (Choose a model 공식 문서).

이번 [구글 안티그래비티 심층분석 3부작 특집]에서는 복잡한 요금표 나열을 빼고, 실제 사용자가 설치 직후부터 200% 활용할 수 있는 실전 기능과 워크플로우만 꽉 채워 정리했습니다. 첫 시간인 1부에서는 구글 안티그래비티 핵심 기능 완벽 해부를 시작으로 5대 실행 환경(App·CLI·IDE·확장·SDK) 시작법, 핵심 무기인 타사 AI 모델(클로드 5.5·GPT-OSS) 통합 활용법, 실수를 막아주는 아티팩트 사전 검증과 Git 리뷰, 그리고 스스로 화면을 클릭하며 점검하는 내장 브라우저 서브에이전트와 보안 샌드박스 가이드까지 상세히 파헤쳐 보겠습니다.

 

1. 구글 안티그래비티(Google Antigravity) 핵심 기능 완벽 해부: 왜 차세대 에이전트 지휘 본부인가

구글의 도구를 처음 찾아보면 제미나이 웹 앱, Google AI Studio, 제미나이 CLI, 그리고 안티그래비티까지 이름이 다양해 역할이 헷갈리기 쉽습니다. 국내 에이전트 실무 가이드인 준이아빠블로그의 안티그래비티 해설에서 짚어주듯, 구글은 기존 개인용 제미나이 CLI 사용자들을 안티그래비티로 통합 안내하며 로컬 파일 작업과 멀티 에이전트 관제의 중심 허브를 안티그래비티로 일원화했습니다.

(1) 기존 AI 코딩 보조 도구(Copilot)와 무엇이 다른가?

• 기존 자동완성형 보조 도구: 사람이 직접 파일 트리를 열고 코드를 치면 옆에서 다음 한두 줄을 추천해 주거나 채팅창에 코드 조각을 뱉어내는 '조수' 역할에 머물렀습니다.
• 구글 안티그래비티 (v2.30+ 에이전트 하네스): 여러 프로젝트를 동시에 띄워 놓고 목표만 지시하면, 에이전트가 스스로 ① 구현 계획 수립 → ② 로컬 파일 다중 편집 → ③ 터미널 테스트 실행 → ④ 내장 브라우저 구동 및 화면 캡처 검증 → ⑤ 결과 브리핑까지 전 과정을 완수합니다 (Google 공식 유튜브 가이드). 사람은 지루한 타이핑 대신 에이전트가 올린 계획서와 결과물을 검토하고 방향만 잡아주는 '감독관(Director)'이 됩니다.

2. 5대 실행 환경(App·CLI·IDE·확장·SDK): 설치 명령어부터 첫 프로젝트(Local vs Worktree) 시작법

공식 개요 문서(Choose your Antigravity)에 따르면 안티그래비티는 동일한 에이전트 엔진을 공유하는 5가지 실행 표면(Surfaces)을 제공합니다. 모두 설치할 필요 없이 내 손에 가장 잘 맞는 환경 하나만 골라 시작하면 됩니다 (Quickstart 공식 문서).

(1) 내 작업 스타일에 맞는 실행 환경 선택 및 설치법

실행 환경	특징 및 강점	설치 및 실행 방법 요약	추천 대상
1. Antigravity App (v2.30+)	여러 로컬·원격 에이전트를 한 화면에서 지휘하는 독립 데스크톱 앱. 개발자 레이아웃과 비개발자용 지식 작업 레이아웃 즉시 전환 지원	공식 다운로드 페이지에서 macOS(Apple Silicon/Intel), Windows, Linux 설치 파일 실행	입문자, 비개발자, 멀티 에이전트 병렬 작업을 선호하는 모든 사용자
2. Antigravity CLI (agy v1.2+)	마우스 없이 키보드만으로 초고속 동작하는 터미널 에이전트. 원격 SSH 서버 작업 및 스크립트 자동화(agy -p)에 최적	• macOS/Linux: curl -fsSL https://antigravity.google/cli/install.sh | bash • Windows PowerShell: irm https://antigravity.google/cli/install.ps1 | iex	터미널이 익숙한 개발자, 원격 서버 엔지니어
3. Antigravity IDE	코드 편집기 안에 에이전트 매니저, 인라인 Diff 승인(Alt+Enter), 탭 자동완성이 일체형으로 결합된 전용 에디터	공식 사이트에서 Antigravity IDE 독립 설치본 다운로드 (백그라운드 자동 업데이트 지원)	Cursor나 VS Code 일체형 화면을 선호하는 코더
4. 6대 IDE 공식 확장	내가 원래 쓰던 코드 편집기에 안티그래비티 에이전트 사이드 패널(Cmd/Ctrl + L)과 탭 자동완성을 그대로 이식	VS Code, Visual Studio, JetBrains(IntelliJ·PyCharm 등), Zed, Xcode, Eclipse 각 마켓플레이스에서 Google Antigravity 검색 후 설치	기존 에디터 단축키와 플러그인 환경을 그대로 유지하고 싶은 현업 개발자
5. Antigravity SDK (Python)	파이썬 코드(pip install google-antigravity)로 커스텀 에이전트, 도구 허용 정책, 로컬 LLM을 내 프로그램에 직접 내장	Python 3.10+ 가상환경에서 패키지 설치 후 Agent, LocalAgentConfig 클래스 호출	자체 업무 자동화 파이프라인이나 사내 봇을 만드는 빌더

(2) 첫 프로젝트 생성 시 핵심 선택: Local Mode vs New Worktree Mode

데스크톱 앱 좌측 사이드바에서 [+ New Project] → [Add Folder]로 내 작업 폴더를 연결하고 첫 지시를 입력하면, 에이전트를 어떤 방식으로 구동할지 묻는 두 가지 모드가 나타납니다 (Quickstart 공식 문서, 준이아빠블로그 실습 안내).

1. Local Mode (로컬 직접 수정 모드): 내가 연결한 실제 폴더 안의 파일을 에이전트가 즉시 직접 수정합니다. Git을 쓰지 않는 일반 문서 폴더나 간단한 연습 프로젝트에서 결과를 바로 확인할 때 가장 직관적입니다.
2. New Worktree Mode (격리된 Git 워크트리 모드): 원본 폴더(메인 브랜치)를 전혀 건드리지 않고, Git이 관리하는 별도의 복제 작업 공간(Worktree)을 옆에 새로 파서 안전하게 코딩합니다. 여러 명의 에이전트에게 서로 다른 실험을 동시에 시켜도 원본 코드가 망가질 위험이 0%인 실무 필수 기능입니다.

3. 타사 AI 모델(클로드 5.5·GPT-OSS) 통합 활용법: 제미나이와 클로드를 적재적소에 섞어 쓰는 실전 공식

많은 분이 놓치고 있는 안티그래비티 최대의 반전 매력은 바로 '멀티 모델 개방성'입니다. 타사 공식 코딩 도구들이 자사 모델만 강제하는 것과 달리, 안티그래비티는 구글의 프론티어 모델은 물론 앤트로픽(Anthropic)의 최신 클로드 추론 모델과 오픈소스 모델까지 에이전트 두뇌로 기본 탑재하고 있습니다 (Choose a model 공식 문서).

(1) 안티그래비티 내부에서 바로 골라 쓸 수 있는 AI 모델 라인업

채팅 입력창 바로 아래의 모델 선택 드롭다운 메뉴(Other Models 포함)를 열면 다음 모델들을 실시간으로 전환하며 쓸 수 있습니다 (Choose a model 공식 문서, Enterprise 모델 문서).

• 구글 퍼스트파티 추론 모델군:
  • Gemini 4 Carbon (Low / Medium / High): 수십 개 파일이 얽힌 아키텍처 재설계, 고난도 근본 원인 디버깅, 3D 공간·물리 구현에 특화된 최상위 모델입니다.
  • Gemini 4 Argon (Low / Medium / High): 100만 토큰의 방대한 코드베이스와 문서를 빠르게 읽고 처리하는 주력 올라운더 모델입니다.
  • Gemini 3.8 Flash (Fast / Low / Medium / High): 압도적인 응답 속도로 일상적인 코드 수정, 테스트 반복, 스케줄 자동화를 막힘없이 처리합니다.
• 앤트로픽 클로드 & 오픈소스 서드파티 모델군:
  • Claude Sonnet 5.5 (Thinking): 코딩 커뮤니티에서 가장 사랑받는 클로드 주력 추론 모델입니다. 안티그래비티 안에서 Low, Medium(기본값), High, Max 4단계 사고 수준을 작업 난이도에 맞춰 세밀하게 골라 쓸 수 있습니다!
  • Claude Opus 5.5 (Thinking): 마찬가지로 Low, Medium, High, Max 4단계 사고 수준을 모두 지원하며, 극한의 리팩토링과 정교한 한국어 문서·카피 작성에서 탁월한 디테일을 발휘합니다.
  • Claude 4.6 (Sonnet·Opus) 및 GPT-OSS-120B: 초기 개방 모델로 제공되어 왔으며, 공식 문서 일정상 2026년 11월 18일부로 목록에서 정리되고 최신 제미나이 4 및 클로드 5.5 중심 체제로 고도화됩니다 (Choose a model 공식 문서).
• 백그라운드 자동 협업 모델 (Nano Banana 2): 사용자가 별도로 선택하지 않아도, 에이전트가 웹페이지 UI 시안을 짜거나 빈 화면에 들어갈 일러스트·시스템 아키텍처 다이어그램을 만들어야 할 때 내부 이미지 생성 도구인 나노 바나나 2(Nano Banana 2)를 자동으로 호출해 시각 에셋까지 한 번에 완성합니다 (Choose a model 공식 문서).

(2) 실무자가 뽑아 먹는 '제미나이 × 클로드 교차 투입' 워크플로우

안티그래비티 안에서는 대화 맥락을 잃지 않고 언제든 모델을 바꿀 수 있습니다. (에이전트가 작업 중일 때 모델을 바꾸면 현재 턴을 마친 직후 다음 메시지부터 새 모델이 바통을 이어받습니다.) 게다가 시스템 내부적으로 '제미나이 모델 그룹'과 '클로드·GPT 모델 그룹'의 사용량 풀(Pool)이 별도로 분리 관리됩니다 (Model quotas 공식 문서). 이를 활용한 최고의 실전 조합은 다음과 같습니다.

1. 1단계 (대규모 탐색 및 초안 구축 → Gemini 4 Argon 또는 3.8 Flash): 수백 페이지의 PDF 기획서나 전체 프로젝트 폴더를 한꺼번에 읽히고 기본 뼈대와 백엔드 데이터를 연결할 때는 100만 토큰 처리력이 뛰어난 제미나이 모델을 투입합니다.
2. 2단계 (섬세한 UI 디자인 및 코드 다듬기 → Claude Sonnet 5.5 스위칭): 같은 대화창에서 모델 선택기만 Claude Sonnet 5.5 (High)로 딸깍 바꾼 뒤, *"방금 만든 대시보드의 컴포넌트 여백과 마이크로 인터랙션, 한국어 안내 문구를 더 세련되게 리팩토링해 줘"*라고 지시합니다.
3. 3단계 (난성 버그 교차 검증 → Gemini 4 Carbon 또는 Claude Opus 5.5): 한 모델이 계속 같은 에러에서 맴돌 때 다른 진영의 최상위 모델로 즉시 바꿔 *"이전 모델이 놓친 근본 원인을 새로 진단해 줘"*라고 시키면 거짓말처럼 한 번에 뚫리는 경험을 할 수 있습니다 (AI수익화초월차선 실사용 리뷰).

4. 아티팩트 사전 검증과 Git 리뷰: 코드 수정 전 계획서 첨삭부터 줄 단위 Diff 코멘트까지

에이전트에게 큰 작업을 맡겼을 때 엉뚱한 파일이 망가지는 참사를 막아주는 안티그래비티만의 핵심 안전망이 바로 아티팩트(Artifacts) 검토와 통합 리뷰(Review) 패널입니다 (Review changes 공식 문서).

(1) 일 저지르기 전에 방향을 잡는 '구현 계획서 인라인 코멘트'

실행 모드를 Planning 모드(Request review)로 두면, 에이전트는 코드를 고치기 전에 우측 사이드 패널에 구현 계획서(Implementation Plan) 아티팩트를 먼저 띄웁니다 (준이아빠블로그 가이드).

• 계획서를 읽어보고 마음에 안 드는 부분이 있으면 채팅창에 길게 설명할 필요가 없습니다.
• 계획서의 해당 줄을 마우스로 드래그해 [Comment(C)]를 누르고 *"이 파일은 건드리지 말고 기존 CSS 변수를 재사용해 줘"*라고 메모를 달아 승인하면, 에이전트가 내 피드백을 정확히 반영해 본 작업을 시작합니다 (Google 공식 유튜브 데모).

(2) 앱을 떠나지 않고 끝내는 줄 단위 Diff 피드백과 Git 커밋

작업이 끝난 뒤 우측 상단 Overview 패널에서 [Review] 버튼을 누르면(또는 에디터에서 변경된 줄을 보면) 강력한 버전 관리 화면이 열립니다 (Review changes 공식 문서, 에디터 리뷰 문서).

• 3가지 비교 뷰 전환: 아직 저장 안 된 전체 변경분(Uncommitted), 현재 브랜치 전체 변경분(Branch), 그리고 오직 에이전트가 이번 대화에서 고친 파일만 모아보는 Agent Edits 뷰를 입맛대로 골라 볼 수 있습니다.
• 줄 단위 코드 코멘트 (Cmd/Ctrl + Alt + M): 수정된 코드 중 마음에 안 드는 줄 번호 옆 + 버튼을 눌러 코멘트를 달면 다음 프롬프트 대기열에 자동으로 들어가 그 줄만 재수정시킬 수 있습니다. Antigravity IDE에서는 단축키 Alt + Enter(Option + Enter)로 변경 사항을 즉시 수락하거나 Alt + Shift + Enter로 거절할 수 있습니다.
• 빈칸으로 누르면 알아서 써주는 커밋 메시지: 검토가 끝나면 터미널을 열 필요 없이 Review 창 안에서 파일을 스테이징(Stage)하고 커밋 메시지 칸을 비워둔 채 [Commit]만 누르세요. 에이전트가 변경 내역을 요약한 깔끔한 Git 커밋 메시지를 자동 작성해 저장하고 원격 저장소로 푸시(Push)까지 마쳐줍니다 (Feature overview 공식 문서).

5. 내장 브라우저 서브에이전트와 보안 샌드박스 가이드: /browser 자율 테스트와 3단계 실행 권한 제어

코드를 다 짰다면 실제로 브라우저에서 화면이 깨지지 않는지 눈으로 확인해야 합니다. 안티그래비티는 이 과정마저 브라우저 서브에이전트(Browser Subagent)로 자동화했습니다 (Feature overview 공식 문서).

(1) 크롬 설치 없이 돌아가는 내장 브라우저와 /browser 활용법

1. 멀티 탭 실시간 자율 클릭 (v2.30.0+): 채팅창에 *"로컬 서버를 띄우고 회원가입 버튼이 잘 눌리는지 직접 브라우저로 테스트해 줘"*라고 말하거나 /browser를 입력하면, 우측 사이드 패널의 내장 브라우저에서 서브에이전트가 스스로 마우스 커서를 움직여 버튼을 클릭하고 콘솔·네트워크 에러를 수집합니다.
2. 로그인 수동 인계(Handoff)와 프로필 격리: 테스트 도중 로그인이 필요한 화면이 나오면 에이전트가 잠시 멈추고 사용자에게 바통을 넘깁니다. 사용자가 직접 로그인을 마친 뒤 재개 버튼을 누르면 그 이후 테스트를 이어가며, 내 평소 크롬 브라우저와 쿠키가 완전히 분리되어 개인 계정이 섞이지 않습니다.
3. 웹 화면 드래그 인용 (Cmd/Ctrl + L): 내장 브라우저에 띄운 내 웹 앱이나 공식 기술 문서에서 고치고 싶은 문구를 드래그한 뒤 Cmd + L(Windows Ctrl + L)을 누르면 해당 텍스트와 페이지 URL이 내 입력창에 그대로 인용되어 *"방금 집어준 이 부분 글씨 크기를 키워줘"*처럼 직관적인 지시가 가능합니다.

(2) 내 소중한 로컬 PC를 지키는 권한 프리셋 설정법

초보자가 가장 안심하고 쓸 수 있는 실행 권한 세팅입니다 (Feature overview 공식 문서).

• 폴더 경계 보안 (Bounded Access): 에이전트는 기본적으로 내가 열어준 프로젝트 폴더 바깥의 내 개인 문서나 바탕화면 파일은 절대 읽거나 고치지 못합니다.
• 추천 권한 모드 (Auto 프리셋): 매번 승인 버튼을 누르는 피로를 줄이면서도 안전을 지키는 최적의 설정입니다. 격리된 터미널 샌드박스 내부 테스트와 되돌릴 수 있는 안전한 파일 수정은 자동 진행하고, 파일 영구 삭제나 외부 시스템 변경 같은 비가역적 위험 동작만 화면에 승인 창을 띄워 물어봅니다.

6. 마치며: 실무 속도를 2배 높이는 필수 단축키 요약 및 2부 예고

1부를 마무리하며 손에 익혀두면 작업 속도가 두 배 빨라지는 공식 핵심 단축키 5가지를 챙겨두세요.

• Cmd + K / Ctrl + K: 과거 모든 대화 내용과 프롬프트 본문 전체 검색 및 프로젝트 빠른 전환
• Cmd + P / Ctrl + P: 현재 프로젝트 내 파일 이름 초고속 검색 열기
• Cmd + L / Ctrl + L: 마우스 없이 채팅 입력창으로 커서 즉시 이동 (코드·웹 문구 선택 시 자동 인용 추가)
• Cmd + N / Ctrl + N: 깨끗한 새 에이전트 대화 세션 즉시 시작
• Cmd + J / Ctrl + J: 사이드 패널 내 통합 터미널 즉시 열기/닫기

이어지는 [특집 2부: 구글 안티그래비티 실전 마스터]에서는 제미나이와 클로드 에이전트들을 한 팀으로 묶어 동시에 코딩시키는 /swarm 멀티 모델 군집 협업, 기획 단계에서 AI가 나를 인터뷰하는 /grill-me와 클릭형 다이어그램을 그려주는 /generative_ui 슬래시 커맨드, 나만의 AGENTS.md 규칙과 SKILL.md 스킬 설계법, 그리고 인터넷 없이 내 PC의 Ollama·Gemma 4 로컬 오픈소스 모델로 에이전트를 돌리는 고급 활용법을 상세히 이어갑니다!