2026-10-03 새벽 빈 폴더에서 안티그래비티 CLI(agy)로 안티그래비티 사용법을 상황별로 따라 해 보니, 버그 3개는 13초, 33줄 코드는 8초, 8줄 셸 스크립트 설명은 33초 만에 답이 왔습니다. 그런데 처음 보낸 요청 두 번은 권한 거부로 아무것도 남기지 않았고, 종료 코드는 0이었습니다.
안녕하세요? 정리하는 개발자 워니즈입니다. IDE 가 아니라 터미널용 Antigravity CLI 로 해 본 안티그래비티 사용법을 상황별로 정리했고, 이번 시험을 위해 새로 가입한 서비스는 없습니다.
- 무엇을 했나 안티그래비티 사용법의 기본은 작업 폴더에서
agy -p "할 일"한 줄을 보내는 것이고, 저는 agy 1.2.12 로 세 상황에 요청 아홉 개를 보냈습니다 - 결과 숫자 읽고 답하는 일(버그 3개 13초, 설명 33초)은 바로 됐고, 파일 쓰기와 명령 실행은 거부돼 요청 문장을 바꾼 뒤에야 결과가 나왔습니다(8초, 33초)
- 누구에게 쓸모 터미널에서 AI 에게 버그 찾기와 코드 설명을 맡겨 보려는 개발자, 그리고 그 결과를 스크립트로 받으려는 분께 맞습니다
| 상황 | 막힌 요청 | 통한 요청 | 걸린 시간 |
|---|---|---|---|
| 디버깅 | 없음 | “고치지 말고 문제와 고칠 방법만” | 13초 |
| 새 기능 | “현재 폴더에 만들어 줘”(write_file 거부) | “파일은 만들지 말고 코드만 출력” | 8초 |
| 코드 공부 | “실행하지는 마”(command 거부) | “터미널 명령은 쓰지 말고 파일 읽기만” | 33초 |
| 기본 모델 | 429 오류(종료 코드 3) | --model claude-sonnet-4-6 |
5초 |
1. 안티그래비티 사용법, 세 가지를 시켜 보니 몇 초 걸렸을까?
짧게는 8초, 길게는 33초였습니다. 2026-10-03 05:13~05:17 KST, macOS 27.0 arm64 와 agy 1.2.12 로 /tmp 아래 새 폴더 세 개에서만 돌렸고, 시간은 명령 앞뒤 date +%s 의 차이입니다. 이날 기본 모델이 429 로 끝나 세 상황 모두 Claude Sonnet 4.6 으로 돌렸습니다.
권한이 거부돼 아무것도 만들지 못한 두 번도 종료 코드는 0이었습니다. 이 안티그래비티 사용법을 스크립트로 옮긴다면 종료 코드가 아니라 결과 파일이나 답 내용으로 성공을 판정해야 합니다.
2. 디버깅할 때 버그 3개를 찾게 하려면?
파일이 있는 폴더에서 범위를 묶어 묻습니다. 22줄짜리 orders.py 에 흔한 실수 셋을 심어 두고 파일은 고치지 말고 문제가 있는 함수와 고칠 방법만 알려 달라고 보내자 13초 만에 셋 다 줄 번호와 함께 짚었고, 빠진 것도 지어낸 것도 없었습니다. 답 뒤에도 파일은 그대로였습니다.
| 함수 | 심어 둔 문제 | agy 가 짚은 줄 |
|---|---|---|
| average_price | 빈 목록이면 0으로 나눔 | 5번 줄, ZeroDivisionError |
| add_tag | 기본값 tags=[] 를 호출끼리 공유 |
8번 줄, 가변 기본 인자 |
| page | 끝 인덱스에서 1을 더 뺌 | 15번 줄, off-by-one |
가변 기본 인자 설명은 파이썬 공식 튜토리얼의 기본 인자 값 절과 같았습니다. 다만 버그 위치를 제가 미리 아는 파일이었고, 실제 코드에서 무엇을 놓치는지는 이 기록으로 말할 수 없습니다.
3. 새 기능을 만들 때 ‘만들어 줘’ 대신 무엇이라고 해야 하나요?
“코드만 출력해 줘” 입니다. “현재 폴더에 wordcount.py 를 만들어 줘” 는 14초 뒤 아래 문구만 남기고 끝났고 폴더는 비어 있었습니다.
a tool required the “write_file” permission that headless mode cannot prompt for, so it was auto-denied.
“파일은 만들지 말고 코드만 출력” 으로 바꾸자 8초에 33줄이 왔고, 저장해 돌리니 동작했습니다. 그런데 시험 글에서 Apple 과 banana. 를 다른 단어로 세어 apple 을 3회로 냈습니다. -c 로 대화를 이어 대소문자와 문장부호를 떼게 하자 8초에 37줄 코드가 왔고 사람이 센 값(apple 4회, banana 3회)과 같아졌습니다.
오류 없이 도는 코드의 빈틈은 사람이 일부러 까다로운 입력을 넣어야 보였습니다. 테스트를 통과했는데 틀렸던 비슷한 일은 테스트는 통과했는데 261편 중 6편만 맞았다에 적었습니다.
4. 코드 공부할 때 실행 권한 거부를 피하려면?
쓸 도구를 직접 적습니다. 8줄짜리 backup.sh 를 “줄마다 설명, 실행하지는 마” 로 물었더니 7초 만에 command 권한 거부로 끝났고, “터미널 명령은 쓰지 말고 파일 읽기만” 을 앞에 붙이자 33초 만에 8줄 전부를 한국어로 풀었습니다. -c 로 “처음 돌리기 전 조심할 점 세 줄” 을 묻자 14초 만에 가장 위험한 줄을 짚었습니다.
7번째 줄의
-delete때문에~/backups/안에 있는 7일 이상 된.tar.gz파일이 모두 즉시 삭제됩니다.
-c 는 앞 대화의 파일을 기억했고, --output-format json 은 status 와 response 를 따로 줘서 스크립트로 받기 편했습니다(출력은 부록). 권한을 어디까지 열지는 AI 에이전트 권한 설계에서 다룬 적이 있습니다.
5. 안티그래비티는 무료인가요, 그리고 안 되는 것은?
요금표와 무료 범위는 이번에 공식 문서로 확인하지 못했습니다. 안티그래비티 사용법을 따라 하다 보면 먼저 한도 오류를 만날 수 있습니다. 기본 모델과 제미나이 모델 두 개는 “Individual quota reached. Please upgrade your subscription to increase your limits.” 로 끝났고, Claude 와 GPT 쪽 모델로 바꾸자 5초 만에 답했습니다. /usage 화면에는 모델 묶음마다 주간 한도와 5시간 한도 행이 따로 있었습니다(비율 값은 가림). 가격은 Google Antigravity 공식 사이트에서 확인하셔야 합니다.
같은 날 agy models 목록 14개에 제미나이 4 는 없었습니다(3.8 Flash ~ 3.1 Pro). 설치, IDE, 제미나이 모델로 같은 세 상황, 파일 쓰기 허용 규칙은 다루지 않았습니다(부록 표).
필자의 결론
안티그래비티 CLI 는 기본 권한 그대로 두고, 파일을 읽거나 코드를 답으로 받는 일에만 씁니다.
“만들어 줘” 대신 “코드만 출력”, “실행하지는 마” 대신 “파일 읽기만” 이라고 쓰면 거부가 결과로 바뀌었습니다.
오늘은 최근 고친 버그가 있던 파일 하나를 빈 폴더에 복사하고 “고치지 말고 줄 번호와 이유만” 물어 보세요.
안티그래비티 IDE 와 CLI 를 둘 다 써 보신 분은, 같은 요청을 IDE 에서는 권한을 어떻게 묻던가요?
부록: 재현 명령과 출력
- 시작 명령. 이 맥에는 agy 가 이미 깔려 있고 로그인돼 있었습니다(설치는 범위 밖).
agy --version
agy models
cd /tmp/agy-howto-1003/new
agy -p "ok 라고만 답해" --model claude-sonnet-4-6- 보낸 요청 아홉 개(순서대로).
| 상황 | 보낸 요청(요지) | 걸린 시간 | 종료 코드 | 결과 |
|---|---|---|---|---|
| 확인 | 기본 모델로 “ok 라고만 답해” | 6초 | 3 | 429 오류, 답 없음 |
| 확인 | 같은 요청, Claude Sonnet 4.6 | 5초 | 0 | ok |
| 디버깅 | orders.py 버그를 고치지 말고 알려 달라 | 13초 | 0 | 심어 둔 버그 3개 모두 찾음 |
| 새 기능 | 현재 폴더에 wordcount.py 를 만들어 달라 | 14초 | 0 | 파일 쓰기 권한 거부, 파일 없음 |
| 새 기능 | 파일은 만들지 말고 코드만 출력 | 8초 | 0 | 33줄 코드, 저장해 돌리니 동작 |
| 새 기능 | 대소문자와 문장부호를 정리하도록 고쳐 달라 | 8초 | 0 | 37줄 코드, 세는 값이 바로잡힘 |
| 코드 설명 | backup.sh 를 줄마다 설명, 실행하지는 마 | 7초 | 0 | 명령 실행 권한 거부, 답 없음 |
| 코드 설명 | 터미널 명령은 쓰지 말고 파일 읽기만 | 33초 | 0 | 8줄 모두 한국어 설명 |
| 코드 설명 | 처음 돌리기 전 조심할 점 세 줄 | 14초 | 0 | 삭제 범위 경고 포함 3줄 |
- orders.py 직접 실행(Python 3.14.7). 빈 목록이면
ZeroDivisionError: division by zero도 따로 확인했습니다.
$ python3 orders.py
2000.0
['new']
['new', 'sale']
[10, 11, 12, 13, 14, 15, 16, 17, 18]- JSON 출력(대화 식별값은 가림). 두 글자 답에도 입력이 10,194 토큰이었고,
duration_seconds는 0.92초인데 명령 전체는 4초였습니다.
$ agy -p "ok 라고만 답해" --model gpt-oss-120b-medium --output-format json
{"conversation_id":"(가림)","status":"SUCCESS","response":"ok\n","duration_seconds":0.922087,"num_turns":1,"usage":{"input_tokens":10194,"output_tokens":25,"thinking_tokens":0,"cache_read_tokens":0,"total_tokens":10219}}- 확인하지 못한 것. 요금표와 등급 차이(공식 요금 문서를 열지 않음), 설치 과정, IDE 사용법, 제미나이 모델로 같은 세 상황(이날 429), 파일 쓰기 허용 규칙과 전부 허용 플래그(기본값으로만 진행),
--effort,--mode,--sandbox(도움말만 봄), 다른 폴더 대화 직후의-c, 같은 요청을 다시 보냈을 때 같은 답인지. - 곁가지. 시간은 초 단위 벽시계라 표의 5초는 실제로 4초대에서 5초대 사이였을 수 있습니다. 규칙 파일 없이도 한국어 요청에는 한국어로 답했습니다. 규칙 파일이 안 읽히는 증상은 AGENTS.md 안 읽힐 때 해결 방법 총정리에, 다른 AI 코딩 도구의 무료 범위는 커서 AI 무료 한도 총정리, 공식 문서 기준에 있습니다.
agy changelog의 1.2.15 항목에는 크레딧 잔액 부족 문구와 권한 요청 우회 방지 수정이 있었지만, 설치된 1.2.12 기준으로 썼습니다. - 출처. 직접 재현 2026-10-03 05:13~05:17 KST, macOS 27.0 arm64, agy 1.2.12,
/tmp아래 빈 폴더 세 개, 권한 기본값.agy --help,agy models,agy changelog,agy -p "/usage"출력은 같은 날 같은 환경.
새 글이 올라오면 Threads @wonizz.ai 에도 올립니다. 팔로우해 두면 피드에서 바로 볼 수 있습니다.