Gemini CLI 종료 이후 Antigravity CLI 마이그레이션과 멀티에이전트 아키텍처
Gemini CLI 종료에 따른 Antigravity CLI 전환 경로와 공유 에이전트 하네스, 멀티에이전트 오케스트레이션 구조 및 운영 위험을 분석한다.
2026-08-14 · 최초 발행 2026-08-02
Gemini CLI에서 에이전트 플랫폼으로 넘어가는 이유
Google은 2026년 6월 18일부로 Gemini CLI 및 Gemini Code Assist IDE 확장의 Google AI Pro/Ultra 서비스를 공식 종료하고 Antigravity CLI로 전환한다고 발표했다. 바뀌는 것은 CLI의 이름만이 아니다. 데스크톱, 터미널, IDE에서 따로 이어지던 개발 경험을 하나의 에이전트 실행 구조로 묶는 플랫폼 재편에 가깝다.
기존 Gemini CLI에는 IDE 확장과 웹 인터페이스, API 직접 호출 등 여러 진입점이 있었다. 하지만 각 환경에서 에이전트 기반 워크플로우를 일관되게 이어 가기에는 구조적인 제약이 있었다. Antigravity CLI는 이 파편화된 접점을 통합하는 인터페이스로 설계됐다.
전환의 중심에는 단일 에이전트 하네스가 있다. Antigravity 2.0 데스크톱 앱과 CLI가 같은 런타임을 사용하므로, 데스크톱에서 구성한 에이전트 파이프라인을 터미널에서도 실행할 수 있다. Gemini Code Assist IDE 확장 역시 Antigravity 기반으로 재구성되며, IDE에서 발생하는 상호작용은 에이전트 하네스를 거치게 된다.
구독 체계도 함께 바뀐다. Google AI Pro/Ultra 구독자는 Antigravity 플랫폼으로 이전되며, Gemini CLI 무료 사용자는 제한된 무료 플랜 또는 유료 플랜으로 이동해야 한다.
여러 에이전트를 묶는 공유 하네스
에이전트 하네스는 전문화된 에이전트들을 조율하는 메타 레이어다. 사용자 요청을 한 번의 모델 호출로 처리하는 대신, 목표를 여러 작업으로 나누고 필요한 에이전트에 배분해 다단계 작업을 수행한다.
사용자의 고수준 목표를 처음 받는 곳은 오케스트레이션 레이어다. 이 레이어는 요청을 실행 가능한 서브태스크로 분해하고 태스크 그래프를 만든다. 작업 사이의 의존성을 관리하면서, 서로 독립적인 태스크는 병렬로 처리할 수 있도록 배치한다.
태스크를 실제로 수행하는 주체는 에이전트 풀이다. 코드 생성, 테스트, 문서화, 검색처럼 작업 유형에 맞춰 특화된 에이전트가 독립적으로 움직이며 오케스트레이터의 지시를 받는다.
각 에이전트의 작업이 단절되지 않도록 연결하는 통로가 컨텍스트 버스다. 에이전트가 만든 아티팩트와 중간 결과, 현재 상태를 다른 에이전트에 전달하는 메시지 브로커 역할을 맡는다.
데스크톱 앱과 CLI가 이 하네스를 함께 사용하면 실행 환경이 달라져도 에이전트 설정과 도구 권한, 메모리 컨텍스트를 일관되게 유지할 수 있다. 로컬 개발 환경과 CI/CD 파이프라인에서 서로 다른 실행 체계를 따로 관리할 필요도 줄어든다.
플러그인과 도구 확장 역시 공통 기반에서 동작한다. 환경별 구성을 별도로 유지하지 않아도 데스크톱과 CLI에서 같은 확장을 사용할 수 있다. 진행 중인 작업 상태는 클라우드 백엔드를 통해 동기화되므로, 데스크톱에서 시작한 작업을 CLI에서 이어받거나 반대 방향으로 넘기는 흐름도 가능하다.
탐색·수정·검증을 연결하는 실행 파이프라인
Antigravity CLI의 오케스트레이터는 요청을 해석한 뒤 적절한 전문 에이전트에 작업을 보낸다. 리팩터링 요청이라면 코드 에이전트가 파일을 분석하고 수정 결과를 제출한 다음, 테스트 에이전트가 이를 검증하는 식이다. 중간 결과는 오케스트레이터로 돌아오며, 검증이 끝나면 CLI가 사용자에게 완료 상태를 전달한다.
실행 방식은 태스크 관계에 따라 달라진다. 앞선 결과가 다음 작업의 입력이 되어야 한다면 순차 실행 패턴을 쓴다. 여러 모듈의 테스트 코드 생성처럼 작업이 서로 독립적이라면 병렬 실행으로 전체 처리 시간을 줄일 수 있다.
대규모 코드베이스 리팩터링이나 전체 시스템 설계처럼 범위가 넓은 요청에는 계층적 위임 패턴이 맞는다. 상위 에이전트가 작업을 여러 하위 에이전트에 나누고, 하위 에이전트가 필요에 따라 태스크를 다시 세분화하는 트리 구조다.
Antigravity CLI와 경쟁 도구의 선택 기준
2026년 AI 개발 도구 시장에서는 Antigravity CLI, Claude Code, OpenAI Codex CLI가 서로 다른 아키텍처 전략을 취하고 있다. 모델 사양만 비교하기보다 에이전트의 실행 방식과 도구 통합 경계를 함께 봐야 한다.
| 항목 | Antigravity CLI | Claude Code | OpenAI Codex CLI |
|---|---|---|---|
| 멀티에이전트 지원 | 네이티브 지원 | 서브에이전트 위임 | 제한적 |
| 에이전트 하네스 | 공유 하네스 | 독립 실행 | 플러그인 방식 |
| IDE 통합 | VS Code, JetBrains | VS Code 중심 | VS Code, Neovim |
| 컨텍스트 윈도우 | 2M 토큰 (Gemini) | 200K 토큰 | 128K 토큰 |
| 오프라인 모드 | 부분 지원 | 미지원 | 미지원 |
| 도구 확장성 | MCP + 자체 SDK | MCP 표준 | Function Calling |
| 구독 모델 | Pro/Ultra | Max/팀 플랜 | 플러스/팀 |
Antigravity CLI의 설계 중심은 플랫폼 통합이다. 데스크톱과 CLI, IDE가 단일 하네스를 공유해 어느 환경에서도 같은 에이전트 경험을 제공한다. 반면 Google 생태계에 대한 의존도가 높아 벤더 종속 위험을 고려해야 한다.
Claude Code는 단일 에이전트가 복잡한 작업을 처리하고 필요할 때 서브에이전트를 만드는 방식으로 자율성을 확보한다. Anthropic의 안전성 프레임워크를 바탕으로 Human-in-the-Loop 게이트를 두고 위험한 작업에는 승인을 요구한다.
OpenAI Codex CLI는 Function Calling과 플러그인 아키텍처를 활용한 외부 도구 연동에 초점을 둔다. ChatGPT 3억 명 사용자 기반과 연결되는 생태계가 강점이다.
기존 워크플로우를 옮길 때 확인할 경계
Gemini Code Assist IDE 확장을 Antigravity IDE 확장으로 바꾸는 일은 플러그인 하나를 교체하는 작업으로 끝나지 않는다. 자동화 스크립트와 CI/CD 호출, 인증, 사용자 설정까지 개발 흐름 전체가 영향을 받는다.
먼저 기존 Gemini CLI 사용 지점을 찾아야 한다. 셸 스크립트와 CI/CD 파이프라인 안의 호출, IDE 커스터마이징, 프롬프트 템플릿을 목록화하면 전환 범위를 확인할 수 있다.
그다음 Gemini CLI가 종료되기 전에 Antigravity CLI를 병렬로 운영한다. 기존 작업을 차례로 이전하면서 기능 동등성을 검증하고, 문제가 드러나는 지점을 기록한다. 검증이 끝난 뒤 모든 참조를 Antigravity CLI로 바꾸고 공유 에이전트 하네스를 사용하는 워크플로우로 전환한다.
API 호환성은 초기에 확인해야 할 부분이다. Gemini CLI와 Antigravity CLI가 사용하는 API 엔드포인트가 다를 수 있으며, 배치 처리와 스트리밍 응답 방식에도 차이가 생길 수 있다.
인증 체계도 그대로 유지된다고 가정하면 안 된다. Google AI Pro/Ultra 구독 기반 인증이 Antigravity 계정 기반으로 바뀌기 때문에, 서비스 계정을 사용하는 CI/CD 환경에서는 별도의 인증 토큰 발급 절차가 필요하다.
세션 컨텍스트와 사용자 맞춤 설정은 자동 이전되지 않을 수 있다. 중요한 프롬프트 템플릿과 설정 파일은 따로 확보해 수동으로 옮겨야 한다. 셸 스크립트에서 gemini 명령어를 직접 호출한다면 antigravity 또는 ag로 교체하고 플래그와 옵션 구문의 차이도 확인해야 한다.
멀티에이전트 운영을 보는 아키텍처 관점
Antigravity의 에이전트 분리 구조는 MSA의 서비스 분리 원칙을 AI 에이전트에 적용한 형태로 볼 수 있다. 개별 에이전트가 독립적으로 배포되고 확장되며, 오케스트레이터가 서비스 메시 역할을 맡는다.
컨텍스트 버스를 이용한 통신은 이벤트 드리븐 아키텍처와 닮았다. 한 에이전트가 완료 이벤트를 발행하면 이를 구독하는 다음 에이전트가 활성화되는 흐름이다.
플랫폼 엔지니어링 관점에서는 Antigravity를 IDP(Internal Developer Platform)의 AI 확장으로 해석할 수 있다. 셀프서비스 인프라 제공과 Golden Path 워크플로우 정의, 개발자 경험 표준화라는 원칙이 에이전트 실행 환경에 적용된다.
운영 편의성만큼 권한 분리도 중요하다. 코드 생성 에이전트에는 파일 읽기와 쓰기 권한을 부여하되 네트워크 접근을 제한하는 방식처럼, 각 에이전트는 최소 권한 원칙(Principle of Least Privilege)에 따라 구성해야 한다.
서비스 전환 측면에서는 변경 관리와 위험 평가, 롤백 계획도 함께 다뤄야 한다. Gemini CLI 종료는 IT 서비스 수명주기 관리의 사례이며, 이 과정은 ITIL(IT Infrastructure Library)의 Service Transition과 맞닿아 있다. 공유 하네스가 환경 사이의 일관성을 높여도 API와 인증, 상태 이전의 경계까지 자동으로 해결해 주는 것은 아니다.
Sources
- Google Antigravity 공식 발표 (2026.06): Gemini CLI 종료 및 Antigravity CLI 전환 안내
- Google AI Pro/Ultra 서비스 마이그레이션 가이드 (2026.06)
- Antigravity 2.0 데스크톱 앱 릴리즈 노트 (2026.05)
- Anthropic Claude Code 아키텍처 문서 (2026.06)
- OpenAI Codex CLI 기술 명세 (2026.06)
- ITIL 4 Service Transition Framework
- 정보관리기술사 기출문제집 — 소프트웨어 아키텍처 편
- Google Gemini Code Assist 종료 공지 (2026.06.10)