[Antigravity 2.0] 설치부터 첫 프로젝트까지

안녕하세요. 재아군의 관찰인생입니다.

 

Antigravity 시리즈 2편입니다. 1편에서 Antigravity 2.0을 독립형 AI 에이전트 운영 플랫폼으로 봐야 한다고 정리했습니다.

 

이번 글에서는 공식 Getting Started 문서를 바탕으로 Antigravity 시작 흐름을 정리합니다. 설치 요구사항, Project 생성, 에이전트 실행 모드, 기본 단축키와 Slash Command까지 처음 켜고 바로 확인해야 할 부분만 실무 관점으로 모았습니다.

 

핵심 요약: Antigravity 2.0은 먼저 Project로 접근 범위를 정하고, Local Mode 또는 New Worktree Mode를 선택해 에이전트를 실행하는 흐름으로 시작합니다.

1. 설치 전 요구사항 확인

공식 문서는 Antigravity 2.0 다운로드 위치를 antigravity.google/download로 안내합니다. 설치 전에는 운영체제 요구사항을 먼저 확인해야 합니다.

 

 

특히 macOS는 Apple 보안 업데이트 지원을 받는 버전을 전제로 하며, 문서상 최소 버전은 macOS 12 Monterey입니다. 또한 X86 Mac은 지원하지 않는다고 안내되어 있으므로 Apple Silicon 환경인지 확인하는 편이 좋습니다.

 

 

플랫폼	공식 문서 기준 요구사항	확인 포인트
macOS	macOS 12 Monterey 이상, X86 미지원	Apple Silicon 여부 확인
Windows	Windows 10 64-bit	권한, 보안 프로그램 차단 확인
Linux	glibc 2.28 이상, glibcxx 3.4.25 이상	Ubuntu 20, Debian 10, Fedora 36, RHEL 8 수준 확인

2. 설치 중 Replace 안내가 뜨는 경우

Getting Started 문서는 설치 중 Antigravity를 "Keep Both"로 둘지 "Replace"할지 묻는 알림이 나올 수 있다고 설명합니다. 이 경우에는 Replace를 선택하라고 안내합니다.

또 설치 과정에서 IDE 재설치 안내가 나올 수 있습니다. 지금 설치하지 않아도 나중에 다시 다운로드할 수 있으니, 처음에는 Antigravity 2.0 본체 설치와 Project 흐름을 먼저 익히는 것이 좋습니다.

 

설치 체크 순서
1. OS 요구사항 확인
2. antigravity.google/download에서 다운로드
3. 기존 Antigravity가 있으면 Replace 선택
4. IDE 설치 여부 선택
5. 첫 Project 생성으로 이동

3. Project는 에이전트의 작업 경계입니다

Antigravity에서 가장 먼저 이해해야 할 개념은 Project입니다. Project는 에이전트가 접근할 수 있는 폴더와 저장소의 경계를 정의합니다.

공식 문서 기준으로 Project에는 하나 이상의 로컬 폴더나 Git 저장소를 연결할 수 있습니다. 여러 폴더를 추가하면 에이전트가 여러 코드베이스를 같은 대화 맥락에서 다룰 수 있지만, 그만큼 접근 범위도 넓어집니다.

1. 왼쪽 사이드바에서 폴더와 플러스 아이콘을 클릭합니다.
2. "New Project"를 선택합니다.
3. "Add Folder"로 로컬 폴더나 Git 저장소를 연결합니다.
4. 필요한 폴더만 연결했는지 확인합니다.
5. "Create"로 Project를 생성합니다.
6. 선택 사항으로 Project별 설정과 보안 정책을 조정합니다.

실무 팁: 첫 Project에는 전체 홈 디렉터리나 회사 루트 폴더를 연결하지 마세요. 작은 샘플 저장소나 개인 프로젝트부터 연결해 권한 흐름을 확인하는 편이 안전합니다.

4. Local Mode와 New Worktree Mode 선택

Project를 만들고 나면 채팅 입력창에 목표를 쓰고 Enter를 눌러 에이전트를 시작할 수 있습니다. 이때 setup modal에서 실행 모드를 고르게 됩니다.

문서에 나온 기본 모드는 Local Mode와 New Worktree Mode입니다. 두 모드는 "어디에서 파일을 수정할 것인가"가 다릅니다.

모드	동작 방식	추천 상황
Local Mode	현재 연결된 폴더에서 직접 작업	읽기, 분석, 작은 수정, 개인 실험
New Worktree Mode	격리된 Git worktree에서 작업	기능 구현, 위험한 변경, 병렬 실험

현업에서는 처음부터 New Worktree Mode를 기본으로 생각하는 편이 좋습니다. 에이전트가 만든 변경을 검토하고 필요한 것만 병합할 수 있기 때문입니다.

5. 기본 단축키는 대화 전환 중심으로 익히기

Antigravity 2.0은 여러 Conversation과 Agent 작업을 오가게 됩니다. 그래서 파일 검색보다 먼저 대화 전환과 입력 포커스 단축키를 익히는 것이 좋습니다.

동작	macOS	Windows / Linux
Conversation Picker 열기	Command + K	Ctrl + K
File Search 열기	Command + P	Ctrl + P
입력창 포커스	Command + L	Ctrl + L
새 Conversation	Command + N	Ctrl + N
이전/다음 Conversation	Option + 위/아래	Alt + 위/아래

6. Slash Command는 에이전트의 태도를 바꿉니다

Getting Started 문서에는 네 가지 Slash Command가 소개되어 있습니다. 단순한 편의 명령이 아니라 에이전트가 얼마나 자율적으로 움직일지, 질문을 먼저 할지, 브라우저를 쓸지 같은 행동 방식을 바꿉니다.

명령어	역할	추천 사용처
/goal	중간 입력을 줄이고 목표 완료까지 실행	명확한 버그 수정, 반복 작업
/grill-me	구현 전 세부 질문으로 계획 정렬	요구사항이 모호한 기능
/schedule	미래 시점 또는 반복 일정으로 실행	정기 점검, 리포트, 모니터링
/browser	브라우저 기능을 명시적으로 사용	UI 확인, 웹 기반 디버깅

/browser는 Chrome과 권한 허용이 필요하다고 문서에 설명되어 있습니다. 따라서 처음에는 브라우저 없이 가능한 코드 분석이나 문서화 작업으로 시작하고, UI 확인이 필요한 시점에 명시적으로 사용하는 편이 좋습니다.

7. 첫 요청 프롬프트 예시

첫 요청은 너무 크지 않아야 합니다. 에이전트가 Project 구조를 파악하고, 사용자는 권한 요청과 산출물 품질을 확인해야 하기 때문입니다.

/grill-me
이 Project의 구조를 먼저 파악해줘.
파일을 수정하지 말고 다음 내용을 리포트로 정리해줘.

1. 주요 디렉터리 역할
2. 실행/테스트 명령 후보
3. 위험해 보이는 설정 파일
4. 다음에 맡기기 좋은 작은 작업 3개

/goal
New Worktree Mode에서 작업해줘.
README의 실행 방법과 package.json scripts가 맞는지 비교하고,
불일치가 있으면 문서만 수정해줘.
코드 동작은 바꾸지 말고 마지막에 변경 요약을 알려줘.

마무리: 시작은 작게, 경계는 분명하게

Antigravity 시작의 핵심은 설치보다 Project 경계 설정입니다. 어떤 폴더를 연결할지, Local Mode를 쓸지 Worktree를 쓸지, 어떤 명령을 허용할지 결정하는 순간부터 에이전트의 작업 품질과 안전성이 갈립니다.

 

처음에는 작은 Project, 읽기 중심 요청, New Worktree Mode, /grill-me 조합으로 시작해보세요. 에이전트의 질문과 계획을 본 뒤 작업 범위를 넓히면 훨씬 덜 불안하고 훨씬 더 정확하게 쓸 수 있습니다.

 

참고 자료

• Google Antigravity Docs: Getting Started
• Google Antigravity Docs: Overview