Skip to content

4장. 권한과 되돌리기 — 프리셋 넷, 버리기는 조심 ​

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

한 줄 요약: 앱의 권한은 프리셋 네 개(Request Review·Default·Auto·Turbo)로 고릅니다. 처음에는 Request Review나 Default로 시작하세요. Review 창의 버리기는 확인 없이 바로 적용됩니다. 터미널에는 /rewind가 있지만, 가장 확실한 안전망은 여전히 Git 기록입니다.

권한은 에이전트가 내 허락 없이 해도 되는 일의 범위입니다. 예를 들어 "폴더 안 파일 고치기는 묻지 말고, 프로그램 설치는 꼭 물어봐" 같은 약속입니다. 권한이 왜 필요한지는 Claude Code 4장에서 더 자세히 설명했습니다(선택).

이 가이드는 아직 앱 화면으로 실습하지 못했습니다. 화면 이름이 내 화면과 다르면 화면을 따르세요. 이 장은 개인 Google 계정을 기준으로 썼습니다.[1]

권한 프리셋 네 가지 ​

프리셋명령 실행언제
Request Review모든 명령에 허락처음, 조심스러운 일
Default울타리 안에서는 묻지 않고, 밖으로 나갈 때 묻기익숙해진 뒤
Auto (Preview)안전한 명령은 알아서, 위험한 명령만 묻기시험 기능
Turbo제한 없이 모두 실행거의 쓰지 않음

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

Turbo는 울타리 없이 컴퓨터 전체를 읽고 쓸 수 있습니다.[3] 메모 정리에는 필요 없습니다.

바꾸는 곳은 세 군데입니다.[4]

  • 모든 프로젝트: Settings → General → Global Permissions → Permission Preset
  • 프로젝트 하나: Settings → Projects
  • 지금 대화: 입력창의 권한 선택기

프로젝트는 기본으로 전체 설정을 따르고(Inherit Global), 프로젝트마다 따로 정할 수도 있습니다.[5] 믿는 프로젝트는 느슨하게, 믿지 못하는 폴더는 엄격하게 둘 수 있다는 뜻입니다.[6] 개인 계정이 처음에 어떤 프리셋으로 시작하는지는 공식 문서에 나오지 않습니다. 앱을 열면 먼저 확인하세요.

확인 퀴즈

Antigravity 앱의 권한 프리셋 중 제한 없이 모든 명령을 실행하는 것은 무엇일까요?

울타리와 기본 규칙 ​

앱에는 터미널 울타리(샌드박스, Sandbox)가 있습니다. 에이전트가 실행하는 명령이 손댈 수 있는 범위를 막아 두는 장치입니다. 공식 문서는 기본으로 켜져 있다고 설명합니다.[7]

다만 프리셋마다 다릅니다.[8]

  • 켜짐: Default·Auto
  • 꺼짐: Request Review·Turbo

울타리가 켜져 있으면 명령이 이렇게 묶입니다.

  • 작업 폴더와 임시 폴더만 씁니다.
  • 인터넷에 나가지 못합니다.[9]
  • ~/.ssh나 .env처럼 민감한 파일(비밀번호·열쇠가 든 파일)도 막힙니다.[10]

예를 들어 Default에서 에이전트가 인터넷에서 무언가를 내려받는 명령을 쓰려 하면, 울타리 밖으로 나가야 합니다. 이때 앱이 그 명령을 스스로 따져 봅니다. 안전하고 되돌릴 수 있는 명령은 묻지 않고 진행하고, 위험하거나 되돌릴 수 없는 명령은 멈추고 내 허락을 묻습니다.[2:1]

프리셋과 상관없이 기본 규칙도 있습니다.

  • 프로젝트 폴더 안 파일 읽기·쓰기는 묻지 않습니다. 밖 파일은 허락이 필요합니다.[11]
  • 웹 페이지 읽기와 조작은 기본이 "묻기"입니다.[12]
  • 규칙이 겹치면 막기(Deny) > 묻기(Ask) > 허용(Allow) 순서로 정합니다.[13] 예를 들어 "웹 페이지 읽기는 허용"과 "이 사이트는 막기"를 둘 다 정해 두면, 그 사이트에서는 막기가 이깁니다. 지금 당장 규칙을 만들 필요는 없습니다.

대화 중에 허락한 것은 남을 수 있어서, 에이전트가 믿을 만한 동작을 점점 배웁니다.[14] 편하지만, 무엇을 허락했는지 기억해 두세요.

터미널(agy)의 기본값은 다릅니다. 터미널은 파일 쓰기·명령·웹 도구 전에 묻고[15], 울타리는 기본으로 꺼져 있습니다.[16] 6장에서 다룹니다.

확인 퀴즈

앱의 Default 프리셋과 터미널(agy)에서 명령 울타리(샌드박스)는 기본으로 어떻게 될까요?

되돌리기 ​

Review 창의 버리기는 조심하세요. 「Discard unstaged changes」는 아직 git add로 기록할 목록에 올리지 않은 변경을 버리는 버튼입니다. 이 버튼은 확인 없이 바로 적용되고, 한 번도 기록되지 않은 새 파일까지 지웁니다.[17]

기본 보기에는 내가 고친 것도 들어 있습니다(2장). 그래서 이 버튼을 누르면 에이전트가 고친 것뿐 아니라 내가 고친 것까지 사라질 수 있습니다. 버리기 전에 무엇이 들어 있는지 꼭 보세요.

가장 확실한 되돌리기는 Git 기록입니다. 이 단계에서도 Codex 4장과 같은 습관을 씁니다.

  1. 맡기기 전: Git으로 지금 상태를 기록해 둔다.
  2. 맡긴다.
  3. Review 창의 Agent Edits로 바뀐 것만 본다.
  4. 좋으면 다시 기록하고, 아니면 되돌린다.

Git 명령을 몰라도 됩니다. 에이전트에게 "지금 상태를 Git으로 기록해 줘"라고 부탁하면 됩니다(Claude Code에서 확인한 방법입니다. Antigravity에서는 이 가이드가 아직 확인하지 못했습니다).

다른 되돌리기 기능도 있지만, 파일까지 되돌리는지 아직 확인되지 않았습니다.

자세히 (눌러서 펼치기)
  • 터미널에는 대화를 앞의 안정된 상태로 되돌리는 /rewind(또는 /undo)가 있습니다.[18] 이름은 Claude Code의 되감기와 비슷하지만, 공식 문서는 "대화"를 되돌린다고만 설명합니다. 파일까지 되돌리는지는 나오지 않습니다.
  • 앱에도 되돌리기가 있는 것으로 보입니다. 공식 변경 기록에 "Confirm Undo" 확인 창이 대화만 되돌리는 선택지를 갖게 됐다는 내용이 있습니다.[19] 다만 쓰는 법을 설명한 문서는 찾지 못했고, 이 가이드도 앱에서 확인하지 못했습니다.

확인 퀴즈

Review 창의 Discard unstaged changes를 누를 때 조심해야 하는 이유는 무엇일까요?

직접 해 보기 ​

  1. Settings → General → Global Permissions에서 지금 프리셋을 확인한다. 처음이면 Request Review나 Default로 둔다.
  2. 정리도구 폴더의 지금 상태를 Git으로 기록한다.
  3. 2장의 회의록에 "맨 위에 '작성일: 오늘 날짜' 한 줄을 추가해 줘"라고 부탁한다.
  4. Review 창을 Agent Edits로 보고 바뀐 줄을 확인한다.

이어지는 과제: 5장에서는 계획(/plan), 예약(/schedule·Automations), 브라우저(/browser), 목표(/goal)를 살펴봅니다.

정리 ​

  • 앱 권한은 프리셋 넷. 처음에는 Request Review나 Default, Turbo는 쓰지 않는다.
  • 앱의 울타리는 Default·Auto 프리셋에서 켜지고 인터넷이 막힌다. 터미널은 기본 꺼짐.
  • 프로젝트 폴더 안 파일은 묻지 않고, 밖과 웹은 묻는다.
  • Review 창 버리기는 확인 없이 바로 지운다. 맡기기 전에 Git으로 기록해 둔다.

용어 정리 ​

용어읽는 법한 줄 뜻
Permission preset퍼미션 프리셋권한을 한 번에 정하는 묶음
Sandbox샌드박스명령이 손댈 수 있는 범위를 막는 울타리
Discard디스카드바뀐 내용을 버리기
/rewind리와인드터미널에서 대화를 앞 상태로 되돌리는 명령

이 장을 다 읽었나요?

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

다음 장: 5장. 계획·예약·브라우저·목표

참고 자료 (20개)
  1. 이 장은 2026년 11월 1일에 확인한 Antigravity 공식 문서를 바탕으로 썼습니다. 이 가이드는 아직 앱 화면으로 실습하지 못했습니다. 회사·기업 계정은 권한 화면이 다릅니다.[20] ↩︎

  2. Antigravity 공식 문서, 「Agent settings」. "Request Review (“Every command requires approval.”): The sandbox is off and every terminal command requires approval." / "Default (“Ask before sensitive operations.”): Commands run without prompting inside the Terminal sandbox; running outside the sandbox requires approval." / "When a command needs to run outside the sandbox, Antigravity automatically evaluates it so safe, reversible commands proceed without prompting while risky or irreversible actions still pause for your approval." antigravity.google (확인일 2026-11-01) ↩︎

  3. Antigravity 공식 문서, 「Agent settings」. "Turbo (“Run all commands without restrictions.”): All commands run without prompting with no isolation or restrictions, and the agent has full read and write access to your filesystem." antigravity.google (확인일 2026-11-01) ↩︎

  4. Antigravity 공식 문서, 「Agent settings」. "For all projects: Open Settings > General > Global Permissions > Permission Preset." / "From the message box (v2.23.0+): Choose a preset from the permissions picker." / "For a single project: Override the global preset under Settings > Projects. Projects default to Inherit Global, which follows your global preset." antigravity.google (확인일 2026-11-01) ↩︎

  5. Antigravity 공식 문서, 「Agent settings」. "Projects default to Inherit Global, which follows your global preset." antigravity.google (확인일 2026-11-01) ↩︎

  6. Antigravity 공식 문서, 「Antigravity features」. "This means you can have a more permissive setting for a trusted project and a more restrictive security setting for an untrusted folder." antigravity.google (확인일 2026-11-01) ↩︎

  7. Antigravity 공식 문서, 「Terminal sandbox」. "Antigravity includes a terminal sandbox, enabled by default, that isolates shell commands executed by agents." antigravity.google (확인일 2026-11-01) ↩︎

  8. Antigravity 공식 문서, 「Terminal sandbox」. "| Default | On | Allowed in sandbox; ask outside |" / "| Turbo | Off | Allowed without prompting, unrestricted |" antigravity.google (확인일 2026-11-01) ↩︎

  9. Antigravity 공식 문서, 「Agent permissions」. "Default (“Ask before sensitive operations.”): Terminal commands run inside the isolated Terminal sandbox with access restricted to your workspace and temp directories and no network access." antigravity.google (확인일 2026-11-01) ↩︎

  10. Antigravity 공식 문서, 「Terminal sandbox」. "Sensitive files such as ~/.ssh and .env are blocked, anything not explicitly mounted is invisible inside the sandbox, and network access is limited to domains you’ve approved." antigravity.google (확인일 2026-11-01) ↩︎

  11. Antigravity 공식 문서, 「Agent permissions」. "Workspace files: Reading and writing files inside your active project directory is allowed without prompting, while non-workspace files require approval." antigravity.google (확인일 2026-11-01) ↩︎

  12. Antigravity 공식 문서, 「Agent permissions」. "Web browsing defaults to Ask: Actions for read_url and execute_url default to Ask." antigravity.google (확인일 2026-11-01) ↩︎

  13. Antigravity 공식 문서, 「Agent permissions」. "Precedence rule: Conflicting rules are strictly evaluated in priority order: Deny > Ask > Allow." antigravity.google (확인일 2026-11-01) ↩︎

  14. Antigravity 공식 문서, 「Antigravity features」. "Permissions manually granted during a conversation can persist, allowing the agent to learn trusted actions over time." antigravity.google (확인일 2026-11-01) ↩︎

  15. Antigravity 공식 문서, 「Antigravity features」. "The default request-review permission asks before the agent writes files, runs shell commands, or uses web tools, unless one of your allow rules matches." antigravity.google (확인일 2026-11-01) ↩︎

  16. Antigravity 공식 문서, 「Antigravity features」. "The terminal sandbox is off by default." antigravity.google (확인일 2026-11-01) ↩︎

  17. Antigravity 공식 문서, 「Review changes」. "Discard unstaged changes takes effect immediately, without asking you to confirm. It also deletes untracked files from disk." antigravity.google (확인일 2026-11-01) ↩︎

  18. Antigravity 공식 문서, 「CLI best practices」. "Type /rewind (or /undo) to roll back your conversation thread to a previous stable checkout." antigravity.google (확인일 2026-11-01) ↩︎

  19. Antigravity 공식 문서, 「Changelog」. "The Confirm Undo dialog now offers an option to revert only the conversation." antigravity.google (확인일 2026-11-01) ↩︎

  20. Antigravity 공식 문서, 「Agent settings」. "Business and enterprise accounts use the following settings instead of the permission presets above." antigravity.google (확인일 2026-11-01) ↩︎