Skip to content

6장. 터미널에서 쓰기 — agy -p와 조용한 거절 ​

선택 필요할 때 읽으세요. 건너뛰어도 뒤 장을 따라갈 수 있습니다.

한 줄 요약: agy는 Antigravity의 터미널 프로그램이고, agy -p "할 일"은 한 번 실행하고 끝납니다. -p에서는 허락이 필요한 일이 조용히 거절됩니다. 그런데도 종료 코드(프로그램이 끝날 때 남기는 번호)는 **0(성공)**이라, 빈 결과를 성공으로 착각하기 쉽습니다.

터미널은 명령어를 글자로 쳐서 컴퓨터를 다루는 창입니다. 터미널이 처음이라면 이 장은 건너뛰어도 됩니다. 터미널을 더 알고 싶다면 Claude Code 10장을 보세요(선택).

이 장의 결과는 이 가이드가 macOS에서 agy를 실제로 돌려 본 것입니다. 따라 할 때는 터미널에서 agy를 직접 실행하세요.[1]

설치하고 시작하기 ​

macOS·Linux의 설치 명령은 이렇습니다.[2]

bash
curl -fsSL https://antigravity.google/cli/install.sh | bash

이 명령은 인터넷에서 받은 설치 프로그램을 바로 실행합니다. 그래서 공식 문서(antigravity.google/docs)에 적힌 그대로인지 확인하고 실행하세요. Windows용 명령도 공식 문서에 있습니다.

정리도구 폴더로 이동해 agy를 치면 대화 화면이 열립니다.[3] 아래 첫 줄의 cd는 그 폴더로 이동하는 명령입니다. 앱에서 이미 로그인했다면 브라우저 없이 바로 로그인됩니다.[4]

처음 실행할 때는 이 폴더를 믿는지 묻습니다(Workspace trust, 폴더를 믿는다고 등록하는 절차).[5] 정리도구 폴더는 내가 만든 폴더이니 믿는다고 답하면 됩니다. 이렇게 답해 두면 뒤에 나올 거절 함정 하나를 피할 수 있을 것입니다(이 가이드의 추정).

bash
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를 여러 번 돌리며 실제로 겪은 일입니다.

  1. 빈 결과인데 성공. 에이전트가 폴더 목록을 보려고 셸 명령(ls, 터미널에 치는 명령)을 쓰려다 거절당했습니다. 그러자 아무것도 만들지 않고 끝났습니다. 종료 코드는 0이었습니다. 이런 일이 세 번 있었습니다.
    • 할 일: 결과 파일이 실제로 생겼는지 꼭 확인하세요.
  2. 믿지 않은 폴더에서는 읽기·쓰기도 거절. 연습 폴더에서 파일 쓰기와 읽기까지 거절된 적이 있습니다. 이 폴더를 아직 "믿는 폴더"로 등록하지 않았던 것이 원인으로 보입니다(이 가이드의 추정).[12]
    • 할 일: 대화형 agy를 한 번 열어 폴더를 믿는다고 답하세요.[12:1]
  3. 해결: 모드 하나 + 한 문장. 명령 끝에 --mode accept-edits를 붙이고, 요청 끝에 "셸 명령은 쓰지 말고 파일 읽기·쓰기만 해 줘"를 더하자 모두 성공했습니다.
    • 모든 것을 허락하는 --dangerously-skip-permissions 옵션은 쓰지 마세요.
    • --로 시작하는 이런 글자를 옵션이라고 합니다. 명령 뒤에 붙여 실행 방식을 바꿉니다. --mode accept-edits는 위 표의 accept-edits 모드로 실행하라는 뜻입니다. 아래 명령의 맨 끝에서 볼 수 있습니다.
  4. 답이 빠뜨린 파일. 읽기 전용으로 notes 폴더의 파일 목록을 표로 달라고 했습니다. 정리한 파일은 3개(주간회의 회의록·임시회의 회의록·주간 회고)였습니다. 그런데 표에는 임시회의 회의록이 빠지고 대신 빈 파일 .gitkeep이 들어갔습니다.
    • 할 일: 확인 범위를 스스로 세어 보세요.
자세히 (눌러서 펼치기)
  • 2번: 공식 문서는 작업 폴더 안 파일을 자동 허락한다고 합니다. 그런데도 거절되어, 위처럼 믿는 폴더 등록을 원인으로 짐작했습니다.[12:2]
  • 3번: 모든 것을 허락하는 --dangerously-skip-permissions는 쓰지 않았습니다. 공식 문서도 범위를 좁힌 허용 규칙을 권합니다.[13]

실제로 쓴 명령은 이렇습니다.

bash
cd ~/hello-ai-연습/정리도구
agy -p "notes 폴더의 파일 목록을 보여 주고, 각 파일이 어떤 양식(templates 중 무엇)으로 쓰였는지 한 줄씩 알려 줘. 파일은 고치지 마. 답은 짧게 표로만. 셸 명령은 쓰지 말고 파일 읽기만 해 줘." --mode accept-edits

결과: agy -p 출력(내 컴퓨터의 경로는 ~로 바꿈)

Claude CodeCodexAntigravity
한 번 실행claude -pcodex execagy -p
기본 파일 쓰기허락 필요읽기 전용작업 폴더 안 자동(문서)
막히면거절멈춤조용히 거절, 종료 코드 0

출처: 이 가이드의 정리(각 도구의 터미널 장과 실습)

확인 퀴즈

agy -p가 성공(종료 코드 0)으로 끝났는데 결과 파일이 없습니다. 이 가이드의 경험상 먼저 할 일은 무엇일까요?

이어 가기와 사용량 ​

터미널의 대화 기록은 실행한 폴더별로 나뉩니다.[14] agy -c로 그 폴더의 마지막 대화를 바로 잇거나, /resume으로 골라 이어 갑니다.[15] /rewind(또는 /undo)는 대화를 앞의 메시지로 되돌립니다(4장). 파일까지 돌아오는지는 공식 문서에 나오지 않으니, 파일은 Git 기록을 믿으세요.

사용량은 /usage로 봅니다.[16]

확인 퀴즈

agy에서 이 폴더의 마지막 대화를 바로 이어 가는 방법은 무엇일까요?

직접 해 보기 ​

  1. 공식 문서의 설치 명령과 위 명령이 같은지 확인한 뒤 설치한다(이미 있으면 agy --version).
  2. 정리도구 폴더에서 대화형 agy를 한 번 열고, 폴더를 믿는지 묻으면 답한다.
  3. 위의 읽기 전용 agy -p를 실행하고, 표의 파일 수를 notes 폴더와 맞춰 센다.
  4. 결과가 비었으면 stderr의 거절 안내를 읽고, 무엇이 막혔는지 확인한다.

이어지는 과제: 7장에서는 비용·데이터·안전을 정리하고, 세 도구를 어떻게 함께 쓸지 정합니다.

정리 ​

  • agy는 대화형, agy -p는 한 번 실행하고 끝. 대화 기록은 폴더별.
  • -p에서 허락이 필요한 일은 조용히 거절되고 종료 코드는 0. 결과 파일을 직접 확인한다.
  • 믿지 않은 폴더에서는 파일 작업도 막힐 수 있다. 폴더를 믿는다고 등록하거나 --mode accept-edits.
  • "셸 명령은 쓰지 말고" 한 문장이 거절로 멈추는 일을 줄였다. 답의 범위는 직접 센다.

용어 정리 ​

용어읽는 법한 줄 뜻
Headless헤드리스대화 화면 없이 한 번 실행하는 방식
Soft-deny소프트 디나이실행을 멈추지 않고 그 동작만 조용히 거절하기
Workspace trust워크스페이스 트러스트이 폴더를 믿는다고 등록하는 절차
Exit code엑싯 코드프로그램이 끝날 때 남기는 성공·실패 번호

이 장을 다 읽었나요?

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

다음 장: 7장. 비용·데이터·안전, 그리고 세 도구 고르기

참고 자료 (16개)
  1. 이 장은 2026년 11월 1일에 확인한 Antigravity 공식 문서와, macOS에서 agy 1.4.12를 실행한 결과를 바탕으로 썼습니다. 이 가이드는 실습용 다른 AI 도구 안에서 agy를 불러 실행했습니다. 공식 FAQ는 이런 사용을 개인 요금제에서 지원하지 않습니다(7장). ↩︎

  2. Antigravity 공식 문서, 「Get started」. "curl -fsSL antigravity.google | bash" antigravity.google (확인일 2026-11-01) ↩︎

  3. Antigravity 공식 문서, 「Get started」. "| agy | Launches the interactive TUI in the current directory. |" antigravity.google (확인일 2026-11-01) ↩︎

  4. Antigravity 공식 문서, 「Authenticate」. "If a valid token profile is found, the CLI authenticates your session silently without opening a browser." antigravity.google (확인일 2026-11-01) ↩︎

  5. Antigravity 공식 문서, 「Get started」. "Workspace trust: Confirm that you trust the repository directory before the agent begins file indexing." antigravity.google (확인일 2026-11-01) ↩︎

  6. 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) ↩︎

  7. 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) ↩︎

  8. 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) ↩︎

  9. Antigravity 공식 문서, 「Headless mode」. "Diagnostics—errors, authentication prompts, progress, and permission notices—go to stderr." antigravity.google (확인일 2026-11-01) ↩︎

  10. 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) ↩︎

  11. Antigravity 공식 문서, 「Headless mode」. "A tool that requires approval it can’t obtain is soft-denied: the run continues, exits 0, and prints a notice to stderr naming the tool and how to allow it." antigravity.google (확인일 2026-11-01) ↩︎

  12. 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) ↩︎

  13. Antigravity 공식 문서, 「Headless mode」. "Warning: --dangerously-skip-permissions approves all tool calls, including file writes and command execution. Prefer scoped permissions.allow rules unless you fully trust the prompt and environment." antigravity.google (확인일 2026-11-01) ↩︎

  14. Antigravity 공식 문서, 「Managing conversations」. "When you launch agy from a specific directory, the agent only displays and resumes sessions associated with that specific local repository or subdirectory." antigravity.google (확인일 2026-11-01) ↩︎

  15. 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) ↩︎

  16. Antigravity 공식 문서, 「Model quotas (/usage)」. "Antigravity CLI provides the /usage command (alias /quota) to help you monitor your resource consumption." antigravity.google (확인일 2026-11-01) ↩︎