Antigravity CLI 사용법, 설치부터 스킬 생성까지 완벽 가이드
2026년 5월 열린 Google I/O 2026에서는 개발자들이 주목할 만한 변화가 공개됐습니다. 바로 Gemini CLI의 종료와 Antigravity CLI로의 전환입니다.
AI CLI 도구의 흐름이 단순 코드 보조를 넘어 멀티에이전트 기반 작업 환경으로 이동하면서, 구글 역시 기존 Gemini CLI를 Antigravity CLI 중심으로 재편하기 시작했습니다.
Antigravity CLI는 터미널 기반으로 작동하는 새로운 에이전트형 CLI입니다. 기존 Gemini CLI의 터미널 사용 경험을 이어가면서도, 안티그래비티 2.0 데스크톱 애플리케이션과 동일한 하네스를 공유해 더 확장된 에이전트 개발 흐름을 제공합니다.
이를 통해 사용자는 CLI 환경에서도 멀티에이전트 작업, 백그라운드 실행, 프로젝트 단위 자동화 흐름을 보다 체계적으로 사용할 수 있게 됩니다.
이번 글에서는 Antigravity CLI가 기존 Gemini CLI와 무엇이 다른지, 어떻게 설치하고 실행하는지, 실무에서는 어떤 방식으로 활용할 수 있는지 정리해보겠습니다.
Antigravity CLI(안티그래비티 CLI) 핵심 요약
Antigravity CLI가 무엇인지 이해할 수 있습니다. Go 기반으로 재작성된 터미널 AI 에이전트로, Gemini CLI와 어떻게 다른지 설치 방법부터 핵심 작동 구조까지 파악할 수 있습니다.
Gemini CLI에서 전환해야 하는 이유와 시점을 알 수 있습니다. 2026년 6월 18일 Gemini CLI 서비스 종료를 앞두고, 무엇이 유지되고 무엇이 바뀌었는지 구체적인 마이그레이션 맥락과 함께 이해할 수 있습니다.
실무에서 어떻게 활용할 수 있는지 확인할 수 있습니다. CI/CD 자동화, 반복 스크립트 처리, 백그라운드 멀티 에이전트 실행까지 터미널 환경에서 바로 적용 가능한 활용법을 얻을 수 있습니다.
요금제 구조와 사용 시 주의사항을 파악할 수 있습니다. Google AI Pro부터 AI Ultra까지 플랜별 차이를 확인할 수 있으며, 자율 실행 특성상 반드시 알아야 할 주의사항을 정리했습니다.
Antigravity CLI(안티그래비티 CLI) 란?
Antigravity CLI(안티그래비티 CLI)는 GUI 없이 터미널에서 AI 에이전트를 직접 실행하고 지휘할 수 있는 구글의 터미널 기반 AI 개발 도구입니다.
2026년 5월 구글 I/O 2026에서 안티그래비티 2.0과 함께 공개되며, 기존 Gemini CLI를 공식적으로 대체하는 것으로 발표되었습니다.
agy라는 짧은 명령어 하나로 즉시 에이전트를 실행할 수 있으며, 안티그래비티 2.0 데스크톱 앱과 동일한 에이전트 엔진을 공유합니다. 즉, GUI 없는 서버 · CI/CD 환경에서도 데스크톱 앱과 동일한 수준의 에이전트 오케스트레이션이 가능합니다.
Antigravity CLI가 주목받는 이유
1. Gemini CLI 서비스 종료
구글은 2026년 6월 18일부터 Gemini CLI와 Gemini Code Assist IDE 확장의 요청 처리를 중단하고,Antigravity CLI로 전환할 것을 발표했습니다. 이에 따라 Gemini CLI의 주요 기능과 터미널 기반 사용 경험은 Antigravity CLI로 이어질 예정입니다.
2. Node.js에서 Go로, 체감되는 속도 차이
기존 Gemini CLI는 Node.js 기반으로 동작해 실행 시 런타임 초기화에 시간이 소요됐고, 복잡한 작업에서 메모리 사용량이 높아지는 문제가 있었습니다. 터미널 작업의 특성상 응답 지연은 개발 흐름을 끊는 직접적인 불편으로 이어집니다.
이와 달리 Antigravity CLI는 Go 언어로 재작성됐습니다. Go는 컴파일 언어 특성상 시작 속도와 메모리 효율이 Node.js 대비 구조적으로 유리해, 시작과 응답 속도가 더 빨라졌습니다.
3. 안티그래비티 2.0과 동일한 에이전트 엔진 공유
Antigravity CLI는 안티그래비티 2.0 데스크톱 애플리케이션과 동일한 하네스를 공유합니다. 덕분에 데스크탑 앱에서 사용하던 Skills · Hooks · Subagents · MCP 서버 · 플러그인 · 권한 제어 · 슬래시 명령어를 터미널에서도 모두 사용할 수 있습니다.
이제 Antigravity CLI 사용자는 터미널과 데스크탑 앱에서 모두 동일하게 작동하는 에이전트 워크플로를 구축할 수 있게 된 것입니다.
Antigravity CLI 사용법,
처음 사용하는 분이라면 참고하세요.
Antigravity CLI 설치하기
| curl -fsSL https://antigravity.google/cli/install.sh | bash |
터미널에 위의 명령어를 입력해 Antigravity CLI를 설치합니다. Antigravity 2.0 데스크톱 앱이 설치되어 있어도, 터미널에서 agy 명령어를 사용하려면 Antigravity CLI를 별도로 설치해야 합니다.
설치가 완료된 뒤 agv 명령어를 입력하면 Antigravity CLI가 실행되고 터미널 컬러를 설정하는 화면이 나옵니다. 원하는 컬러를 선택한 뒤 Enter를 누릅니다.
Antigravity CLI의 약관 및 데이터 사용 동의 화면이 나옵니다. ‘Antigravity CLI 개선을 위해 내 상호작용 데이터를 Google이 수집 · 사용하는 것에 동의한다’는 선택 항목입니다. 동의를 원하면 [x]를 원하지 않으면 [ ]로 설정한뒤 아래의 Done을 선택하고 Enter를 누릅니다.
Antigravity CLI를 실행하면 현재 폴더를 신뢰할 것인지 묻는 화면이 나타납니다. 시스템 폴더에 권한을 허용하면 불필요한 위험이 생길 수 있으므로, 반드시 내가 작업할 프로젝트 폴더로 이동한 뒤 실행해야 합니다.
폴더 설정이 완료되면 Antigravity CLI를 사용할 수 있습니다. 초기 모델이 Gemini 3.5 Flash로 설정된 것을 볼 수 있습니다.
스킬 설치 및 활용하기
Antigravity CLI에서는 스킬을 저장하는 위치가 크게 3가지로 나뉩니다.
위치 | 사용 범위 | 추천 상황 |
.agents/skills/{skill_name}/SKILL.md | 현재 프로젝트에서만 사용 | 특정 프로젝트 전용 스킬 |
~/.gemini/antigravity-cli/skills/{skill_name}/SKILL.md | Antigravity CLI 전체에서 사용 | CLI에서만 쓸 개인 스킬 |
~/.gemini/skills/{skill_name}/SKILL.md | Antigravity 계열 전체에서 공유 | 데스크톱 앱과 CLI에서 함께 쓸 스킬 |
스킬은 별도의 Mark Down 파일로 저장할 수 있고, Antigravity CLI에게 요청해서 만들수도 있습니다.
예시를 실패한 테스트의 원인과 결과를 분석해 우선순위를 정하는 ‘error_analysis’ 스킬을 만들어 보겠습니다. 사용한 프롬프트는 아래와 같습니다.
스킬 설치 예시용 프롬프트
# error_analysis
## Goal 프로젝트에서 발생한 에러, 버그, 테스트 실패 원인을 분석하고 개발자가 바로 확인할 수 있는 수정 방향을 제안합니다.
## When to use this skill - 에러 로그를 분석해야 할 때 - 테스트 실패 원인을 찾아야 할 때 - 버그 리포트를 개발 작업으로 정리해야 할 때 - 수정 우선순위를 정해야 할 때 - 배포 전 위험 요소를 점검해야 할 때
## Instructions 1. 먼저 입력된 에러 로그나 버그 내용을 읽고 핵심 문제를 요약합니다. 2. 에러가 발생한 파일, 함수, 모듈, API 경로가 있다면 따로 정리합니다. 3. 원인을 단정하지 말고 가능성이 높은 원인부터 순서대로 제시합니다. 4. 재현 방법이 부족하다면 추가로 확인해야 할 정보를 정리합니다. 5. 수정이 필요한 작업을 우선순위별로 나눕니다. 6. 바로 적용할 수 있는 수정 방향과 주의할 점을 함께 작성합니다. 7. 테스트가 필요하다면 어떤 테스트를 추가해야 하는지 제안합니다.
## Output format ## 1. 문제 요약 ## 2. 관련 파일 또는 기능 ## 3. 가능성 높은 원인 ## 4. 확인해야 할 추가 정보 ## 5. 수정 우선순위 ## 6. 권장 수정 방향 ## 7. 추가 테스트 제안
## Constraints - 원인이 확실하지 않은 경우 단정하지 않습니다. - 로그에 없는 내용을 임의로 지어내지 않습니다. - 수정 방향은 실제 개발자가 실행할 수 있는 수준으로 작성합니다. - 위험한 명령어나 데이터 삭제 작업은 사용자 확인이 필요하다고 안내합니다. |
요청에 맞춰 스킬이 완성된 것을 볼 수 있습니다.
| /skills |
위의 명령어를 입력하면 터미널 내 스킬 마켓플레이스에서 필요한 스킬을 검색하고 한 줄 명령으로 즉시 설치할 수 있습니다.
설치된 스킬은 이후 프롬프트에서 /스킬명 형태로 바로 호출됩니다.
* Antigravity CLI 사용시, 알아두면 유용한 명령어
명령어 | 용도 |
agy --version | 설치된 Antigravity CLI 버전을 확인할 때 사용합니다. |
where.exe agy | Windows에서 agy 실행 파일 위치를 확인할 때 사용합니다. |
? | CLI 내부에서 사용할 수 있는 단축키와 도움말을 확인할 때 사용합니다. |
/model | 현재 세션에서 사용할 AI 모델을 선택하거나 변경할 때 사용합니다. |
/config | 색상, 출력 방식, 텔레메트리 등 CLI 설정을 변경할 때 사용합니다. |
/settings | 현재 설정을 확인하거나 관리할 때 사용합니다. |
/skills | 등록된 스킬 목록을 확인하고 관리할 때 사용합니다. 반복 작업을 스킬로 정리해둘 때 유용합니다. |
/tasks | 현재 실행 중인 에이전트 작업을 확인할 때 사용합니다. |
/resume | 중단된 작업이나 이전 작업 세션을 다시 이어서 진행할 때 사용합니다. |
/rewind | 이전 상태로 되돌려 작업 흐름을 다시 조정할 때 사용합니다. |
/permissions | 에이전트가 파일을 읽고 수정하거나 명령을 실행할 수 있는 권한을 설정할 때 사용합니다. |
/mcp | MCP 서버 연결 상태를 확인하거나 외부 도구 연동을 관리할 때 사용합니다. |
/logout | 현재 로그인된 계정에서 로그아웃할 때 사용합니다. |
Ctrl + C | 현재 작업을 중단하거나 입력 상태에서 빠져나올 때 사용합니다. |
Antigravity CLI,
이렇게 활용하면 유용합니다.
GUI 없는 환경에서 멀티 에이전트 자동화
원격 서버, SSH 접속 환경, Docker 컨테이너 내부에서는 GUI 도구를 사용할 수 없습니다. 기존에는 이런 환경에서 AI 코딩 도구를 활용하려면 결과물을 로컬에서 만든 뒤 수동으로 옮기는 번거로움이 있었습니다.
이런 환경일수록 Antigravity CLI를 유용하게 활용할 수 있습니다. AI 에이전트를 서버 환경 안에서 바로 실행할 수 있어 로컬에서 결과물을 만든 뒤 서버로 옮기는 과정 없이, 서버 내부의 파일과 로그를 기준으로 분석과 수정 작업을 이어갈 수 있습니다.
또 멀티 에이전트 구조를 활용하면 백엔드 코드 분석, 테스트 실행, 배포 설정 검토 같은 번거로운 작업을 역할별로 나누어 빠르게 처리할 수 있어 GUI가 없는 환경에서도 에이전트 기반 개발 흐름을 만들 수 있습니다.
반복 스크립트 작업 에이전트화
DevOps 업무는 배포 전 환경변수 검증, 로그 파싱, 테스트 결과 확인, 슬랙 알림 연동처럼 반복되는 작업이 많습니다.
이런 작업은 한 번 작성해두면 계속 재사용할 수 있지만, 실제 운영 환경에서는 매번 조건과 상황이 조금씩 달라져 신경이 많이 쓰입니다.
Antigravity CLI는 이런 반복 작업을 에이전트 워크플로로 정리해두고, 필요할 때 터미널에서 바로 다시 실행할 수 있다는 점에서 유리합니다.
자주 쓰는 검증 절차나 배포 전 체크리스트를 스킬처럼 등록해두면, 키워드 하나로 동일한 흐름을 재실행할 수 있습니다.
여기에 훅 기능을 연결하면 특정 이벤트가 발생했을 때 에이전트가 자동으로 트리거되어, 단순 반복 확인 작업을 줄이고 운영 자동화 수준을 높일 수 있습니다.
Antigravity CLI
사용 시 주의사항 3가지
1. 결과를 반드시 검증해야 합니다
에이전트가 생성한 스크립트와 설정 파일은 구조적으로 그럴듯해 보여도 실제 실행 환경과 불일치하는 경우가 발생할 수 있습니다.
특히 환경변수 경로, 패키지 버전, 운영체제별 명령어 차이에서 오류가 잦습니다. 실제 프로덕션 환경에 적용하기 전 반드시 스테이징 환경에서 먼저 검증하는 것을 권장합니다.
2. 권한 설정에 주의하세요
Antigravity CLI는 에이전트가 터미널 명령 실행, 패키지 설치, 파일 수정을 자율적으로 처리할 수 있습니다.
/permissions 명령어로 에이전트에게 허용할 작업 범위를 사전에 제한하고, 중요한 프로덕션 디렉토리에서는 작업 전 권한 범위를 반드시 확인하는 것을 권장합니다.
3. 마이그레이션을 2026년 6월 18일 이전에 완료하세요
구글 공식 발표에 따르면 Gemini CLI는 2026년 6월 18일부터 개인 사용자 및 Google AI Pro · Ultra 사용자 요청 처리를 중단합니다.
Gemini CLI의 Agent Skills, Hooks, Subagents, Extensions는 Antigravity CLI로 마이그레이션 경로가 제공되지만, 기능이 1:1로 완전히 일치하지 않는 부분이 있습니다.
마이그레이션 전 구글 개발자 블로그의 공식 전환 가이드를 먼저 확인하는 것을 권장합니다.
알아두면 유용한 AI CLI 사용법
Claude Code 사용법: 설치부터 Agent 활용 노하우까지
FAQ
Antigravity CLI는 데스크톱 앱을 설치해야 사용할 수 있나요?Antigravity CLI의 스킬은 무엇인가요?Antigravity CLI는 어떤 실무 작업에 유용한가요?
실시간 인기 게시물이랜서 PICK 추천 게시물