Skip to content

1장. Antigravity는 무엇이고 앞의 두 도구와 무엇이 다른가 ​

필수 이 단계를 따라가려면 꼭 읽으세요.

한 줄 요약: Antigravity는 Google이 만든, 내 컴퓨터의 폴더에서 직접 일하는 AI 도구입니다. 데스크톱 앱과 터미널 프로그램 agy가 있습니다. 앞의 두 도구와 다른 점은 둘입니다. 무료 Google 계정으로도 모든 기능을 쓸 수 있고, Codex 단계에서 만든 AGENTS.md와 .agents/skills를 그대로 읽습니다.

이 장은 2026년 11월 1일에 확인한 Antigravity 공식 문서(antigravity.google/docs)를 바탕으로 썼습니다. 기능과 메뉴 이름은 자주 바뀝니다.

네 가지 모양 ​

Antigravity는 쓰는 곳에 따라 네 가지 모양이 있습니다.[1]

모양하는 일이 가이드
Antigravity App데스크톱에서 에이전트에게 일을 맡기고 지켜보기2장부터
Antigravity CLI(agy)터미널에서 쓰기6장
편집기 확장·Antigravity IDE코드 편집기 안에서 쓰기다루지 않음
SDK파이썬으로 에이전트 만들기다루지 않음

출처: Antigravity 공식 문서(이 가이드의 정리)[1:1][2][3]

앱과 CLI는 같은 에이전트를 돌려서, 기능 대부분을 둘 다에서 씁니다.[4] 한 곳에서 로그인하면 내 컴퓨터의 다른 모양에서도 같은 로그인을 씁니다.[5]

확인 퀴즈

Antigravity 앱과 터미널 프로그램 agy의 관계로 맞는 것은 무엇일까요?

무료로도 모든 기능 ​

Antigravity는 모든 요금제에 모든 기능을 줍니다. 예약 작업과 CLI도 포함입니다.[6] 요금제마다 다른 것은 사용량과 고를 수 있는 모델입니다.

요금제사용량
무료(Google AI Pro·Ultra가 아닌 계정)주 단위로 다시 채워짐
Google AI Pro주간 한도까지 5시간마다 다시 채워짐
Google AI Ultra가장 넉넉함, 5시간마다 다시 채워짐

출처: Antigravity 공식 문서(일부만 옮김)[7]

사용량은 질문 개수가 아니라 에이전트가 한 일의 양에 따라 줄어듭니다. 쉬운 일이면 더 많이 물을 수 있습니다.[8]

예를 들어 보겠습니다.

  • 「이 파일의 오타만 고쳐 줘」처럼 작은 일은 사용량이 조금 줄어듭니다.
  • 「폴더의 파일을 전부 읽고 정리해 줘」처럼 큰 일은 한 번에 많이 줄어듭니다.

세 도구 중 무료 계정으로 모든 기능을 쓸 수 있는 것은 Antigravity뿐입니다. Claude Code는 유료 구독이 필요하고, Codex 장은 Plus 이상을 기준으로 했습니다. 아직 유료 요금제가 없다면 이 단계부터 실습해도 됩니다.

개인 Google 계정(예: @gmail.com)이면 무료로 시작할 수 있습니다.[9] 단, 만 18세 이상이어야 합니다.[10]

자세히 (눌러서 펼치기)
  • 이용 가능한 국가에서만 쓸 수 있습니다. 대한민국은 목록에 있습니다.[11]
  • 회사·학교에서 관리하는 계정은 개인 계정이 아닙니다. 그래서 관리자가 허용해야 씁니다.[12]

확인 퀴즈

무료 Google 계정으로 Antigravity를 쓰면 무엇이 달라질까요?

모델 고르기 ​

Antigravity에서는 Gemini 말고 다른 회사 모델도 고를 수 있습니다.

생각 수준(Low·Medium·High)도 정합니다. 생각 수준은 AI가 답하기 전에 얼마나 깊이 따져 볼지 정하는 값입니다. Low는 빨리 답해서 간단한 수정에 맞고, High는 오래 생각해서 여러 단계가 얽힌 어려운 일에 맞습니다.[13]

고를 수 있는 모델은 요금제마다 다릅니다.

모델무료ProUltra
Gemini 3.8 Flash✅✅✅
Gemini 4 Argon❌✅✅
Claude Sonnet 5.5❌✅✅

출처: Antigravity 공식 문서(일부만 옮김, Pro의 Claude는 체험판 제외)[14]

무료 계정이라면 Gemini 3.8 Flash로 실습한다고 생각하면 됩니다. 처음부터 모델을 고민할 필요는 없습니다.

자세히 (눌러서 펼치기)

무료로 고를 수 있던 Claude 4.6 계열은 2026년 11월 2일에 빠질 예정이라고 적혀 있습니다(2026-11-01 확인 기준).[15] 그래서 무료 계정에서 고를 모델로 Gemini 3.8 Flash를 기준으로 삼았습니다.

확인 퀴즈

무료 계정에서 2026년 11월 2일 이후 실습에 쓸 모델로 이 가이드가 안내하는 것은 무엇일까요?

Claude Code·Codex와 무엇이 같고 다른가 ​

Claude CodeCodexAntigravity
데스크톱Claude 앱의 Code 탭ChatGPT 앱의 Codex독립 앱
규칙 파일CLAUDE.mdAGENTS.mdAGENTS.md·GEMINI.md
이 폴더 스킬.claude/skills.agents/skills.agents/skills
스킬 부르기/이름$이름/이름
터미널claude -pcodex execagy -p
무료 실습안 됨제한적됨

출처: 이 가이드의 정리(근거는 각 장의 각주)

가장 큰 차이는 "옮길 필요가 없다"는 점입니다. Antigravity는 폴더의 AGENTS.md·GEMINI.md와 .agents/ 폴더를 읽습니다.[16] Codex 단계에서 만든 파일 이름·위치와 같습니다. 3장에서 실제로 시험합니다.

확인 퀴즈

Codex 단계에서 만든 정리도구 폴더를 Antigravity로 열 때 옮겨야 할 것은 무엇일까요?

이 단계에서 할 일 ​

Codex 5장까지 마친 정리도구 폴더를 그대로 Antigravity로 엽니다. Codex를 건너뛰었다면 3단계 Antigravity 목차의 「연습 자료」에서 같은 출발점 파일을 받을 수 있습니다.

  1. 2장: 앱을 설치하고, 폴더를 프로젝트로 열고, 첫 정리를 맡긴다.
  2. 3장: 규칙과 스킬을 옮기지 않아도 지키는지 시험한다.
  3. 4~5장: 권한·되돌리기, 계획·예약을 Claude Code·Codex와 비교한다.
  4. 6장: 터미널 agy -p와 그 함정을 익힌다.
  5. 7장: 비용·데이터·안전을 정리하고, 세 도구를 어떻게 함께 쓸지 정한다.

정리 ​

  • Antigravity는 앱·CLI·편집기·SDK 네 가지 모양이 있다. 앱과 CLI는 같은 에이전트다.
  • 모든 요금제에 모든 기능이 있다. 다른 것은 사용량과 모델이다. 무료는 주 단위로 다시 채워진다.
  • 만 18세 이상, 개인 Google 계정이면 무료로 시작할 수 있다.
  • AGENTS.md와 .agents/skills를 Codex와 같은 이름·위치에서 읽는다.

용어 정리 ​

용어읽는 법한 줄 뜻
Antigravity안티그래비티Google의 코딩 에이전트 도구
agy에이지와이Antigravity의 터미널 프로그램
Quota쿼터정해진 기간에 쓸 수 있는 사용량
GEMINI.md제미나이 엠디Antigravity가 읽는 또 하나의 규칙 파일 이름

이 장을 다 읽었나요?

기록은 이 브라우저에만 저장됩니다. 진행 현황은 전체 목차에서 볼 수 있어요.

다음 장: 2장. 앱 설치와 첫 정리

참고 자료 (16개)
  1. Antigravity 공식 문서, 「Choose your Antigravity」. "Evolved from the Agent Manager into a standalone desktop command center (Antigravity App) alongside native terminal, editor, and programmatic SDK interfaces, Antigravity supports both synchronous interactive pair-programming and asynchronous background agent workflows independent of a single IDE." antigravity.google (확인일 2026-11-01) ↩︎

  2. Antigravity 공식 문서, 「Get started」. "Install the official Google Antigravity extension for your preferred editor, or download the standalone Antigravity IDE:" antigravity.google (확인일 2026-11-01) ↩︎

  3. Antigravity 공식 문서, 「Google Antigravity SDK」. "The Google Antigravity SDK is a Python SDK for building autonomous AI agents powered by Antigravity and Gemini." antigravity.google (확인일 2026-11-01) ↩︎

  4. Antigravity 공식 문서, 「Antigravity features」. "The Antigravity App and the Antigravity CLI run the same agent, so most features work on both." antigravity.google (확인일 2026-11-01) ↩︎

  5. Antigravity 공식 문서, 「Authenticate」. "Signing in on one local surface shares your credentials across your local environment." antigravity.google (확인일 2026-11-01) ↩︎

  6. Antigravity 공식 문서, 「Plans」. "All plans receive the following baseline features:" / "Access to all product features, such as scheduled tasks and the CLI" antigravity.google (확인일 2026-11-01) ↩︎

  7. Antigravity 공식 문서, 「Plans」. "The highest, most generous quota, refreshed every five hours" / "A high, generous quota, refreshed every five hours until the weekly limit is reached" / "A meaningful quota, refreshed weekly" antigravity.google (확인일 2026-11-01) ↩︎

  8. Antigravity 공식 문서, 「Plans」. "As a result, you receive more prompts when your tasks are straightforward and the agent can complete the work quickly, while more complex tasks consume more quota." antigravity.google (확인일 2026-11-01) ↩︎

  9. Antigravity 공식 문서, 「FAQ」. "Personal Google Accounts (such as @gmail.com addresses) can use Google Antigravity on any plan, including the free tier." antigravity.google (확인일 2026-11-01) ↩︎

  10. Antigravity 공식 문서, 「FAQ」. "Currently, Antigravity is unavailable to users under 18." antigravity.google (확인일 2026-11-01) ↩︎

  11. Antigravity 공식 문서, 「FAQ」. "Google Antigravity is available in the following countries and territories." / "South Korea" antigravity.google (확인일 2026-11-01) ↩︎

  12. Antigravity 공식 문서, 「FAQ」. "Work or school accounts managed by an organization, such as Google Workspace accounts, aren’t personal Google Accounts." antigravity.google (확인일 2026-11-01) ↩︎

  13. Antigravity 공식 문서, 「Choose a model」. "You can switch models at any time and choose a thinking level (Low, Medium, or High) to balance response speed for quick edits against deeper multi-step reasoning for complex architecture and debugging tasks." antigravity.google (확인일 2026-11-01) ↩︎

  14. Antigravity 공식 문서, 「Choose a model」. 모델 표의 Gemini 3.8 Flash·Gemini 4 Argon·Claude Sonnet 5.5 행과 "** Available on Google AI Pro for non-trial subscriptions only." antigravity.google (확인일 2026-11-01) ↩︎

  15. Antigravity 공식 문서, 「Choose a model」. "* Will be removed on November 2, 2026." antigravity.google (확인일 2026-11-01) ↩︎

  16. Antigravity 공식 문서, 「Customization discovery」. "Workspace: the .agents/ folder in your project, plus AGENTS.md and GEMINI.md files." antigravity.google (확인일 2026-11-01) ↩︎