Antigravity 설치 및 화면설명 (고급 가이드)

Mar 2. 2026

1. AntiGravity란 무엇인가?

Google Antigravity는 2025년 11월 18일에 출시된 에이전트 중심의 차세대 AI 통합 개발 환경(IDE, Integrated Development Environment)입니다. 단순히 코드를 추천하거나 자동 완성하는 수준을 넘어, AI 에이전트가 스스로 작업 계획 수립, 코드 구현, 터미널 명령 실행 및 브라우저 테스트까지 자율적으로 수행하는 것이 핵심입니다.

개발자는 이제 코드를 직접 한 줄씩 짜는 사람이 아니라, 여러 에이전트를 설계하고 조율하며 결과물을 검증하는 '오케스트레이터(Orchestrator)' 역할을 수행하게 됩니다. 특히 에이전트 매니저 기능을 통해 여러 프로젝트를 병렬로 동시에 진행하며 생산성을 극대화할 수 있다는 점이 가장 큰 특징입니다.

Google은 Antigravity를 "에이전트 시대 소프트웨어 개발의 홈 베이스"로 포지셔닝하며, 이것이 단순한 점진적 개선이 아닌 개발 방식의 근본적인 전환이라고 강조합니다. Google의 비전은 "아이디어를 가진 누구든 그 아이디어를 현실로 구현할 수 있도록" 하는 것입니다.

2. 설치 및 환경 설정

2.1 Antigravity 프로그램 설치하기

공식 Google Antigravity 다운로드 페이지에서 운영체제에 맞는 설치 파일을 다운로드하여 설치합니다. Windows, Mac OS, Linux를 모두 지원합니다. 컴퓨터 메모리는 최소 8GB RAM이 필요하지만, 여러 프로그램을 동시에 실행하고 원활한 작동을 위해 16GB RAM 이상을 권장합니다.

https://antigravity.google/

Google Antigravity

Google Antigravity - Build the new way

https://antigravity.google

https://antigravity.google/download

Mac 에서 RAM 확인하는 방법 : Apple 로고 > 이 Mac에 관하여 > 메모리

2.2 온보딩 및 구글 로그인

설치 후 처음 실행하면 초기 설정(Onboarding) 화면이 나타납니다.

2.2.1 테마 설정 : 사용자 취향에 따라 Light 모드 또는 Dark 모드를 선택하고 Next 버튼을 클릭합니다.

2.2.1 작동방식 설정 : 이어서 'Antigravity Agent'의 작동 방식과 권한 범위를 설정합니다. 쉽게 말해 "AI에게 얼마나 많은 권한을 줄 것인가?"를 정하는 단계입니다.

(1) Strict Mode

에이전트의 모든 행동에 사용자 확인을 강제하는 최고 보안 모드입니다. 터미널 실행, 브라우저 조작, 아티팩트 실행 등 모든 정책이 "승인 필요" 상태로 고정됩니다.

특징

• 에이전트가 단 하나의 명령도 사용자 승인 없이 실행 불가

• 에이전트 자율성과 작업 속도가 가장 낮음

• 보안 수준은 4가지 모드 중 가장 높음

추천 상황

• 출처를 알 수 없거나 신뢰하기 어려운 워크스페이스를 탐색할 때

• 에이전트의 모든 행동을 직접 눈으로 확인하고 싶을 때

• 보안이 최우선인 프로젝트를 다룰 때

(2) Review-driven development (RECOMMENDED)

주요 실행 정책(터미널, 검토 정책 등)에 대해 에이전트가 작업을 진행하기 전에 사용자에게 검토를 요청하는 모드입니다. 사람이 계속 감독하면서 에이전트와 협력하는 방식입니다.

특징

• Terminal execution policy: Request Review (터미널 명령 실행 전 검토 요청)

• Review policy: Request Review (작업 계획 검토 요청)

• JavaScript execution policy: Disabled (JS 실행 비활성화)

• 에이전트가 독단적으로 진행하지 않아 사용자가 항상 통제권 유지

추천 상황

- Antigravity를 처음 사용하는 입문자

- 에이전트의 작업 과정을 단계별로 이해하고 싶을 때

- 실수 없이 안전하게 프로젝트를 진행하고 싶을 때

(3) Agent-driven development

에이전트가 사용자 개입 없이 모든 것을 자율적으로 처리하는 풀 자동화 모드입니다. 에이전트가 계획부터 실행, 검증까지 전부 알아서 진행합니다.

특징

• Terminal execution policy: Always Proceed (터미널 자동 실행)

• Review policy: Always Proceed (검토 없이 자동 진행)

• JavaScript execution policy: Always Proceed (JS 자동 실행)

• 에이전트가 절대 검토를 요청하지 않아 작업 속도가 가장 빠름

추천 상황

• 에이전트의 능력을 충분히 파악하고 신뢰할 수 있을 때

• 반복적이고 명확한 작업을 빠르게 처리하고 싶을 때

• 대규모 코드 자동화나 빠른 프로토타이핑이 필요할 때

(4) Custom configuration

세 가지 정책(터미널, 리뷰, JavaScript)을 사용자가 직접 원하는 대로 조합해서 설정하는 모드입니다.

특징

• Terminal execution policy, Review policy, JavaScript execution policy를 각각 독립적으로 설정 가능

• 각 정책마다 Always Proceed / Request Review / Disabled 중 선택

• 브라우저 허용 목록(Browser allowlist)은 기본적으로 localhost로 시작하며 Settings에서 변경 가능

추천 상황

• 특정 작업은 자동화하되, 중요한 작업만 직접 검토하고 싶을 때

• 팀 또는 프로젝트 특성에 맞게 세밀한 권한 제어가 필요할 때

• 위의 3가지 모드가 딱 맞지 않고 중간 어딘가의 설정이 필요할 때

2.2.3 Configure Your Editor(에디터 설정)

이 페이지는 사용자가 Antigravity 내에서 코드를 작성하고 수정할 때 사용할 편집 환경을 최적화하는 단계입니다.

주요 설정 항목 3가지는 다음과 같습니다:

1. Keybindings (키 바인딩)

편집기에서 사용할 단축키 모드를 선택합니다.

• Normal: 일반적인 메모장이나 범용 코드 에디터 스타일의 표준 단축키 시스템을 사용합니다.

• Vim: 리눅스나 개발자들 사이에서 유명한 Vim 에디터의 조작 방식을 사용합니다. Vim 사용자가 아니라면 'Normal'을 선택하시는 것이 편합니다.

2. Extensions (확장 프로그램)

에이전트가 코드를 더 정확하게 이해하고 분석할 수 있도록 언어별 확장 기능을 설치하는 옵션입니다.

• 지원 언어: Python, Go, Java, C/C++, C#, PHP, Ruby 등 주요 프로그래밍 언어들이 포함되어 있습니다.

• 작동 방식: 체크박스가 선택된 언어들에 대해 관련 기능을 활성화합니다. 'Recommended(권장)' 버튼이 활성화되어 있어 에이전트 기능을 100% 활용하려면 기본적으로 모두 체크해 두는 것이 좋습니다.

3. Command Line (명령줄 도구)

터미널(콘솔) 환경에서 Antigravity를 더 편리하게 실행하기 위한 도구 설정입니다.

• 기능: agy라는 짧은 명령어를 터미널에 입력하는 것만으로 Antigravity를 즉시 실행할 수 있게 해주는 커맨드 라인 툴을 설치합니다.

• 설정: 'Install' 체크박스를 선택하면 설치가 진행됩니다.

팁: 본인의 개발 성향에 맞춰 설정한 후 하단의 'Next' 버튼을 눌러 다음 단계로 진행하시면 됩니다.

2.2.4 Google 계정으로 로그인하기 + 약관 동의하기

3. 인터페이스 및 주요 기능

프로그램 설치와 초기 설정을 마치면 Antigravity가 아래와 같은 기본 화면으로 실행됩니다. 로컬 폴더를 선택하기 전 화면과, 폴더를 선택한 후의 화면입니다.

Folder 선택 전

Folder 선택 후

3.1 인터페이스 5대 영역 소개

① 사이드 바 (Activity Bar)

화면 맨 왼쪽의 세로 아이콘 바입니다. Explorer, Search, Source Control, Run & Debug, Remote Explorer, Extensions 등 주요 기능 패널을 아이콘 클릭 하나로 전환할 수 있는 네비게이션 허브 역할을 합니다. VS Code와 동일한 구조라 익숙하게 사용할 수 있습니다.

(1) Explorer (파일 탐색기)

현재 작업 중인 프로젝트의 폴더와 파일 구조를 트리 형태로 보여줍니다. 새로운 파일을 생성하거나 삭제하고, 프로젝트 전체 구조를 한눈에 파악할 때 사용합니다. 폴더를 열거나(Open Folder) 저장소를 복제(Clone Repository)하는 시작점입니다.

Folder 선택 전

Outline(코드 구조 요약)과 Timeline(파일 변경 이력) 섹션도 함께 포함되어 있어 파일 탐색과 변경 추적을 한 곳에서 처리할 수 있습니다.

(2) Code Search (코드 검색)

프로젝트 내 모든 파일에서 특정 텍스트나 코드를 빠르게 찾아줍니다. 'Replace' 기능을 통해 검색된 내용을 일괄적으로 수정할 수 있으며, 대소문자 구분이나 정규식 검색 같은 고급 필터 기능을 지원하여 대규모 코드 수정 시 유용합니다.

(3) Source Control (소스 제어)

Git과 같은 버전 관리 시스템을 연결하여 코드의 변경 사항을 추적합니다. 변경된 파일 목록을 확인하고, 커밋(Commit), 푸시(Push), 풀(Pull) 등의 작업을 수행할 수 있습니다. Git 저장소가 담긴 폴더를 열거나 URL로 원격 저장소를 클론하는 것도 이 패널에서 바로 실행할 수 있습니다.

(4) Run and Debug (실행 및 디버그)

작성한 코드를 실제로 실행해보고, 오류를 찾기 위해 디버깅을 수행하는 곳입니다. 중단점(Breakpoint)을 설정하여 코드의 흐름을 단계별로 분석할 수 있으며, 변수의 값 변화를 실시간으로 모니터링하여 논리적 결함을 찾아내는 데 필수적입니다.

(5) Remote Explorer (원격 탐색기)

로컬 PC가 아닌 원격 서버, 컨테이너(Dev Containers), 또는 SSH로 연결된 외부 환경의 프로젝트를 관리합니다. 클라우드 환경이나 특정 개발 컨테이너 내에서 작업할 때 해당 환경의 파일 시스템과 리소스에 접근할 수 있게 해줍니다.

(6) Extensions (확장 프로그램)

Antigravity의 기능을 확장하는 플러그인들을 관리하는 마켓플레이스입니다. Python, Java 등 특정 언어 지원 도구부터 테마, 단축키 설정까지 사용자의 취향에 맞는 도구를 검색하고 설치할 수 있습니다. 에이전트의 분석 능력을 높여주는 언어별 익스텐션 설치가 여기서 이루어집니다.

Antigravity를 한국어로 사용하려면 "Korean Language Pack for Visual Studio Code" 확장 프로그램을 설치하세요.

② 사이드 패널 (Side Panel)

①번 액티비티 바에서 선택한 기능의 세부 내용이 표시되는 영역입니다. 예를 들어 Explorer를 선택하면 프로젝트 파일 트리가, Extensions를 선택하면 확장 마켓플레이스가 이곳에 펼쳐집니다. 작업 컨텍스트에 따라 내용이 동적으로 바뀝니다.

③ 에디터 뷰 (Editor View)

실제 코드를 작성하고 편집하는 메인 작업 공간입니다. VS Code 기반의 익숙한 코드 편집 환경을 제공하며, 에이전트가 생성한 파일도 이곳에서 확인하고 직접 수정할 수 있습니다. ⌘E로 Agent Manager 전환, ⌘L로 에이전트와 코드 작업, ⌘I로 인라인 편집이 가능합니다.

Folder 선택 전

'Open Folder'를 클릭한 뒤, 내 컴퓨터에서 새 폴더를 만들어 선택합니다. 저는 'Antigravity'라는 이름으로 새 폴더를 만든 후 그 폴더를 선택했습니다.

Antigravity 폴더에서 하위 폴더를 만들든, 로컬 폴더에서 하위 폴더를 만들든 모두 자동으로 동기화되는 것을 확인할 수 있습니다.

④ 에이전트 패널 (Agent Panel)

AI 에이전트에게 작업을 지시하고 대화하는 채팅 인터페이스입니다. 입력창 하단의 옵션들을 잘 활용하면 훨씬 정밀하게 에이전트를 제어할 수 있습니다.

(1) + 버튼 — Add context (컨텍스트 추가)

에이전트에게 추가 정보를 제공하는 버튼입니다. 클릭하면 3가지 옵션이 나타납니다.

• Media: 이미지 등 미디어 파일을 첨부하여 에이전트가 시각적 맥락을 이해할 수 있게 합니다

• Mentions: @ 기호와 동일한 기능으로, Files / Directories / Code Context Items / Rules / Terminal / Conversation / MCP Servers 등 다양한 컨텍스트를 에이전트에게 직접 참조시킬 수 있습니다

• Workflows: / 기호와 동일한 기능으로, 미리 정의된 워크플로우를 불러와 반복 작업을 자동화합니다

(2) Conversation Mode (대화 모드 선택)

에이전트가 작업을 처리하는 방식을 결정합니다. 두 가지 옵션이 있습니다.

1. Planning(플래닝) 모드

• 특징: 에이전트가 코드를 작성하기 전에 '구현 계획(Implementation Plan)'을 먼저 수립하고 사용자의 승인을 받은 뒤 실행하는 방식입니다. 작업을 여러 태스크 그룹과 하위 작업으로 세분화하여 관리합니다.

• 사용 시점: 복잡한 구조 변경, 대규모 리팩터링, 심층 리서치 등 시스템 전체에 영향을 줄 수 있는 중요한 작업에 사용합니다. 완성도를 높이고 작업 과정을 투명하게 관리해야 할 때 적합합니다.

2. Fast(패스트) 모드

• 특징: 계획 수립이나 승인 절차 없이 지시사항을 즉시 실행에 옮기는 모드입니다. 계획 단계가 생략되므로 작업 속도가 매우 빠르지만, 생성되는 아티팩트나 검증 과정은 상대적으로 간단합니다.

• 사용 시점: 버튼 색상 변경, 간단한 API 에러 핸들링 추가 등 가볍고 반복적인 작업을 빠르게 처리할 때 효율적입니다. 실패 리스크가 적고 즉각적인 결과 확인이 필요한 단순한 작업에 주로 사용합니다

(3) Model (모델 선택)

작업에 사용할 AI 모델을 선택합니다. 현재 6가지 모델을 지원합니다.

Model에 대한 Antigravity의 공식 설명은 아래 문서를 참고하세요.

https://antigravity.google/docs/models

Google Antigravity

Google Antigravity - Build the new way

https://antigravity.google

⑤ 상단 툴바 (Top Toolbar)

화면 우측 상단에 위치하며 Agent Manager 열기, 레이아웃 전환, 검색, 보안 설정, 전체 설정(Settings), 계정 정보 등 전역 기능 버튼들이 모여 있습니다. 특히 Open Agent Manager 버튼으로 에이전트 작업 전용 뷰로 즉시 전환할 수 있습니다.

마무리

Antigravity는 이제 개발자의 손을 거치는 단순한 도구가 아니라, 아이디어를 제품으로 이어주는 새로운 개발 파트너에 가깝습니다. 처음 설치와 온보딩, 모드 선택, 인터페이스 구조를 이해하는 과정이 다소 길게 느껴질 수 있지만, 한 번 익숙해지고 나면 에이전트와 협업하는 완전히 다른 개발 리듬을 경험하게 됩니다.

이 글이 Antigravity를 처음 접하는 분들께는 명확한 출발점이, 이미 사용 중인 분들께는 숨은 기능을 다시 정리하는 체크리스트가 되었기를 바랍니다. 이제 여러분의 워크스페이스에서 작은 실험부터 시작해 보세요. 작은 자동화 하나가, 앞으로의 개발 방식을 바꾸는 첫 걸음이 될 수 있습니다.