Antigravity 2.0을 데스크톱 앱이 아니라 터미널에서 쓰고 싶은 개발자들이 많아요. 터미널 작업 흐름을 벗어나지 않고 곧바로 에이전트를 호출할 수 있다는 게 CLI의 가장 큰 매력인데, 설치 방법부터 데스크톱 앱과의 차이까지 정리해볼게요.
Antigravity CLI 설치 방법
터미널에서 Antigravity를 쓰려면 별도의 CLI 패키지를 설치해야 해요. 설치 명령어는 다음과 같아요.
curl -fsSL https://antigravity.google/cli/install.sh | bash
이 스크립트 한 줄을 터미널에 입력하면 agy 명령어를 사용할 수 있는 CLI가 설치돼요. 여기서 중요한 점은 Antigravity 2.0 데스크톱 앱이 이미 설치돼 있어도 터미널에서 agy 명령어를 쓰려면 CLI를 별도로 설치해야 한다는 거예요. 데스크톱 앱과 CLI는 서로 독립적으로 설치·관리되는 별개의 패키지예요.
agy 명령어로 에이전트 호출하기
CLI 설치가 끝나면 터미널 창에서 명령어 한 줄만으로 즉시 에이전트를 불러와 작업을 시킬 수 있어요. 새로운 Antigravity CLI는 기존 Gemini CLI보다 훨씬 빠르고 가벼워졌다는 평가를 받고 있는데, 이는 agy CLI 자체가 Go 언어로 작성돼 실행 속도가 빠른 바이너리 형태이기 때문이에요.
터미널 기반 워크플로우의 장점은 별도의 창 전환 없이 코드 작업 중이던 터미널 세션 안에서 바로 에이전트에게 작업을 위임할 수 있다는 점이에요. 예를 들어 git 명령어를 쓰던 흐름 그대로 agy 명령어를 이어서 입력해 리팩터링이나 테스트 코드 생성을 맡길 수 있어요. 스크립트나 자동화 파이프라인에 명령어를 끼워 넣어 CI/CD 단계에서 에이전트를 호출하는 것도 가능한 구조예요.
터미널 명령 실행과 보안 프리셋
터미널에서 에이전트를 쓸 때는 에이전트가 실제 셸 명령을 실행할 수 있다는 점을 특히 신경 써야 해요. Antigravity 2.0은 보안 프리셋으로 이 위험을 관리하는데, Default 설정에서는 작업 폴더 바깥의 터미널 명령이나 파일 접근이 필요할 때만 수동 승인을 요구해요. Full Machine 설정은 모든 터미널 명령에 검토가 필요한 대신 컴퓨터 전체 파일 접근을 허용하고, Unrestricted 설정은 이런 안전 장치를 모두 비활성화해요.
터미널 환경은 데스크톱 앱보다 실행 결과가 즉각적으로 시스템에 반영되는 경우가 많기 때문에, 처음 CLI를 쓸 때는 Default 설정을 유지하면서 에이전트가 어떤 명령을 실행하려 하는지 승인 창을 통해 확인하는 습관을 들이는 게 안전해요. 특히 삭제나 배포처럼 되돌리기 어려운 명령이 포함된 작업은 승인 단계를 꼼꼼히 살펴보는 게 좋아요.
데스크톱 앱과 CLI, 언제 뭘 써야 할까
데스크톱 앱은 여러 에이전트를 동시에 조율하며 각각의 진행 상황을 시각적으로 확인하고 싶을 때, 또는 리팩터링처럼 여러 파일에 걸친 복잡한 작업을 한눈에 관리하고 싶을 때 적합해요. 반면 터미널 CLI는 이미 터미널 중심으로 개발하는 사람이 컨텍스트 전환 없이 빠르게 에이전트를 호출하고 싶을 때, 또는 스크립트·CI 파이프라인에 에이전트 호출을 통합하고 싶을 때 더 적합해요.
두 접점 모두 동일한 에이전트 하네스와 Gemini 3.7 Flash 모델을 기반으로 동작하기 때문에, 어느 쪽을 쓰든 에이전트의 판단 품질 자체는 차이가 없어요. 다만 데스크톱 앱은 시각적 워크스페이스 관리에, CLI는 터미널 워크플로우 통합에 강점이 있다는 정도로 구분해서 상황에 맞게 선택하면 돼요.
기존 Gemini CLI 사용자를 위한 참고사항
기존 Gemini CLI를 쓰던 사용자라면 마이그레이션이 필요해요. Gemini CLI는 Google AI Pro, AI Ultra, 무료 요금제 사용자를 대상으로 2026년 6월 18일부로 서비스가 종료됐기 때문에, 계속 터미널에서 구글 코딩 에이전트를 쓰려면 새로운 agy CLI로 넘어와야 해요. 명령어 체계나 설정 파일 위치가 기존 Gemini CLI와 다를 수 있으니, 기존에 쓰던 자동화 스크립트가 있다면 새 CLI 문법에 맞게 점검해보는 게 필요해요.
정리하면 Antigravity 2.0 터미널 사용은 curl 명령으로 CLI를 설치하는 것부터 시작하고, agy 명령어로 즉시 에이전트를 호출할 수 있어요. 데스크톱 앱과는 독립적으로 설치해야 한다는 점과 보안 프리셋을 상황에 맞게 설정하는 것, 그리고 기존 Gemini CLI에서 넘어온 경우 마이그레이션이 필요하다는 점을 기억해두면 좋아요.