agy 명령어 인식 안됨, Antigravity CLI 오류 해결 (2026)

Antigravity CLI를 설치했는데 agy 명령어가 안 되나요? 대부분 PATH 설정 문제입니다.

오류: “agy: command not found”

해결 1: PATH 확인

1. which agy (Mac/Linux) 또는 where agy (Windows) 실행.
2. 경로가 안 나오면 PATH에 등록이 안 된 것입니다.
3. npm 전역 bin 경로 확인: npm bin -g
4. 해당 경로를 환경변수에 추가합니다.

해결 2: 재설치

npm install -g @anthropic-ai/antigravity

설치 완료 후 터미널을 껐다 다시 열고 agy --version으로 확인.

해결 3: Windows PowerShell 실행 정책

Windows에서 npm 전역 명령어가 안 되는 경우:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

이후 터미널을 재시작합니다.

오류: 권한 관련 프롬프트가 멈춤

agy 실행 시 동의 프롬프트에서 멈추는 경우:

agy --dangerously-skip-permissions -p "테스트"

이 옵션으로 동의 팝업을 건너뛸 수 있습니다. 자동화 스크립트에서 유용합니다.

오류: API 키 인증 실패

1. Google AI Studio에서 API 키가 활성 상태인지 확인.
2. 환경변수 설정: export GEMINI_API_KEY=your-key-here
3. Windows: set GEMINI_API_KEY=your-key-here

이 글은 2026년 7월 기준 실제 사용 경험을 바탕으로 작성되었습니다.