구글 안티그래비티 (Google Antigravity) 이해하기

🤔 구글에서 코딩 에이전트를 쓰려면 어디로 가야 하는지 헷갈릴 때

구글의 코딩 도구를 찾으면 제미나이 앱, 제미나이 CLI, AI 스튜디오, Gemini Code Assist, 안티그래비티가 한꺼번에 나옵니다. 구글은 개인용 제미나이 CLI 지원 종료 안내에서 2026년 6월 18일을 기준으로 개인 무료 및 Google AI Pro/Ultra 경로의 전환을 안내합니다. 기업 라이선스나 유료 API 경로는 구분해야 합니다. 개인 사용자는 안티그래비티의 이용 조건을 먼저 확인하면 됩니다.

지금부터 안티그래비티가 무엇인지, 데스크톱 앱과 CLI와 편집기 확장은 어떻게 다른지, 무료로 어디까지 쓰는지, 다른 코딩 에이전트와 무엇이 다른지 정리합니다. 메뉴와 이용 조건은 바뀔 수 있으므로 실제 설치된 제품과 계정의 설정을 함께 확인합니다.

🔑 구글 안티그래비티의 정의

구글 안티그래비티(Google Antigravity)는 여러 AI 에이전트에게 코딩과 조사 작업을 맡기고 그 진행을 관리하는 구글의 에이전트 중심 개발 프로그램입니다.

구글은 코드를 편집하는 화면뿐 아니라 에이전트의 작업을 관리하고 검토하는 화면을 함께 제공합니다.

에이전트가 할 수 있는 일은 공식 문서 기준으로 이렇습니다.

• 시스템 명령을 실행하고 파일을 읽고 씁니다
• 웹을 검색하고 크롬 브라우저를 조작합니다
• 재사용하는 작업 지침인 스킬과 외부 도구 연결에 쓰는 MCP 서버를 씁니다
• 하위 에이전트에게 일을 나눠 맡깁니다
• 구현 계획 같은 아티팩트를 만들어 사람에게 보여 줍니다

파일을 읽고 고치고 명령을 실행한다는 점에서 코딩 에이전트의 한 종류이지만, 에이전트 여럿을 띄우고 지켜보는 관리 화면을 처음부터 중심에 둔 것이 특징입니다.

🧩 안티그래비티의 네 가지 형태

같은 안티그래비티라도 실행하는 형태가 다릅니다. 아래에서 자신이 쓸 화면 하나를 고르면 됩니다.

이 글의 첫 연습은 2.0 데스크톱 앱을 기준으로 합니다. 모든 형태를 설치할 필요는 없습니다. 이미 쓰는 편집기나 터미널이 있다면 해당 형태의 공식 안내를 확인합니다. 터미널형, IDE형, 브라우저형 비교에서 화면 차이를 먼저 볼 수도 있습니다.

📁 프로젝트와 작업 방식

프로젝트(Project)는 함께 사용할 폴더, 설정과 대화 기록을 묶는 단위입니다. 처음에는 연습용 폴더 하나만 추가합니다. 작업 시작 방식에 따라 수정되는 실제 파일 위치가 달라집니다.

• Local Mode: 추가한 폴더의 파일을 직접 수정합니다.
• New Worktree Mode: Git 저장소에 별도 작업 폴더를 만들어 수정합니다.

Git은 파일의 변경 기록을 관리하는 도구이고, 워크트리는 그 기록을 기준으로 만든 별도 작업 폴더입니다. 프로젝트에 Git을 쓰지 않는 일반 폴더가 함께 있으면 New Worktree Mode에서도 그 일반 폴더는 기존 위치를 사용할 수 있습니다. 모든 파일이 복사되어 분리된다고 생각하지 말고 실제 작업 경로를 확인합니다.

프로젝트의 폴더 설정만으로 컴퓨터의 모든 접근과 외부 서비스 동작이 제한되는 것은 아닙니다. Permissions는 파일 읽기, 쓰기와 명령 실행 등을 허용할지 정하는 권한 설정입니다. 운영체제, 전체 설정과 프로젝트 설정에 따라 동작이 달라지며, 허용된 작업은 매번 묻지 않고 실행될 수 있습니다. 워크트리 구분과 권한 제한은 별개입니다.

📄 아티팩트: 에이전트가 사람에게 보여 주는 결과물

안티그래비티에서 자주 보게 되는 말이 아티팩트(Artifact)입니다. 공식 문서는 아티팩트를 에이전트가 작업을 해내면서 진행 상황과 제안 내용을 사람에게 보여 주려고 만드는 결과물이라고 정의합니다.

• 구현 계획: 무엇을 어떤 순서로 고칠지 적은 문서
• 코드 변경 내역: 어느 파일의 어느 줄이 바뀌었는지
• 구조 그림과 이미지: 프로그램 구조 그림이나 화면 시안
• 브라우저 녹화: 에이전트가 브라우저에서 한 일을 담은 영상

아티팩트가 쓸모 있는 이유는 방향을 일찍 바로잡을 수 있어서입니다. 구현 계획이 원하는 것과 다르면 파일을 고치기 전에 계획에 피드백을 남겨 방향을 바꿉니다. 2.0 앱에서 실행 전에 계획을 확인하려면 Planning 모드와 아티팩트 검토 정책 Request review를 확인합니다. Fast 모드는 별도 계획 단계 없이 실행하고, Always proceed 정책은 계획 검토를 기다리지 않고 진행합니다. 계획 검토 정책은 파일이나 명령의 실행 권한을 정하는 Permissions와 다릅니다.

본문에 나온 아티팩트 유형을 확인 목적별로 정리했습니다. 실제 안티그래비티 화면이나 실행 기록은 아닙니다.

🌐 브라우저 제어

안티그래비티 에이전트는 내 컴퓨터의 크롬을 열어 페이지를 읽고 누를 수 있습니다. 공식 문서가 드는 용도는 개발 중인 사이트를 직접 열어 확인하는 일, 문서를 찾아 읽는 일, 브라우저 작업 자동화입니다.

IDE의 브라우저 기능은 평소 쓰는 크롬과 별도 프로필을 사용합니다. 프로필은 로그인과 방문 정보를 따로 보관하는 공간입니다. 이 별도 프로필에 로그인한 계정은 다음 실행에도 남을 수 있으므로 개인 정보에 전혀 접근하지 않는다는 뜻은 아닙니다.

방문할 주소와 클릭 등 실행 권한을 확인합니다. 2.0에서는 /browser로 브라우저 작업을 요청할 수 있지만, 필요한 연결과 권한은 실제 화면에서 확인해야 합니다. 첫 파일 연습에는 브라우저 조작이 필요하지 않습니다.

💳 요금과 모델

공식 요금 안내는 개인 무료 요금제와 Google AI Pro 및 Ultra를 구분합니다. 무료도 에이전트 사용 한도가 있고, 유료도 무제한은 아닙니다.

요청 한 번의 작업량은 파일 크기와 실행 단계 등에 따라 달라집니다. 짧은 요청 몇 번을 보냈는지만으로 남은 작업 횟수를 계산할 수는 없습니다. 포함 사용량과 추가 크레딧은 구분하고, AI Credit Overages 설정이 추가 크레딧을 자동 사용하도록 되어 있는지도 확인합니다.

API 키는 프로그램의 AI 요청에 쓰는 인증 정보입니다. 개인 요금제에서 자신의 API 키를 넣어 기본 한도를 늘리는 방식은 지원하지 않는다고 안내합니다. 기업용 이용 조건은 별도 문서와 관리자의 설정을 봅니다. 요금과 한도 비교에서 비용 확인 순서를 이어서 볼 수 있습니다.

💻 지원 운영체제

공식 다운로드에서 사용할 제품, 운영체제와 컴퓨터의 프로세서 종류에 맞는 파일 및 요구 사항을 확인합니다. 맥, 윈도우와 리눅스에서 제공하지만 같은 최소 버전과 기능이 모든 형태에 적용되는 것은 아닙니다. 이미 설치했다면 재설치보다 현재 제품 이름과 버전을 먼저 확인합니다. 화면을 보며 시작하려면 안티그래비티 가이드를 참고합니다.

⚠️ 자주 하는 실수

• 제미나이 CLI 설정이 전부 옮겨졌다고 생각합니다: 첫 실행의 가져오기 기능이 있어도 모든 설정을 이전하지는 않습니다. 제미나이 CLI 설명의 확인 순서로 규칙과 도구를 따로 점검합니다.
• 프로젝트에 폴더를 너무 넓게 넣습니다: 필요한 연습 폴더만 넣고 설정에서 적용 중인 권한을 확인합니다.
• 계획을 고치기 전에 진행합니다: 계획의 대상 파일과 변경 내용을 읽고 요청 범위를 벗어난 부분을 먼저 수정합니다.
• 설명만 보고 완료로 판단합니다: 작업 요약뿐 아니라 변경 비교와 실제 파일을 엽니다.

❓ 자주 묻는 질문

안티그래비티는 무료로 쓸 수 있나요?

개인 무료 요금제가 있지만 사용 한도가 있습니다. 실제 계정에서 이용 가능 여부, 모델과 남은 한도를 확인합니다. 회사 계정은 개인 구독과 조건이 다를 수 있습니다.

오르카와 안티그래비티는 무엇이 다른가요?

둘 다 에이전트 여럿을 한 화면에서 관리하지만, 오르카는 이미 설치한 클로드 코드나 코덱스를 불러와 관리하고 안티그래비티는 구글이 에이전트와 모델을 함께 제공합니다. 오르카의 비용은 연결한 에이전트의 구독이나 API 인증 방식에 따라 달라집니다. 안티그래비티는 로그인한 계정의 개인 또는 기업 이용 조건을 확인합니다.

답변이 계속 영어로 나오면 어떻게 하나요?

먼저 현재 대화에 “설명과 답변은 한국어로 작성해 줘”라고 적습니다. 매번 적용하려면 사용하는 제품의 규칙 설정을 확인합니다. 다른 범위의 규칙과 충돌하는지 보고 짧은 새 요청에서 한국어 응답이 나오는지 확인합니다. 화면 메뉴의 언어와 답변 언어는 별개입니다.

공지의 장소 한 줄 바꾸기

아직 설치하지 않았다면 아래 원문과 요청을 읽고 장소만 바뀐 결과를 메모장에 직접 써 봅니다. 실제 앱 연습은 공식 안내에 따라 설치와 로그인이 끝난 뒤 진행합니다. 컴퓨터에 antigravity-practice 폴더를 만들고 notice.txt를 저장합니다. 일반 텍스트 파일의 내용은 아래 두 줄입니다.

2.0 앱에서 폴더의 + 아이콘을 누르고 New Project → Add Folder로 이 폴더만 추가한 뒤 Create를 누릅니다. 첫 연습은 Git 없이 Local Mode로 진행하므로 이 연습 파일이 직접 바뀝니다. Planning 모드와 아티팩트의 Request review 정책을 확인한 뒤 요청합니다. 먼저 한 에이전트로 시작하고 다른 파일이나 명령의 승인을 요청하면 대상과 필요성을 읽습니다.

notice.txt의 행사 장소만 3층 회의실로 바꾸려고 해. 먼저 수정 계획을 한국어로 보여 주고 검토를 기다려 줘. 날짜와 다른 파일은 바꾸지 마. 이메일 발송이나 사이트 게시도 하지 마.

계획에 날짜 변경이나 새 웹사이트 제작이 들어갔다면 “장소 한 줄만 수정하도록 계획을 고쳐 줘”라고 피드백합니다. 수정 계획이 맞으면 해당 파일 수정을 진행하도록 요청합니다.

결과 파일의 날짜가 10월 15일, 장소가 3층 회의실인지 직접 확인합니다. 설명에는 3층이라고 쓰여 있지만 파일은 2층이라면 저장한 파일의 경로와 변경 내용을 확인해 달라고 요청합니다.

다시 연습할 때는 장소만 4층 회의실로 바꿉니다. 변경 비교에서 장소 한 줄만 달라졌고 직접 연 파일에도 반영됐는지 확인하면 됩니다. 메뉴가 다르면 다른 형태의 제품을 열었는지와 버전을 확인한 뒤 해당 공식 안내로 돌아갑니다.

📋 3줄 요약

1. 안티그래비티는 에이전트에게 파일 수정과 조사 작업을 맡기고 결과를 검토하는 구글의 도구입니다.

2. 첫 작업은 연습 폴더 하나에서 계획을 확인하고 실제 파일과 변경 내용을 비교합니다.

3. 작업 폴더, 계획 검토 정책, 도구 실행 권한과 사용 한도를 각각 확인합니다.

참고 자료

• 제품별 시작 방법
• 프로젝트와 작업 폴더
• 파일 및 실행 권한
• 아티팩트와 피드백
• 계획 검토 정책
• 별도 브라우저 프로필
• 모델 이용 범위
• 요금제와 추가 크레딧

공식 안내 확인: 2026년 10월 3일. 공지 내용은 가상 예제입니다.