Gemini CLI 종료 이후 Antigravity 공유 에이전트 하네스로 이전하기

CLI 이중 운영 구조가 끝난다

Google은 2026년 6월 18일 Gemini CLI 서비스를 공식 종료하고 개발 도구 기능을 Antigravity CLI로 흡수 통합한다고 발표했다. 명칭만 바꾸는 작업은 아니다. Gemini CLI와 Antigravity 2.0이 하나의 에이전트 하네스와 코드베이스를 공유하도록 개발 도구 플랫폼의 중심을 옮기는 변화다.

Gemini CLI는 2025년 중반 개발자 생산성 향상을 목표로 출시된 터미널 기반 AI 어시스턴트였다. Gemini 모델을 CLI에서 호출해 코드를 생성하고 파일을 조작하며, 프로젝트 컨텍스트를 반영한 대화를 제공했다. 무료 티어의 호출 할당량도 초기 주목을 받은 배경이었다.

문제는 Antigravity와 별개의 코드베이스를 운영하면서 생긴 이중 관리 부담이었다. Google I/O 2026에서 발표된 Antigravity 2.0에는 에이전트 런타임과 분산 실행, MCP(Model Context Protocol) 네이티브 지원이 포함됐다. 두 CLI를 따로 발전시키는 방식의 비효율이 커지자 Google은 2026년 5월 종료 계획을 공식화하고 기존 사용자에게 Antigravity CLI 이전을 권고했다.

공유 하네스가 CLI와 Desktop, SDK를 잇는다

⤢✕

Antigravity CLI의 실행 기반은 공유 에이전트 하네스(Shared Agent Harness)다. Antigravity Desktop 앱과 CLI, SDK가 동일한 에이전트 런타임을 참조하도록 만든 추상화 계층이며, 내부 역할은 세 가지 서브레이어로 나뉜다.

코어 런타임 레이어는 모델 호출과 컨텍스트 윈도우 관리, 스트리밍 응답 처리를 맡는다. Gemini 2.5 시리즈의 100만 토큰 컨텍스트를 이용해 대형 코드베이스 전체를 한 세션에서 다룰 수 있도록 설계됐다.

MCP 네이티브 브릿지는 Model Context Protocol을 런타임 수준에서 지원한다. 파일시스템이나 DB 접근을 맡는 로컬 MCP 서버와 GitHub, Jira, Confluence 같은 원격 MCP 서버를 같은 인터페이스로 연결한다.

툴 오케스트레이터는 사용할 수 있는 도구를 동적으로 발견하고 실행 순서를 조정한다. 병렬 툴 호출(Parallel Tool Calls)을 지원하므로 여러 파일의 수정이나 복수 API 호출을 동시에 처리할 수 있다.

기능을 클라이언트마다 다시 구현하지 않는 구조

공유 에이전트 하네스의 목적은 기능 동기화를 코드 구조로 해결하는 데 있다. Gemini CLI와 Antigravity가 분리돼 있을 때는 같은 기능을 각각 구현해야 했다. 단일 코드베이스에서는 하네스에 반영한 변경을 CLI와 Desktop, SDK가 함께 사용할 수 있다.

가령 새로운 코드 실행 샌드박스가 하네스에 추가되면 다음 릴리스 사이클에서 Antigravity CLI와 Desktop 앱, Python/Node SDK에 동시에 제공된다. 여러 클라이언트의 버전 파편화를 관리해야 하는 엔터프라이즈 환경에서는 특히 의미가 큰 변화다.

하네스 코드베이스는 모노레포(Monorepo)로 관리되며 역할별 패키지는 다음처럼 구분된다.

packages/agent-harness/ — 공유 런타임 코어
packages/cli/ — Antigravity CLI 클라이언트
packages/desktop/ — Antigravity Desktop 클라이언트
packages/sdk-python/ — Python SDK 바인딩
packages/sdk-node/ — Node.js SDK 바인딩

패키지와 인증, 프로젝트 설정 옮기기

먼저 기존 패키지를 제거하고 Antigravity CLI를 설치한다.

# 기존 Gemini CLI 제거
npm uninstall -g @google/gemini-cli

# Antigravity CLI 설치
npm install -g @google/antigravity-cli

# 또는 Homebrew 사용 (macOS)
brew install google-antigravity

패키지를 바꾼 뒤에는 인증 정보를 이전해야 한다. Gemini CLI가 ~/.config/gemini/auth.json에 보관한 인증 토큰은 Antigravity CLI로 자동 이동하지 않는다. antigravity auth migrate를 실행하면 기존 토큰을 읽어 ~/.config/antigravity/ 형식으로 변환한다.

프로젝트 설정도 .gemini/config.yaml에서 .antigravity/config.yaml로 바뀐다. 새 스키마는 상위 호환이지만 여러 필드가 추가됐으며, antigravity migrate-config 명령으로 변환할 수 있다.

모놀리식 바이너리에서 플러그인 구조로

Gemini CLI는 모든 기능을 단일 바이너리에 포함했다. Antigravity CLI는 코어 바이너리와 기능 플러그인을 분리한다. 전체 바이너리 크기를 줄이고 필요한 기능만 설치할 수 있도록 실행 구조를 다시 나눈 것이다.

전역 설정과 프로젝트별 설정도 계층적으로 배치된다.

~/.config/antigravity/
├── auth.json          # OAuth 토큰 및 API 키
├── config.yaml        # 전역 기본 설정
├── plugins/           # 설치된 플러그인 메타데이터
└── sessions/          # 세션 히스토리 캐시

.antigravity/          # 프로젝트별 설정 (기존 .gemini/ 대체)
├── config.yaml        # 프로젝트 오버라이드 설정
├── tools/             # 커스텀 툴 정의
└── prompts/           # 재사용 프롬프트 템플릿

~/.config/antigravity/에는 인증과 전역 설정, 플러그인 메타데이터, 세션 캐시가 놓인다. 저장소 안의 .antigravity/는 프로젝트 오버라이드와 커스텀 도구, 재사용 프롬프트를 관리한다.

모델별 제한에서 크레딧 풀로 바뀌는 할당량

Gemini CLI 무료 티어에서 Gemini 2.5 Pro는 월 60회 요청으로 제한됐다. Flash 모델은 분당 15회, 일 1500회였다. Antigravity CLI로 전환하면 이 모델별 개별 할당량이 크레딧 기반 통합 시스템으로 바뀐다.

사용자는 매월 일정 크레딧을 받고 모델에 따라 다른 비율로 소비한다. Pro 모델 1회 호출은 Flash 모델 10회 호출에 해당한다. 따라서 기존처럼 모델별 남은 요청 수만 확인해서는 사용량을 판단하기 어렵고, 공유 크레딧 풀의 소비 구조를 기준으로 워크로드를 배치해야 한다.

기업 환경에서는 Google Cloud Billing을 연동해 크레딧을 추가 구매할 수 있다. 엔터프라이즈 할당량 정책을 적용하면 팀 단위 크레딧 풀도 설정할 수 있다.

경쟁 CLI 에이전트와 갈리는 지점

항목	Antigravity CLI	Claude Code	OpenAI Codex CLI
기반 모델	Gemini 2.5 Pro/Flash/Ultra	Claude Sonnet/Opus 4	GPT-4.1/o3
컨텍스트 윈도우	최대 100만 토큰	최대 20만 토큰	최대 128K 토큰
MCP 지원	네이티브 (런타임 레벨)	네이티브 (SDK 레벨)	플러그인 방식
무료 티어	크레딧 기반 (제한적)	없음 (구독 필요)	없음 (API 과금)
오픈소스 여부	부분 오픈 (하네스 코어)	클로즈드	클로즈드
IDE 통합	VS Code, JetBrains	VS Code 확장	VS Code 확장
에이전트 모드	완전 자율 (Antigravity 2.0)	자율 에이전트	Async 에이전트
병렬 툴 실행	지원	지원	지원
로컬 코드 실행	샌드박스 지원	Docker/직접 실행	Docker 기반

Antigravity CLI의 차별점은 최대 100만 토큰 컨텍스트 윈도우와 런타임 수준의 MCP 통합이다. 대형 모노레포를 세션에 올려 작업할 수 있고, 외부 도구 연결의 지연시간과 복잡도를 낮출 수 있다.

Claude Code는 에이전트 안전성과 사람-게이트(Human Gate) 모델에 강점이 있다. Codex CLI는 OpenAI의 비동기 에이전트 실행과 300만 활성 사용자 기반을 바탕으로 생태계 우위를 확보했다. Antigravity CLI, Claude Code, Codex CLI의 3파전에서는 컨텍스트 범위와 MCP 결합 방식, 실행 통제가 선택 기준으로 갈린다.

자동화 환경은 종료일 전에 호환성을 확인해야 한다

Gemini CLI를 CI/CD 파이프라인이나 자동화 스크립트에 넣어 사용했다면 6월 18일 이전에 호출 지점을 찾아 이전 계획을 세워야 한다.

단기에는 gemini 바이너리 호출을 antigravity로 바꾸는 셸 래퍼를 배포할 수 있다. 핵심 CLI 옵션의 90% 이상이 하위 호환이므로 -m 모델 지정, -p 프롬프트, --context 파일 컨텍스트 플래그는 동일하게 동작한다.

Q3 2026에는 .antigravity/config.yaml을 기준으로 프로젝트별 에이전트 행동을 정의하고 커스텀 도구를 연결해 기존 Gemini CLI 워크플로를 Antigravity 네이티브 방식으로 재구성할 수 있다.

Q4 2026~에는 Antigravity SDK로 에이전트 하네스를 서비스 내부에 직접 임베드하는 전환이 가능하다. 단순히 외부 CLI 프로세스를 호출하던 구조에서 애플리케이션이 런타임을 내재화하는 방향이다.

이 사례에는 모노레포에서 여러 클라이언트를 지원하는 방식, 플러그인 아키텍처를 통한 모놀리식 바이너리 분해, 관심사 분리(Separation of Concerns)가 함께 드러난다. MCP는 에이전트와 도구 사이의 표준 인터페이스를 맡고, 크레딧 기반 자원 모델은 고정 할당량과 비교해 유연성과 예측가능성의 균형을 요구한다. 인증과 설정, 명령 호환성을 단계별로 옮기는 과정은 하위 호환성(Backward Compatibility)을 고려한 플랫폼 마이그레이션 패턴에 해당한다.

공유 에이전트 하네스는 소프트웨어 재사용성, 유지보수성, 확장성이라는 소프트웨어 공학 3대 원칙을 CLI 플랫폼에 적용한 구조다. Gemini CLI 사용자는 종료일 전 호출 경로를 우선 교체하고, 이후 프로젝트 설정과 SDK 기반 통합으로 범위를 넓혀야 한다.