6장. 터미널에서 쓰기 — agy -p와 조용한 거절
선택 필요할 때 읽으세요. 건너뛰어도 뒤 장을 따라갈 수 있습니다.한 줄 요약:
agy는 Antigravity의 터미널 프로그램이고,agy -p "할 일"은 한 번 실행하고 끝납니다.-p에서는 허락이 필요한 일이 조용히 거절됩니다. 그런데도 종료 코드(프로그램이 끝날 때 남기는 번호)는 **0(성공)**이라, 빈 결과를 성공으로 착각하기 쉽습니다.
터미널은 명령어를 글자로 쳐서 컴퓨터를 다루는 창입니다. 터미널이 처음이라면 이 장은 건너뛰어도 됩니다. 터미널을 더 알고 싶다면 Claude Code 10장을 보세요(선택).
이 장의 결과는 이 가이드가 macOS에서 agy를 실제로 돌려 본 것입니다. 따라 할 때는 터미널에서 agy를 직접 실행하세요.[1]
설치하고 시작하기
macOS·Linux의 설치 명령은 이렇습니다.[2]
curl -fsSL https://antigravity.google/cli/install.sh | bash이 명령은 인터넷에서 받은 설치 프로그램을 바로 실행합니다. 그래서 공식 문서(antigravity.google/docs)에 적힌 그대로인지 확인하고 실행하세요. Windows용 명령도 공식 문서에 있습니다.
정리도구 폴더로 이동해 agy를 치면 대화 화면이 열립니다.[3] 아래 첫 줄의 cd는 그 폴더로 이동하는 명령입니다. 앱에서 이미 로그인했다면 브라우저 없이 바로 로그인됩니다.[4]
처음 실행할 때는 이 폴더를 믿는지 묻습니다(Workspace trust, 폴더를 믿는다고 등록하는 절차).[5] 정리도구 폴더는 내가 만든 폴더이니 믿는다고 답하면 됩니다. 이렇게 답해 두면 뒤에 나올 거절 함정 하나를 피할 수 있을 것입니다(이 가이드의 추정).
cd ~/hello-ai-연습/정리도구
agy확인 퀴즈
agy를 처음 실행할 때 확인하는 'Workspace trust'는 무엇일까요?
실행 모드
대화형 agy에서는 Shift+Tab으로 실행 모드를 바꿉니다.[6]
| 모드 | 파일 수정 | 명령 실행 |
|---|---|---|
default | 바뀐 내용을 보여 주고 확인 | 묻기 |
accept-edits | 작업 폴더 안은 자동 | 묻기 |
출처: Antigravity 공식 문서(일부만 옮김)[7]
터미널의 기본 권한은 앱보다 조심스럽습니다. 파일 쓰기·명령·웹 도구 전에 묻고, 명령을 가두는 울타리는 기본으로 꺼져 있습니다(4장).
확인 퀴즈
agy의 accept-edits 모드에 대한 설명으로 맞는 것은 무엇일까요?
agy -p — 한 번 묻고 끝내기
-p는 요청 하나를 보내고 답을 받은 뒤 끝나는 방식입니다. 묻는 창이 없으므로, 허락이 필요한 일은 정해 둔 규칙대로 처리합니다.[8] 프로그램이 내보내는 글은 두 길로 나뉩니다.[9]
- 정식 출력(stdout, 스탠다드 아웃): 답 자체. 예를 들어 내가 달라고 한 파일 목록 표.
- 옆길(stderr, 스탠다드 에러): 진행 상황과 오류. 예를 들어 셸 명령이 거절되었음을 알리는 안내.
터미널 화면에서는 보통 둘이 함께 보입니다. 답과 안내가 섞여 보여도 놀라지 마세요.
공식 문서는 작업 폴더 안 파일 읽기·쓰기는 자동으로 허락하고, 셸 명령은 기본이 "묻기"라 조용히 거절(soft-deny)한다고 설명합니다.[10] 조용한 거절은 실행을 멈추지 않고 종료 코드 0으로 끝나며, 무엇이 막혔는지만 stderr에 알립니다.[11]
확인 퀴즈
agy -p에서 허락이 필요한 동작을 만나면 어떻게 될까요?
이 가이드가 겪은 함정 네 가지
정리도구 폴더에서 agy -p를 여러 번 돌리며 실제로 겪은 일입니다.
- 빈 결과인데 성공. 에이전트가 폴더 목록을 보려고 셸 명령(
ls, 터미널에 치는 명령)을 쓰려다 거절당했습니다. 그러자 아무것도 만들지 않고 끝났습니다. 종료 코드는 0이었습니다. 이런 일이 세 번 있었습니다.- 할 일: 결과 파일이 실제로 생겼는지 꼭 확인하세요.
- 믿지 않은 폴더에서는 읽기·쓰기도 거절. 연습 폴더에서 파일 쓰기와 읽기까지 거절된 적이 있습니다. 이 폴더를 아직 "믿는 폴더"로 등록하지 않았던 것이 원인으로 보입니다(이 가이드의 추정).[12]
- 할 일: 대화형
agy를 한 번 열어 폴더를 믿는다고 답하세요.[12:1]
- 할 일: 대화형
- 해결: 모드 하나 + 한 문장. 명령 끝에
--mode accept-edits를 붙이고, 요청 끝에 "셸 명령은 쓰지 말고 파일 읽기·쓰기만 해 줘"를 더하자 모두 성공했습니다.- 모든 것을 허락하는
--dangerously-skip-permissions옵션은 쓰지 마세요. --로 시작하는 이런 글자를 옵션이라고 합니다. 명령 뒤에 붙여 실행 방식을 바꿉니다.--mode accept-edits는 위 표의accept-edits모드로 실행하라는 뜻입니다. 아래 명령의 맨 끝에서 볼 수 있습니다.
- 모든 것을 허락하는
- 답이 빠뜨린 파일. 읽기 전용으로 notes 폴더의 파일 목록을 표로 달라고 했습니다. 정리한 파일은 3개(주간회의 회의록·임시회의 회의록·주간 회고)였습니다. 그런데 표에는 임시회의 회의록이 빠지고 대신 빈 파일
.gitkeep이 들어갔습니다.- 할 일: 확인 범위를 스스로 세어 보세요.
자세히 (눌러서 펼치기)
실제로 쓴 명령은 이렇습니다.
cd ~/hello-ai-연습/정리도구
agy -p "notes 폴더의 파일 목록을 보여 주고, 각 파일이 어떤 양식(templates 중 무엇)으로 쓰였는지 한 줄씩 알려 줘. 파일은 고치지 마. 답은 짧게 표로만. 셸 명령은 쓰지 말고 파일 읽기만 해 줘." --mode accept-edits결과: agy -p 출력(내 컴퓨터의 경로는 ~로 바꿈)
| Claude Code | Codex | Antigravity | |
|---|---|---|---|
| 한 번 실행 | claude -p | codex exec | agy -p |
| 기본 파일 쓰기 | 허락 필요 | 읽기 전용 | 작업 폴더 안 자동(문서) |
| 막히면 | 거절 | 멈춤 | 조용히 거절, 종료 코드 0 |
출처: 이 가이드의 정리(각 도구의 터미널 장과 실습)
확인 퀴즈
agy -p가 성공(종료 코드 0)으로 끝났는데 결과 파일이 없습니다. 이 가이드의 경험상 먼저 할 일은 무엇일까요?
이어 가기와 사용량
터미널의 대화 기록은 실행한 폴더별로 나뉩니다.[14] agy -c로 그 폴더의 마지막 대화를 바로 잇거나, /resume으로 골라 이어 갑니다.[15] /rewind(또는 /undo)는 대화를 앞의 메시지로 되돌립니다(4장). 파일까지 돌아오는지는 공식 문서에 나오지 않으니, 파일은 Git 기록을 믿으세요.
사용량은 /usage로 봅니다.[16]
확인 퀴즈
agy에서 이 폴더의 마지막 대화를 바로 이어 가는 방법은 무엇일까요?
직접 해 보기
- 공식 문서의 설치 명령과 위 명령이 같은지 확인한 뒤 설치한다(이미 있으면
agy --version). - 정리도구 폴더에서 대화형
agy를 한 번 열고, 폴더를 믿는지 묻으면 답한다. - 위의 읽기 전용
agy -p를 실행하고, 표의 파일 수를 notes 폴더와 맞춰 센다. - 결과가 비었으면 stderr의 거절 안내를 읽고, 무엇이 막혔는지 확인한다.
이어지는 과제: 7장에서는 비용·데이터·안전을 정리하고, 세 도구를 어떻게 함께 쓸지 정합니다.
정리
agy는 대화형,agy -p는 한 번 실행하고 끝. 대화 기록은 폴더별.-p에서 허락이 필요한 일은 조용히 거절되고 종료 코드는 0. 결과 파일을 직접 확인한다.- 믿지 않은 폴더에서는 파일 작업도 막힐 수 있다. 폴더를 믿는다고 등록하거나
--mode accept-edits. - "셸 명령은 쓰지 말고" 한 문장이 거절로 멈추는 일을 줄였다. 답의 범위는 직접 센다.
용어 정리
| 용어 | 읽는 법 | 한 줄 뜻 |
|---|---|---|
| Headless | 헤드리스 | 대화 화면 없이 한 번 실행하는 방식 |
| Soft-deny | 소프트 디나이 | 실행을 멈추지 않고 그 동작만 조용히 거절하기 |
| Workspace trust | 워크스페이스 트러스트 | 이 폴더를 믿는다고 등록하는 절차 |
| Exit code | 엑싯 코드 | 프로그램이 끝날 때 남기는 성공·실패 번호 |
이 장을 다 읽었나요?
기록은 이 브라우저에만 저장됩니다. 진행 현황은 전체 목차에서 볼 수 있어요.
다음 장: 7장. 비용·데이터·안전, 그리고 세 도구 고르기
참고 자료 (16개)
이 장은 2026년 11월 1일에 확인한 Antigravity 공식 문서와, macOS에서
agy1.4.12를 실행한 결과를 바탕으로 썼습니다. 이 가이드는 실습용 다른 AI 도구 안에서agy를 불러 실행했습니다. 공식 FAQ는 이런 사용을 개인 요금제에서 지원하지 않습니다(7장). ↩︎Antigravity 공식 문서, 「Get started」. "curl -fsSL antigravity.google | bash" antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Get started」. "|
agy| Launches the interactive TUI in the current directory. |" antigravity.google (확인일 2026-11-01) ↩︎Antigravity 공식 문서, 「Authenticate」. "If a valid token profile is found, the CLI authenticates your session silently without opening a browser." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Get started」. "Workspace trust: Confirm that you trust the repository directory before the agent begins file indexing." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Choose an execution mode」. "Press Shift + Tab inside the prompt box to cycle through the active sequence:
default>accept-edits>auto>plan>default." antigravity.google (확인일 2026-11-01) ↩︎Antigravity 공식 문서, 「Choose an execution mode」. "|
default| Pauses for interactive diff review before modifying or creating files, and asks before running terminal commands. | Standard development, reviewing sensitive code changes, and careful refactoring. |" / "|accept-edits| Automatically approves file creations and edits inside your workspace, but still asks before running terminal commands. | Rapid prototyping, iterating on trusted code, and reducing file-edit interruptions. |" antigravity.google (확인일 2026-11-01) ↩︎Antigravity 공식 문서, 「Headless mode」. "Headless mode (also called print mode) sends a single prompt to the agent, streams or returns the response, and exits." / "There is no interactive prompt in headless mode, so tools that would normally ask for confirmation are handled by policy." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Headless mode」. "Diagnostics—errors, authentication prompts, progress, and permission notices—go to
stderr." antigravity.google (확인일 2026-11-01) ↩︎Antigravity 공식 문서, 「Headless mode」. "Reading and writing files inside your active workspace is auto-allowed; actions such as shell commands default to Ask and are soft-denied in headless mode unless you grant them." antigravity.google (확인일 2026-11-01) ↩︎
Antigravity 공식 문서, 「Headless mode」. "A tool that requires approval it can’t obtain is soft-denied: the run continues, exits
0, and prints a notice tostderrnaming the tool and how to allow it." antigravity.google (확인일 2026-11-01) ↩︎Antigravity 공식 문서, 「CLI commands」. "|
trustedWorkspaces| string[] |[]| Folders you chose to trust when the CLI asked. The CLI adds entries for you. |" antigravity.google (확인일 2026-11-01) ↩︎Antigravity 공식 문서, 「Headless mode」. "Warning:
--dangerously-skip-permissionsapproves all tool calls, including file writes and command execution. Prefer scopedpermissions.allowrules unless you fully trust the prompt and environment." antigravity.google (확인일 2026-11-01) ↩︎Antigravity 공식 문서, 「Managing conversations」. "When you launch
agyfrom a specific directory, the agent only displays and resumes sessions associated with that specific local repository or subdirectory." antigravity.google (확인일 2026-11-01) ↩︎Antigravity 공식 문서, 「Managing conversations」. "Antigravity CLI supports both an interactive Session Picker TUI overlay and direct command-line flags (
agy -c/agy --continue) to resume threads instantly based on your active workspace." antigravity.google (확인일 2026-11-01) ↩︎Antigravity 공식 문서, 「Model quotas (/usage)」. "Antigravity CLI provides the
/usagecommand (alias/quota) to help you monitor your resource consumption." antigravity.google (확인일 2026-11-01) ↩︎