구글 안티그래비티 시작하기: 모델 선택부터 첫 파일 확인까지
안티그래비티가 어떤 프로그램인지 이해하고 가상 회의 메모로 첫 작업을 연습합니다. 모델 선택, 무료 사용량과 권한을 확인한 뒤 생성된 파일을 직접 열어 검증하는 방법을 설명합니다.
목차
세 줄로 먼저 읽기
이번 방문에서 한 편은 바로 볼 수 있습니다.
구글 안티그래비티(Google Antigravity)는 AI에 지시해 컴퓨터의 파일을 읽고 수정하거나 명령을 실행하게 하는 프로그램입니다. 채팅창에서 설명을 받는 데서 더 나아가, 실제 파일이 바뀔 수 있습니다. 처음에는 업무 원본 대신 연습용 메모 한 개로 시작하면 결과를 확인하기 쉽습니다.
이 글에서는 데스크톱 프로그램으로 메모를 요약하는 과정을 따라갑니다. 모델과 요금제 설명은 2026년 10월 4일 공식 문서를 기준으로 하며, 설치 시점의 화면과 제공 조건은 달라질 수 있습니다.
모델과 에이전트, 프로그램은 어떻게 다른가요?
모델은 지시를 해석하고 답을 만드는 AI입니다. Gemini나 Claude가 여기에 해당합니다. 에이전트는 모델을 이용하면서 파일 읽기, 수정, 명령 실행 같은 도구를 써서 일을 진행합니다. 안티그래비티는 이 에이전트에게 지시하고 진행 상황과 변경 사항을 확인하는 프로그램입니다.
안티그래비티 2.0 데스크톱 앱은 편집기를 따로 열지 않고 쓸 수 있습니다. 한편 코드를 편집하는 Antigravity IDE도 별도 제품으로 제공됩니다. 따라서 안티그래비티라는 이름만으로 어느 화면을 뜻하는지 판단하기보다 제품 형태를 함께 확인해야 합니다. 공식 제품 개요
| 형태 | 어디에서 쓰나요? | 처음 고를 때의 기준 |
|---|---|---|
| Antigravity 2.0 데스크톱 | 설치한 앱의 화면 | 이 글의 첫 연습에 사용 |
| Antigravity CLI | 터미널에서 agy 명령 실행 | 명령을 입력하는 환경에 익숙한 경우 |
| Antigravity IDE 또는 편집기 확장 | 코드 편집기 | 기존 코드와 에이전트 작업을 함께 보는 경우 |
CLI는 문자를 입력해 프로그램을 조작하는 방식이고, IDE는 코드 작성과 실행을 돕는 통합 개발 환경입니다. 세 가지를 모두 설치할 필요는 없습니다. 공식 다운로드에서 제품 이름과 운영체제를 맞춰 고릅니다.
위 화면은 기존 버전의 예시입니다. 입력창과 모델 선택 위치를 이해하는 데 참고하되, 화면 속 모델 이름이 지금도 제공된다는 뜻으로 읽지 않습니다.
첫 작업: 메모를 요약한 파일 만들기
1. 연습 폴더와 원문을 준비합니다
컴퓨터에 antigravity-practice라는 새 폴더를 만듭니다. 메모장 같은 텍스트 편집기에서 아래 내용을 meeting.txt로 저장합니다. Mac 텍스트 편집기를 쓴다면 일반 텍스트 형식으로 저장하고, 실제 파일 이름이 meeting.txt.rtf처럼 바뀌지 않았는지 봅니다. Windows에서 확장자가 안 보이면 탐색기의 파일 확장명 표시를 켜서 meeting.txt.txt로 저장되지 않았는지도 확인합니다.
행사 안내 회의
행사일: 2026년 10월 20일
할 일: 안내문 초안 작성
마감일: 2026년 10월 10일
담당자: 아직 정하지 않음실제 고객명이나 회사 자료를 넣을 필요는 없습니다. 이 연습의 목표는 짧은 원문을 정확하게 읽고 결과 파일을 만드는지 확인하는 것입니다.
2. 앱에서 폴더를 프로젝트로 추가합니다
공식 다운로드에서 운영체제에 맞는 Antigravity 2.0 앱을 설치하고 화면에 따라 로그인합니다. 설치 조건이 맞지 않거나 회사 계정으로 이용이 제한되면 오류 문구와 공식 지원 조건을 먼저 확인합니다.
왼쪽의 폴더 추가 아이콘에서 New Project를 고르고, Add Folder로 방금 만든 폴더를 지정한 뒤 Create를 누릅니다. 프로젝트는 작업할 폴더를 묶어 관리하는 단위입니다. 처음에는 이 폴더 하나만 추가합니다. 시작 안내
작업 방식은 Local을 고릅니다. 이는 지정한 실제 폴더에서 작업한다는 뜻입니다. New Worktree는 Git이라는 변경 이력 관리 도구를 쓰는 프로젝트에서 작업용 폴더를 따로 만드는 방식이므로 이번 메모 연습에는 필요하지 않습니다.
프로젝트 지정만으로 모든 접근이 차단되는 것은 아닙니다. 실제 권한은 설정에 따라 달라집니다. 허용 요청이 나오면 대상 파일과 실행할 작업을 읽고 이번 연습에 필요한지 판단합니다. 파일 읽기 요청인지 터미널 명령 실행 요청인지도 구분합니다. 연습과 관계없는 폴더나 외부 서비스 접근은 거절하고 필요한 이유를 물어봅니다. 광범위한 접근을 허용하는 Turbo 같은 설정으로 바꿀 필요는 없습니다. 권한 안내
3. 지시를 보내고 결과를 엽니다
입력창 아래에서 사용 가능한 Gemini 모델 하나를 고릅니다. 처음부터 여러 에이전트나 예약 작업을 만들지 않아도 됩니다. 실행 전에 계정의 남은 할당량을 보고, Pro나 Ultra라면 아래 「무료 사용과 추가 비용」에서 설명하는 추가 크레딧 설정도 확인합니다. 이번 연습에 추가 크레딧을 쓰지 않으려면 Never로 둡니다. 다음 지시를 보냅니다.
한국어로 작업해 줘.
이 프로젝트의 meeting.txt를 읽고 summary.txt를 만들어 줘.
행사일, 할 일과 마감일, 담당자라는 세 항목으로 정리해 줘.
원문에 없는 정보는 추측하지 말고, 담당자는 미정이라고 써 줘.
meeting.txt는 변경하지 마. 완료 후 저장한 파일 경로를 알려 줘.AI가 끝났다고 답하면 탐색기나 Finder에서 antigravity-practice 폴더를 열고 summary.txt를 직접 엽니다. 표현은 달라도 다음 정보가 있어야 합니다.
행사일: 2026년 10월 20일
할 일과 마감일: 안내문 초안 작성, 2026년 10월 10일까지
담당자: 미정행사일과 초안 마감일이 바뀌지 않았는지, 담당자를 임의로 정하지 않았는지 확인합니다. meeting.txt도 다시 열어 원문이 그대로 남았는지 봅니다. 완료 답변과 실제 파일 확인은 별개입니다.
4. 한 가지를 바꿔 다시 해 봅니다
직접 meeting.txt의 행사일만 10월 21일로 바꾸고 저장한 뒤 다시 열어 21일로 바뀌었는지 확인합니다. AI에 “원문을 다시 읽고 summary.txt의 행사일을 갱신해 줘”라고 요청합니다. 결과 파일에서 행사일은 21일, 마감일은 10일, 담당자는 미정으로 남아 있으면 이번 연습을 마친 것입니다.
| 막힌 상황 | 확인할 곳 | 다음 행동 |
|---|---|---|
meeting.txt를 못 찾는다고 함 | 프로젝트 폴더와 실제 파일 확장자 | 파일 위치를 맞추고 다시 읽도록 요청 |
| 답변만 있고 파일이 없음 | 완료 답변의 저장 경로와 폴더 | “summary.txt로 실제 저장하고 경로를 알려 줘”라고 요청 |
| 날짜가 틀리거나 담당자를 만들어 냄 | 원문과 결과를 나란히 비교 | 틀린 항목을 짚고 원문만 사용해 수정하도록 요청 |
| 권한 요청이 나옴 | 접근 대상과 작업 내용 | 연습 폴더의 필요한 작업인지 확인 후 처리 |
| 사용량 한도 안내가 나옴 | 계정의 할당량과 갱신 시간 | 작업을 멈추고 안내된 갱신 시간을 확인 |
Claude나 GPT 모델도 고를 수 있나요?
가능하지만 요금제와 시점에 따라 목록이 다릅니다. 안티그래비티 안에서 Claude 모델을 고르는 것은 Claude Code 프로그램을 실행하거나 그 구독권을 받는 것과 다릅니다. GPT-OSS 역시 ChatGPT의 모든 모델과 같은 뜻이 아닙니다.
위 이미지는 이전 모델 표입니다. 현재 제공 여부는 아래 설명과 공식 모델 표를 기준으로 봅니다. 2026년 10월 4일 기준 주요 차이는 다음과 같습니다.
| 모델 | 개인 요금제에서 확인할 조건 |
|---|---|
| Gemini 3.8, 3.7, 3.6 Flash와 3.1 Pro | Free, Plus, Pro, Ultra에서 제공 |
| Claude Sonnet 5.5와 Opus 5.5 | 체험판이 아닌 Pro와 Ultra에서 제공 |
| Claude Sonnet 4.6과 Opus 4.6 | Free, Plus, Pro에서 제공하며 Ultra에서는 제외 |
| GPT-OSS-120b | Free, Plus, Pro, Ultra에서 제공 |
Claude 4.6 계열과 GPT-OSS-120b는 2026년 11월 2일 제공 종료 예정입니다. 기업용 목록은 개인용과 다르며 위 표의 Claude와 GPT-OSS는 기업용에 포함되지 않습니다. 모델이 보이지 않으면 결제부터 하기보다 로그인 계정, 요금제와 종료 일정을 대조합니다. 현재 모델 표
무료 사용과 추가 비용을 구분합니다
무료 사용에도 작업량 한도가 있습니다. 무제한 탭 자동완성이라는 안내는 코드를 입력할 때 이어 쓸 내용을 제안하는 기능에 관한 것이며, 에이전트 작업을 무제한 제공한다는 뜻은 아닙니다.
| 개인 요금제 | 포함 할당량의 갱신과 제한 |
|---|---|
| Free, Plus | 주 단위 갱신 |
| Pro | 5시간 단위 갱신과 주간 상한 |
| Ultra | 5시간 단위 갱신과 더 높은 주간 상한 |
한도는 단순한 질문 횟수보다 처리한 작업량에 영향을 받습니다. 짧은 메모 한 번이 얼마나 차감되는지 고정 횟수로 약속할 수는 없습니다.
Pro와 Ultra에서는 포함 사용량을 넘겼을 때 AI 크레딧을 사용하는 설정도 있습니다. Never는 추가 크레딧을 쓰지 않고 기다리며, Always는 포함 할당량이 소진되면 사용 가능한 크레딧을 자동으로 소비합니다. 첫 연습 전에 이 설정을 확인하면 추가 사용을 포함된 혜택으로 오해하지 않을 수 있습니다. 요금제와 AI 크레딧
Gemini CLI를 쓰고 있었다면
CLI에 익숙한 분은 터미널에서 agy로 안티그래비티를 실행할 수 있습니다. 처음 배우는 분은 위 데스크톱 연습을 마친 뒤 공식 CLI 설치 안내를 따르면 됩니다. 명령어 설치와 데스크톱 설치를 모두 할 필요는 없습니다.
구글은 개인용 무료 계정과 Google AI Pro, Ultra 계정의 Gemini CLI 및 개인용 Gemini Code Assist 서비스를 2026년 6월 18일부터 중단한다고 공지했습니다. Code Assist Standard, Enterprise 라이선스와 유료 Gemini API 키 등에는 예외가 있으므로 자신의 인증 방식을 구분해야 합니다.
기존 스킬, 훅과 하위 에이전트 같은 기능을 새 CLI에서도 지원한다는 설명이 모든 설정의 자동 이전을 뜻하지는 않습니다. 스킬은 반복 작업 지침, 훅은 특정 시점에 실행할 동작을 정하는 기능입니다. 공식 공지도 두 제품의 기능이 완전히 같지는 않다고 설명합니다. 기존 설정을 보관하고 실제 사용하는 기능부터 옮겨 확인합니다. 구글의 전환 공지
한국어 답변과 한국어 메뉴는 따로 봅니다
위 연습처럼 지시에 “한국어로 답해 줘”라고 적어 답변 언어를 정할 수 있습니다. 화면 메뉴의 번역 여부는 별도입니다. 다른 편집기에 쓰던 언어 팩이 안티그래비티 2.0 앱에도 그대로 적용된다고 가정하지 않습니다.
이미 다른 코딩 도구로 업무를 처리하고 있다면 같은 가상 메모로 결과와 사용량을 비교해 볼 수 있습니다. 모델 이름이 익숙한지보다 파일을 찾고, 변경을 확인하고, 틀린 부분을 다시 고칠 수 있는지가 첫 선택에 도움이 됩니다.
3줄 요약
-
안티그래비티는 AI 모델을 이용해 파일 수정과 명령 실행 등을 수행하는 에이전트 프로그램이며 데스크톱, CLI와 편집기용 제품이 있습니다.
-
첫 연습에서는 가상 메모를 넣은 폴더를 지정하고 요약 파일의 날짜, 담당자와 원본 보존 여부를 직접 확인합니다.
-
모델 지원과 할당량은 요금제에 따라 다르므로 현재 모델 표와 추가 크레딧 사용 설정을 확인합니다.
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
AI가 회의 요약 파일을 만들었다고 답했을 때 다음 행동으로 알맞은 것은 무엇인가요?
이 글이 도움이 되었나요?
코딩 에이전트가 무엇이고 도구마다 무엇이 다른지, 비개발자 눈높이로 고르는 기준까지
코스 전체 보기 →
새 글과 AI 소식을 메일로 받아 보세요
AI가 바꾸는 일과 도구, 측정 실무 이야기를 매주 한 번 보내 드려요.