antigravity 설치 위치 확인 방법 CLI 경로 캐시 폴더

Antigravity는 구글이 2025년 11월에 공개한 AI 기반 개발 플랫폼이에요. 자율 코딩 에이전트를 품은 IDE와 터미널에서 바로 쓸 수 있는 CLI로 나뉘는데, 두 가지 모두 운영체제별로 설치 위치가 조금씩 달라서 헷갈리기 쉬워요. 여기서는 실제로 파일이 어디에 놓이는지, 확인하려면 어떻게 해야 하는지 정리해봤어요.

Antigravity CLI 설치 경로

맥과 리눅스에서 CLI를 설치할 때는 curl -fsSL https://antigravity.google/cli/install.sh | bash 명령을 실행하는데, 이 스크립트는 기본적으로 실행 파일을 ~/.local/bin/agy 경로에 등록해요. 즉 홈 디렉토리 아래 숨김 폴더인 .local/bin에 agy라는 이름으로 바이너리가 생기는 거예요.

설치가 끝난 뒤 새 터미널 창을 열면 PATH에 해당 경로가 자동으로 추가돼 있어서 어느 디렉토리에서든 agy 명령으로 바로 실행할 수 있어요. 만약 명령을 찾을 수 없다는 오류가 나온다면 셸 설정 파일(.zshrc, .bashrc 등)에 해당 경로가 제대로 추가됐는지 확인해봐야 해요.

윈도우에서는 CLI 설치 명령이 다르게 동작해요. curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd 형태로 배치 파일을 내려받아 실행하는 방식이라 설치 위치도 리눅스·맥과는 다른 사용자 폴더 하위에 놓여요.

IDE 설치 위치

Antigravity IDE는 antigravity.google/download에서 운영체제별 설치 파일을 받아 설치하는 독립 데스크톱 애플리케이션이에요. 맥에서는 애플리케이션 폴더에, 윈도우에서는 일반적인 프로그램 설치 경로에 놓이는 방식이라 다른 데스크톱 앱과 크게 다르지 않아요.

다만 로그인 루프 같은 문제를 겪는 사용자 사례를 보면 윈도우에서는 C 드라이브에 설치하는 걸 권장하는 경우가 많아요. 다른 드라이브에 설치했을 때 로그인이나 인증 관련 오류가 잦다는 보고가 있기 때문이에요.

캐시 및 설정 파일 위치

Antigravity를 쓰다가 실행이 자꾸 실패하거나 확장 기능이 꼬였을 때는 캐시 폴더를 지우는 방법이 많이 쓰여요. 캐시는 ~/.config/antigravity/cache 경로에 저장되는데, 이 폴더를 삭제하고 다시 실행하면 캐시 관련 오류가 해결되는 경우가 많아요.

  • ~/.local/bin/agy – 리눅스·맥 CLI 실행 파일 경로예요.
  • ~/.config/antigravity/cache – 확장 기능 캐시와 임시 데이터가 저장되는 폴더예요.
  • IDE 애플리케이션 폴더 – 맥은 Applications, 윈도우는 프로그램 설치 경로에 데스크톱 앱 본체가 위치해요.

리눅스에서 설치 경로 확인하는 명령

우분투 같은 리눅스 배포판에서는 which agy 명령으로 CLI 실행 파일이 실제로 어디에 등록됐는지 바로 확인할 수 있어요. 만약 여러 개의 경로에 중복 설치된 흔적이 있다면 오래된 버전이 남아있는 것이니 정리해주는 게 좋아요.

일부 사용자는 리눅스 환경에서 CLI가 설치하는 완성 스크립트(completion script)의 권한이 지나치게 열려있는 문제를 겪기도 해요. 이런 경우 chmod와 chown 명령으로 권한을 다시 잠가주는 방식으로 해결한다고 안내되고 있어요.

설치 위치를 알아야 하는 이유

설치 위치를 정확히 알고 있으면 재설치나 완전 삭제, 오류 진단이 훨씬 쉬워져요. 특히 npm으로 관련 패키지를 설치할 때 시스템 디렉토리에 권한 없이 쓰려다 오류가 나는 경우가 있는데, 이럴 때는 nvm(Node Version Manager)으로 Node.js를 관리하면 권한 문제 없이 사용자 홈 디렉토리 안에서 모든 설치가 이뤄지도록 바꿀 수 있어요.

설치 위치를 모른 채 무작정 재설치를 반복하면 예전 캐시나 설정 파일이 남아 같은 오류가 반복될 수 있어요. 경로를 파악해두면 문제가 생겼을 때 해당 폴더만 지우고 깔끔하게 다시 시작할 수 있어요.

맥에서 설치 위치 확인하기

맥에서는 리눅스와 마찬가지로 터미널에서 which agy 명령을 입력하면 CLI 실행 파일 경로를 바로 확인할 수 있어요. IDE 본체는 Finder에서 애플리케이션 폴더를 열어 Antigravity 아이콘이 있는지 확인하면 되는데, 맥 애플리케이션은 실제로는 하나의 파일처럼 보이지만 내부적으로는 여러 리소스 파일을 담은 패키지 구조로 돼 있어요.

맥에서 설치 위치를 옮기고 싶다면 Finder에서 애플리케이션을 다른 폴더로 드래그하면 되지만, CLI 바이너리는 설치 스크립트가 지정한 경로에서 벗어나면 PATH 인식이 끊길 수 있어서 임의로 옮기지 않는 게 안전해요.

설치 위치가 꼬였을 때 대처법

이전 버전을 삭제하지 않고 재설치를 반복하면 같은 이름의 실행 파일이나 폴더가 여러 경로에 중복으로 남는 경우가 생겨요. 이런 상태에서는 어떤 버전이 실제로 실행되는지 알 수 없어서 오류 원인을 찾기가 훨씬 어려워져요.

이럴 때는 which -a agy 명령으로 시스템에 등록된 모든 agy 실행 파일 경로를 한 번에 확인하고, 필요 없는 구버전 경로의 파일을 직접 삭제해서 정리하는 방법이 효과적이에요. 정리 후에는 새 터미널을 열어 정상적으로 최신 버전만 인식되는지 다시 확인하는 걸 추천해요.

정리하면 Antigravity CLI는 리눅스·맥 기준 ~/.local/bin/agy에, 캐시는 ~/.config/antigravity/cache에 저장돼요. IDE 본체는 운영체제의 일반적인 애플리케이션 설치 경로를 따르고요. 문제가 생겼을 때는 이 경로들을 먼저 확인해보는 게 해결의 첫걸음이에요.

댓글 남기기