안티그래비티(Antigravity) 설치가이드

대상: Windows 10/11 노트북 · 터미널을 처음 열어 보는 분
작성일 기준: 2026-08-01 (공식 다운로드 페이지 antigravity.google/download 확인)
확인한 버전: Antigravity 2.0 = v2.4.3 / Antigravity IDE = v2.1.1 / Antigravity CLI = v1.1.9

⚡ 빠른 설치 — 아는 분용 (약 15분)

준비물: 실습용 개인 @gmail.com 계정, 크롬, 여유 공간 3GB, 바탕 화면 AX실습 폴더.

① 내 CPU 종류 확인 — Windows 키 + R 을 누르고 붙여넣기

ms-settings:about

② 다운로드 — 크롬 주소창에 붙여넣고 맨 위 Antigravity 2.0 → Windows → x64(또는 ARM64)

https://antigravity.google/download

③ 설치 — 받은 .exe 실행 → SmartScreen 경고 시 추가 정보 → 실행 → 예 → 기본값으로 다음·설치·마침

④ 로그인·폴더 지정 — 앱 실행 → Sign in with Google → 수업용 개인 구글 계정(실습 전용) 선택 → 권한 목록 읽고 허용 → Select Project → New Project → Add Folder 에 붙여넣기

%USERPROFILE%\Desktop\AX실습

⑤ 확인 — 입력창에 붙여넣고 Enter

AX실습 폴더에 어떤 파일이 있는지 목록으로 보여줘.

여기까지 됐으면 끝입니다. 막히거나 처음이시면 아래 상세 절차로 내려가세요.

1. 이 도구는 무엇인가

안티그래비티는 구글이 만든 에이전트 작업 환경입니다. 한 줄씩 지시하는 대신 "이 폴더의 문서들을 읽고 쟁점을 정리해 줘"처럼 목표를 말하면 AI가 여러 단계를 스스로 나눠서 수행하고, 그 과정과 결과물을 화면에 남깁니다.

법률 업무 예시: AX실습 폴더에 가상 임대차 계약서 3건을 넣고 "세 계약서의 차임 인상 조항을 비교해 표로 정리해 줘"라고 요청하면, 파일을 하나씩 읽고 비교표 문서를 만들어 폴더에 저장합니다.

이 가이드는 무료 데스크톱 앱 Antigravity 2.0 기준입니다. 다운로드 페이지에 네 가지가 있으니 맨 위 하나만 받으세요.

이름	무엇인가	우리 교육에서
Antigravity 2.0	에이전트에게 일을 시키고 결과를 모아 보는 데스크톱 앱	← 이걸 설치합니다
Antigravity IDE	코드를 직접 쓰는 개발자용 편집기	설치 안 함
Antigravity CLI	검은 터미널 화면 전용 버전	설치 안 함
Antigravity SDK	파이썬으로 에이전트를 만드는 개발 키트	설치 안 함

⚠️ 보안 안내 (이 문서 전체에 적용)

• 실제 사건 파일이 있는 폴더를 열지 마세요. AX실습 폴더만 사용합니다.
• 회사 보안 프로그램(백신·DLP·매체제어)이 막으면 절대 임의로 끄지 말고 전산·보안 담당자에게 문의하세요. 임의 해제는 그 자체가 사고입니다.
• API 키·비밀번호는 문서·메모·카카오톡·메일에 붙여넣지 마세요. 화면에서 바로 입력하고 "어디에 보관했는지"만 적어 둡니다.
• 회사 노트북 설치 정책이 있다면 그 정책이 이 가이드보다 우선합니다.

2. 설치 전 확인

하나라도 비어 있으면 설치 도중 막힙니다.

• Windows 10 (64비트) 이상
• 여유 저장 공간 3GB 이상
• 내 CPU가 x64인지 ARM64인지 확인 (아래 2-1)
• 실습용 개인 @gmail.com 계정 — 회사 Workspace 계정은 로그인이 거부되는 경우가 많습니다. 실습 전용 계정을 새로 만드시길 권합니다.
• 만 18세 이상 — 대한민국은 서비스 제공 국가입니다.
• 크롬 브라우저 — 없으면 주소창에 붙여넣어 먼저 설치

https://www.google.com/chrome

• 바탕 화면에 AX실습 폴더 — 폴더 이름으로 이 텍스트를 붙여넣으세요

AX실습

2-1. 내 CPU가 x64인지 ARM64인지 확인

Windows 키 + R 을 누르고 아래를 붙여넣은 뒤 Enter.

ms-settings:about

3. 설치 절차

1단계 — 다운로드 페이지 열기

크롬 주소창에 아래를 붙여넣고 Enter.

https://antigravity.google/download

2단계 — Windows 설치 파일 받기

맨 위 Antigravity 2.0 카드의 Windows 줄에서 2-1에서 확인한 x64 또는 ARM64 버튼을 클릭합니다.

3단계 — 설치 파일 실행

크롬 오른쪽 위 다운로드 아이콘(↓) → 방금 받은 파일 이름을 클릭합니다.

추가 정보 → 실행 을 클릭합니다.

⚠️ 이 우회는 antigravity.google 에서 직접 받은 파일일 때만 하세요. 다른 경로로 받은 파일이면 실행하지 말고 삭제합니다.

4단계 — 권한 승인하고 마치기

"이 앱이 디바이스를 변경할 수 있도록 허용하시겠어요?" 창에서 예 → 마법사에서 기본값 그대로 다음 → 설치 → 마침.

관리자 권한이 필요한 이유: 프로그램을 아래 경로에 설치하고 시작 메뉴에 등록하기 위해서입니다. 이 단계 외에는 관리자 권한이 필요 없습니다.

탐색기 주소창에 붙여넣기복사

%LOCALAPPDATA%\Programs\Antigravity

4. 설치 확인 (30초)

시작 버튼을 누르고 아래를 입력한 뒤 Enter.

Antigravity

5. 초기 설정·연동 (구글 계정 연결)

이 절이 가장 중요합니다. 화면의 권한 문구를 읽고 승인하세요.

5-1. 실습용 계정으로 로그인

Sign in with Google 을 클릭합니다.

여기서 반드시 수업용 개인 구글 계정(실습 전용으로 새로 만든 계정)을 고릅니다. 회사 계정으로 로그인되어 있으면 다른 계정 사용 을 눌러 바꾸세요. 잘못 고르면 이후 만드는 문서와 대화 기록이 업무 계정에 남습니다.

5-2. 권한 화면 — 읽고 승인

바로 누르지 말고 한 줄씩 읽으세요. 여기서 승인하는 것은 "이 프로그램이 내 구글 계정으로 무엇을 할 수 있는가"입니다.

확인했으면 계속/허용 을 클릭합니다.

🔐 API 키를 요구하는 화면은 나오지 않습니다. 구글 계정 로그인만으로 인증이 끝납니다. 키를 요구하는 화면이 뜨면 공식 앱이 아닐 수 있으니 멈추고 강사에게 확인하세요.

5-3. 첫 실행 설정 넘기기

순서대로 나오는 네 화면입니다.

1. 보안 및 데이터 정책 안내 → Next
2. 테마 선택 → 아무거나
3. 플러그인 설치 제안 → 체크 해제하고 넘어갑니다
4. Finish → 메인 화면

💡 데이터 수집 끄기 (권장): 구글은 사용 기록을 학습·분석에 쓰며, 설정(Settings) 패널에서 언제든 해제할 수 있다고 안내합니다. 로그인 후 설정에 들어가 이 항목을 꺼 두시길 권합니다.

5-4. 작업 폴더 지정 — 실습 폴더만

메인 화면에서 Select Project → New Project → Add Folder 를 클릭합니다.

폴더 선택 창의 주소 입력란에 아래를 붙여넣고 Enter.

%USERPROFILE%\Desktop\AX실습

프로젝트 이름 입력란에 아래를 붙여넣고 생성합니다.

AX실습

💡 위 경로에서 "폴더를 찾을 수 없다"고 나오면 OneDrive가 바탕 화면을 대신 관리하는 경우입니다. 아래를 대신 붙여넣으세요.

탐색기 주소창에 붙여넣기복사

%OneDrive%\Desktop\AX실습

⚠️ 절대 추가하지 말 것: 내 문서, 바탕 화면 전체, 사건 자료가 든 공유 드라이브 폴더. 에이전트는 추가된 폴더의 파일을 읽고 수정할 수 있습니다.

6. 첫 동작 테스트 (1분)

가상 정보로만 진행합니다. 실제 사건 내용은 입력하지 마세요.

메모장을 열어 아래를 붙여넣고 AX실습 폴더에 가상계약서.txt 로 저장합니다.

임대차계약서(가상)
임대인: 홍길동 / 임차인: 김철수
소재지: 서울시 가상구 예시로 1
보증금: 5,000만원 / 차임: 월 100만원
계약기간: 2026-01-01 ~ 2027-12-31
특약: 임대인은 매년 차임을 5% 인상할 수 있다.

안티그래비티 화면 아래 입력창에 아래를 붙여넣고 Enter.

AX실습 폴더의 가상계약서.txt 를 읽고, 임차인에게 불리할 수 있는 조항을 3가지로 정리해서 화면에 보여줘.

7. 문제 해결

증상 1 — Microsoft Defender SmartScreen에서 인식할 수 없는 앱의 시작을 차단했습니다.

• 원인: 다운로드 수가 적은 새 설치 파일에 대한 윈도우 기본 경고. 바이러스라는 뜻이 아닙니다.
• 해결: antigravity.google/download 에서 직접 받았는지 확인한 뒤 추가 정보 → 실행. 출처가 불확실하면 삭제하세요. 회사 백신이 차단한 경우라면 끄지 말고 담당자에게 문의합니다.

증상 2 — Your account is not eligible to use Antigravity

• 원인: ① 회사 Workspace 계정 로그인(관리자가 AI 기능 차단), ② 만 18세 미만 또는 연령 미확인, ③ 계정 국가 설정이 미지원 지역.
• 해결: 개인 @gmail.com 계정으로 로그아웃 후 재로그인. 그래도 안 되면 구글 계정에서 연령 확인을 완료하거나 국가 설정을 확인합니다. 회사 계정 차단은 개인이 풀 수 없으니 실습 계정으로 진행하세요.

증상 3 — 브라우저에서는 로그인됐는데 앱은 그대로 로그인 화면

• 원인: 기본 브라우저가 크롬이 아니거나, 보안 프로그램이 앱 간 연결을 차단.
• 해결: Windows 키 + R 에 아래를 붙여넣어 기본 브라우저를 Chrome 으로 바꾼 뒤, 앱을 완전히 종료하고 다시 로그인합니다. 브라우저에 "Open Antigravity" 링크가 보이면 그것을 클릭하세요.

ms-settings:defaultapps

증상 4 — 앱이 실행되자마자 꺼짐 / 창이 하얗게만 나옴

• 원인: 설치가 중간에 끊겼거나 이전 설정 파일이 깨진 경우.
• 해결: ① 재부팅. ② 제거(8절) 후 설치 파일을 다시 받아서 설치. ③ 그래도 같으면 파일 탐색기 주소창에 아래를 붙여넣고 Antigravity 폴더를 다른 곳으로 옮긴 뒤(삭제 대신 이동) 앱을 다시 실행합니다.

%APPDATA%

증상 5 — 에이전트가 실습 폴더 밖의 파일을 건드리려고 함

• 원인: 프로젝트에 상위 폴더(바탕 화면 전체 등)가 추가되어 있습니다.
• 해결: 즉시 Stop 을 누르고 프로젝트 설정에서 AX실습 외 폴더를 모두 제거합니다. 실제 사건 파일이 열린 정황이 있으면 강사와 소속 정보보호 담당자에게 알리세요.

8. 제거·연동 해제

프로그램만 지우면 구글 계정에 준 권한은 남습니다. 권한 회수(8-3)까지 하세요.

8-1. 프로그램 제거

Windows 키 + R 에 아래를 붙여넣고 Enter.

ms-settings:appsfeatures

검색창에 아래를 붙여넣고, 오른쪽 ⋯ → 제거 → 확인.

Antigravity

8-2. 남은 설정·기록 삭제 (선택)

파일 탐색기 주소창에 한 줄씩 붙여넣어 열고, 아래 폴더를 삭제합니다.

%APPDATA%\Antigravity

%USERPROFILE%\.antigravity

%LOCALAPPDATA%\Programs\Antigravity

8-3. 구글 계정 권한 회수 (중요)

실습 계정으로 로그인된 크롬에서 주소창에 아래를 붙여넣고 Enter.

https://myaccount.google.com/connections

목록에서 Antigravity 클릭 → 모든 연결 삭제 / 액세스 권한 삭제.

8-4. 실습 폴더 정리

바탕 화면\AX실습 에서 남길 결과물만 옮기고 나머지는 삭제합니다. 실제 사건 정보를 입력한 적이 있다면 해당 파일과 대화 기록을 반드시 삭제하세요.

막히면: 화면을 그대로 캡처(Windows 키 + Shift + S)해 강사 또는 Facilitator에게 보내세요. 오류 메시지는 요약하지 말고 글자 그대로 전달하는 것이 가장 빠릅니다.