2장. 앱 설치와 첫 정리 — 폴더를 프로젝트로 열기
필수 이 단계를 따라가려면 꼭 읽으세요.한 줄 요약: Antigravity 앱을 설치하고 Google 계정으로 로그인한 뒤, 정리도구 폴더를 프로젝트로 엽니다. 처음에는 Planning mode(먼저 계획)로 맡기고, 계획을 읽은 뒤 Proceed로 진행합니다.
이 가이드는 아직 앱 화면으로 실습하지 못했습니다. 화면의 버튼 이름은 공식 문서의 영어 이름을 그대로 적었습니다. 내 화면과 조금 달라도 괜찮습니다. 이름이 비슷한 버튼을 찾아 따라 해 보세요. 실제로 돌려 본 결과는 3장(터미널로 실행)에 있습니다.[1]
설치하고 로그인하기
- antigravity.google/download에서 내 컴퓨터용 설치 파일을 받습니다. macOS라면
Antigravity.dmg를 열고 Applications 폴더로 끌어 넣습니다.[2] - 앱을 열고 Sign in을 누릅니다. 브라우저가 열리면 개인 Google 계정으로 로그인합니다.[3]
로그인한 계정의 요금제(무료·Pro·Ultra)에 따라 사용량과 모델이 정해집니다(1장).
확인 퀴즈
Antigravity 앱에 로그인하는 방법으로 맞는 것은 무엇일까요?
폴더를 프로젝트로 열기
Antigravity 앱의 에이전트는 프로젝트(Projects) 안에서 일합니다. 프로젝트는 에이전트가 손댈 수 있는 폴더 범위와 권한을 정합니다.[4]
- 왼쪽 사이드바의 New Project 아이콘(더하기가 붙은 폴더)을 누릅니다.[5]
- Add Folder로 정리도구 폴더를 고릅니다. Git 저장소가 아닌 일반 폴더도 됩니다.[5:1]
첫 지시를 보낼 때 일하는 방식을 고릅니다.[6]
| 이름 | 하는 일 |
|---|---|
| Local mode | 지금 폴더에서 바로 일하기 |
| New worktree mode | 따로 떼어 낸 Git 작업 공간에서 일하기 |
출처: Antigravity 공식 문서[6:1]
정리도구에는 Local mode를 고르세요. 지금 폴더에서 바로 일하므로 결과 파일을 바로 찾을 수 있습니다.
권한(에이전트가 무엇을 해도 되는지)은 4장에서 다룹니다. 지금은 설정을 바꾸지 않아도 됩니다.
자세히 (눌러서 펼치기)
확인 퀴즈
정리도구 폴더를 Antigravity 앱에서 여는 방법은 무엇일까요?
계획부터 받고 진행하기
새 대화를 시작할 때 두 가지 방식 중 하나를 고릅니다.[9]
| 이름 | 하는 일 | 언제 |
|---|---|---|
| Planning mode | 먼저 계획을 세우고 실행 | 처음 맡기는 일 |
| Fast mode | 계획 없이 바로 실행 | 이름 바꾸기 같은 작은 일 |
출처: Antigravity 공식 문서(일부만 옮김)[9:1]
처음에는 Planning mode를 권합니다. 계획서(Implementation plan)가 나오면 읽어 보고, 괜찮으면 대화나 계획서 위쪽의 Proceed를 눌러 진행합니다.[10] Claude Code 5장의 「계획」 모드, Codex 4장의 /plan과 같은 역할입니다.
일을 마치면 에이전트가 정리 보고(Walkthrough)를 만들어 무엇이 바뀌었는지 요약합니다.[11]
처음에는 Request review(내 승인을 기다리는 방식)로 두는 것이 안전합니다. 에이전트가 계획을 만들면 멈추고 내가 Proceed를 누를 때까지 기다립니다.[12] 검토 방식은 설정의 Agent 탭에서 고릅니다.[12:1]
자세히 (눌러서 펼치기)
반대쪽 끝인 Always proceed는 멈추지 않고 바로 실행합니다.[13] 익숙해지기 전에는 고르지 않는 편이 좋습니다.
확인 퀴즈
처음 맡기는 일에 이 가이드가 권하는 방식은 무엇일까요?
첫 정리 맡기기
앞의 두 도구와 같은 요청을 보냅니다.
inbox/회의-2026-10-27-주간회의.txt 메모를 회의록으로 정리해서 notes/ 폴더에 새 파일로 저장해 줘.파일을 짚어 주고 싶으면 @를 쳐서 고를 수도 있습니다. 파일을 짚어도 내용이 붙여 넣어지는 것이 아니라, 에이전트에게는 파일 경로가 전달되고 필요할 때 그 파일을 읽습니다.[14]
같은 요청을 이 가이드가 터미널(agy)로 실행한 결과는 3장에 있습니다. 앱과 터미널은 같은 에이전트를 씁니다(1장).
결과를 원본과 맞춰 보세요. 할 일 5개가 다 옮겨졌나? 담당과 기한이 메모와 같나? 메모에 없는 내용을 지어내지 않았나?
확인 퀴즈
대화창에서 @로 파일을 짚어 주면 어떻게 될까요?
바뀐 내용 보기
앱의 Review 창은 프로젝트 Git 저장소의 변경을 보여 줍니다.[15] 기본 보기는 아직 기록하지 않은 모든 변경(Uncommitted)이라, 내가 고친 것도 함께 보입니다. Agent Edits를 고르면 이 대화에서 에이전트가 고친 파일만 봅니다.[16]
Git(깃)은 파일이 언제 어떻게 바뀌었는지 기록해 두는 도구입니다. Review 창은 이 기록과 지금 파일을 비교해서 보여 줍니다. 그래서 정리도구 폴더도 Git 저장소(Git 기록이 켜진 폴더)로 만들어 두면 편합니다.
- Claude Code 3장이나 Codex 2장을 따라 했다면 이미 Git 저장소입니다.
- 아직 아니라면 Git 명령을 몰라도 됩니다. 에이전트에게 「이 폴더에 변경 기록(Git)을 켜 줘」라고 부탁하는 방법이 Claude Code 3장에 있습니다(선택). Claude Code에서 확인한 방법이라, Antigravity에서도 그대로 되는지는 이 가이드가 확인하지 못했습니다.
Git이 아닌 폴더에서 Review 창이 어떻게 보이는지는 공식 문서에 나오지 않습니다.
확인 퀴즈
Review 창에서 이 대화에서 에이전트가 고친 파일만 보려면 무엇을 고를까요?
직접 해 보기
- 앱을 설치하고 로그인한다.
- New Project → Add Folder로 정리도구 폴더를 연다.
- Planning mode로 위의 요청을 보내고, 계획을 읽은 뒤 Proceed를 누른다.
- 결과 회의록을 원본 메모와 맞춰 보고, Review 창에서 바뀐 파일을 확인한다.
이어지는 과제: 3장에서는 규칙(AGENTS.md)과 스킬을 옮기지 않아도 지키는지 시험합니다.
정리
- 앱은 Sign in → 개인 Google 계정으로 로그인한다.
- New Project → Add Folder로 폴더를 프로젝트로 연다. 일반 폴더도 된다.
- 처음에는 Planning mode와 Request review로 계획을 읽고 Proceed한다.
- Review 창은 Git 변경을 보여 준다. Agent Edits로 에이전트 변경만 볼 수 있다.
용어 정리
| 용어 | 읽는 법 | 한 줄 뜻 |
|---|---|---|
| Project | 프로젝트 | 에이전트가 일하는 폴더와 권한의 묶음 |
| Planning mode | 플래닝 모드 | 계획을 먼저 세우고 실행하는 방식 |
| Implementation plan | 임플리멘테이션 플랜 | 에이전트가 만든 작업 계획서 |
| Walkthrough | 워크스루 | 일을 마친 뒤의 정리 보고 |
이 장을 다 읽었나요?
기록은 이 브라우저에만 저장됩니다. 진행 현황은 전체 목차에서 볼 수 있어요.
다음 장: 3장. 규칙과 스킬 — 옮기지 않아도 된다
참고 자료 (16개)
이 장은 2026년 11월 1일에 확인한 Antigravity 공식 문서를 바탕으로 썼습니다. 이 가이드는 아직 앱 화면으로 실습하지 못했습니다. ↩︎
Antigravity 공식 문서, 「Get started」. "Open the downloaded
Antigravity.dmgdisk image and drag Antigravity into your Applications folder." antigravity.google (확인일 2026-11-01) ↩︎Antigravity 공식 문서, 「Authenticate」. "Click Sign in to open the browser authentication flow." / "Complete the browser-based OAuth flow using your personal Google Account (Free, Pro, or Ultra plan)." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Get started」. "Agents operate within Projects, which define the repository boundaries, file scopes, and security permissions for your workspaces." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Get started」. "Click the New Project icon (folder with a plus sign) in the left sidebar." / "Click Add Folder to select one or more local Git repositories or working directories." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Get started」. "Local mode: The agent operates directly in your active folders." / "New worktree mode: The agent operates in an isolated Git worktree." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Projects」. "New worktree mode: Creates a new Git worktree for the conversation. Best for complex tasks, keeping your active working folder untouched and preventing parallel subagents from conflicting." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Projects」. "Settings: When a project is created, it starts with the Inherit Global permission preset, following your global permission settings, with read and write access to all of your project’s folders." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Artifact review」. "Planning mode: The agent plans thoroughly before executing tasks." / "Fast mode: The agent executes tasks directly without a dedicated planning phase." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Implementation plan」. "You can click Proceed either in the conversation or in the artifact header to immediately continue with the agent’s plan." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Walkthrough」. "The agent creates walkthrough artifacts when it completes task implementation. This type of artifact includes a concise summary of the changes made to remind you of what happened in the active conversation." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Artifact review」. "You can customize the review workflow in the Agent tab of the Settings pane." / "The agent always halts and requests your explicit approval before proceeding with proposed changes:" antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Artifact review」. "The agent never halts for manual review and immediately proceeds with executing its plans:" antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Mentions and quoting」. "Mentioning a file or folder doesn’t paste its contents into your prompt." / "| A file or folder | Its full path. The agent reads it when it needs to. |" antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Review changes」. "In the Antigravity App, the Review pane shows the changes in your project’s Git repository, including the agent’s edits." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Review changes」. "| Agent Edits | The files the agent modified in this conversation, whether or not they’re committed. |" / "| Uncommitted | Staged and unstaged changes in your working tree, grouped under Staged Changes and Changes. This is the default. |" antigravity.google (확인일 2026-11-01) ↩︎