Gemini CLI에서 Antigravity CLI로 옮겨가는 에이전트 플랫폼
Gemini CLI 종료 일정과 Antigravity CLI 마이그레이션, 공유 에이전트 하네스, ATU 할당량 및 기업 배포 구조를 정리한다.
2026-08-14 · 최초 발행 2026-08-02
종료되는 것은 CLI 이름만이 아니다
Google은 2026년 6월 18일 Gemini CLI의 EOL(End of Life)을 확정하고 기존 gemini 바이너리 사용자를 antigravity CLI로 이전한다. Antigravity 2.0의 Go 기반 분산 런타임과 코드베이스를 합치기 위한 전환으로, 단순한 리브랜딩보다 범위가 넓다.
바이너리 이름은 antigravity로 바뀌고 gemini는 deprecated 상태가 된다. 사용자 구성은 ~/.gemini/에서 ~/.antigravity/로 이동하며, Gemini CLI와 Antigravity 2.0이 따로 갖고 있던 에이전트 실행 계층도 하나의 하네스로 통합된다. 할당량을 계산하는 기준은 토큰에서 에이전트 작업 단위인 Agent Task Unit(ATU)으로 전환된다.
호환성 계층을 거쳐 새 런타임으로 이동한다
전환 기간에는 gemini 명령을 받는 래퍼 스크립트가 경고를 출력한 뒤 요청을 antigravity로 위임한다. 이 래퍼는 30일 뒤인 2026년 7월 18일 이후 제거될 예정이다. 설치 대상은 /usr/local/bin/antigravity이며, 기존 /usr/local/bin/gemini 심볼릭 링크는 제한된 기간에만 유지된다.
새 CLI는 Darwin·Linux·Windows용으로 크로스 컴파일하는 단일 바이너리 형태로 배포된다. 내부는 Go 1.22+와 정적 링킹을 이용해 의존성을 줄이며, 에이전트 확장 기능을 동적으로 불러올 수 있도록 WASM 플러그인 런타임을 포함한다.
CLI와 IDE가 같은 하네스를 소비한다
Antigravity CLI의 중심에는 독립적인 CLI 로직이 아니라 공유 에이전트 하네스가 있다. Task Planner, Tool Manager, Context Manager, Session Manager를 공통 코어에 두고 CLI, Antigravity 2.0 Web IDE, Python·Go·Node SDK가 이를 함께 사용한다.
이 구조에서는 Antigravity 2.0에 추가한 기능을 하네스 코어에 반영함으로써 CLI에도 같은 기능을 전달할 수 있다. 버그 수정 지점도 하네스로 모이며, MCP 서버와 툴 플러그인을 비롯한 에이전트 도구 생태계 역시 여러 소비자 플랫폼이 공유한다.
코드베이스는 pkg/harness/에 비공개 에이전트 코어 로직을, pkg/tools/에 파일 시스템·웹 검색·코드 실행·셸 명령 도구를 둔다. pkg/quota/는 ATU 계산 엔진을 담당한다. 실행 진입점은 cmd/antigravity/이며, IDE 플러그인과 연결하는 브릿지 서버는 cmd/antigravity-ide-bridge/에 위치한다.
구성 파일은 디렉토리와 형식이 함께 바뀐다
| 항목 | 기존 Gemini CLI | Antigravity CLI |
|---|---|---|
| 구성 디렉토리 | ~/.gemini/ |
~/.antigravity/ |
| 주 구성 파일 | ~/.gemini/config.yaml |
~/.antigravity/config.toml |
| 인증 토큰 | ~/.gemini/credentials.json |
~/.antigravity/auth/token.json |
| 세션 히스토리 | ~/.gemini/history/ |
~/.antigravity/sessions/ |
| 플러그인 디렉토리 | 미지원 | ~/.antigravity/plugins/ |
| 프로젝트 구성 | .gemini.yaml |
.antigravity.toml (XDG 준수) |
antigravity migrate는 기존 Gemini CLI 설정을 새 레이아웃으로 변환한다. YAML에서 TOML로 옮길 때 주석과 커스텀 설정을 보존하며, 인증 상태도 이전하므로 재인증은 필요하지 않다.
토큰 대신 에이전트 작업을 기준으로 할당량을 센다
기존 Gemini CLI는 월간 입력·출력 토큰을 기준으로 사용량을 계산했다. Antigravity CLI는 도구 호출, 컨텍스트 사용량, 병렬 에이전트 실행을 포함하는 ATU로 측정 단위를 바꾼다.
단순 대화는 1 ATU다. 도구 호출이 포함된 작업은 기본 ATU에 도구 복잡도 계수 1.5x~3x를 적용한다. 병렬 서브에이전트는 에이전트 수에 기본 ATU를 곱하며, 128K 토큰을 초과하는 장기 컨텍스트에는 ATU가 추가된다.
무료 티어는 하루 100 ATU와 단일 에이전트를 제공한다. Developer는 하루 2,000 ATU와 최대 3개 병렬 에이전트, Pro는 하루 10,000 ATU와 최대 10개 병렬 에이전트 및 우선 처리를 제공한다. Enterprise는 커스텀 ATU, 전용 에이전트 풀과 SLA 보장을 포함한다.
Gemini CLI 유료 플랜 보유자는 6개월의 전환 기간 동안 ATU로 환산한 동등 이상의 할당량을 보장받는다. 무료 사용자는 기존 토큰 소비량을 ATU로 환산한 뒤 적합한 티어에 자동 배정된다.
터미널과 편집기 사이에서 세션을 이어간다
통합 플랫폼에서는 CLI, IDE 플러그인, SDK, 웹 콘솔이 동일한 하네스에 접근한다. CLI에서 시작한 세션은 세션 ID를 공유해 IDE에서 계속할 수 있으며, CLI에서 제공하는 도구도 IDE와 SDK에서 같은 방식으로 사용할 수 있다.
VSCode용 antigravity.vscode 확장은 LSP 프로토콜로 코드 컨텍스트를 전달한다. JetBrains 플러그인은 IntelliJ 플랫폼의 PSI 트리와 연결해 코드를 분석하며, Neovim의 antigravity.nvim은 선택한 코드 블록을 자동으로 컨텍스트에 넣는다.
기존 Gemini CLI 환경을 이전하는 명령
먼저 운영체제에 맞는 방식으로 Antigravity CLI 바이너리를 설치한다.
# macOS (Homebrew)
brew install google/antigravity/antigravity
# Linux (apt)
apt install antigravity
# 직접 다운로드
curl -fsSL https://antigravity.google.com/install.sh | bash
설치가 끝나면 기존 설정을 변환하고 결과를 검증한다.
# 자동 마이그레이션 실행
antigravity migrate --from-gemini
# 마이그레이션 결과 검증
antigravity config verify
CI/CD 파이프라인에서 호출하는 바이너리는 gemini에서 antigravity로 바꿔야 한다. 환경 변수는 GEMINI_API_KEY 대신 ANTIGRAVITY_API_KEY를 사용하며 기존 키를 재사용할 수 있다. 서브커맨드는 gemini chat에서 antigravity chat으로, gemini run에서 antigravity exec으로 변경된다.
프로젝트 단위 설정 파일은 다음 명령으로 변환한다.
# 프로젝트별 설정 자동 변환
antigravity migrate --project-config
# .gemini.yaml → .antigravity.toml 변환
기능 배포 속도와 중앙 의존성이 함께 커진다
Antigravity 2.0 Web IDE에 도구가 추가되면 하네스 코어를 거쳐 CLI에서도 사용할 수 있다. 기능 플래그로 점진적 롤아웃을 제어하고, --harness-version 2.3.1 옵션으로 특정 하네스 버전을 고정할 수도 있다.
동기화 대상은 에이전트 도구 목록과 인터페이스 스펙에 그치지 않는다. 메모리 압축과 중요도 기반 컨텍스트 유지 정책, 오류 처리와 재시도 로직, 모델 선택과 폴백 정책도 하네스에서 공유한다.
기능 일관성과 유지 보수 효율은 이 방식의 강점이다. 반면 하네스 의존성이 커지면서 커스텀 에이전트 구현의 유연성이 줄고, 중앙화된 아키텍처는 단일 장애점(SPOF) 위험을 만든다. 서드파티 에이전트 프레임워크와 연결할 때의 복잡도도 남는다.
기업 배포에서는 정책과 감사 경로를 먼저 맞춘다
Antigravity CLI는 Jamf와 Intune을 통한 MDM(Mobile Device Management) 연동, Windows 엔터프라이즈의 GPO(Group Policy Object) 기반 구성 강제 적용을 지원한다. 중앙 구성 서버는 antigravity config --remote-config https://config.corp.example.com으로 지정한다.
네트워크가 격리된 환경에서는 온프레미스 Antigravity Gateway를 이용해 에어갭 구성을 지원한다. 프록시는 ANTIGRAVITY_PROXY 환경 변수로 설정하며 사설 CA 인증서를 신뢰하도록 구성할 수 있다.
에이전트 작업 감사 로그는 JSON Lines 형식으로 구조화해 출력한다. 출력 스트림의 PII 자동 마스킹은 선택 기능이며, Splunk와 Elastic Stack용 SIEM 포워더가 포함된다.
경쟁 CLI와 비교한 플랫폼 선택 기준
| 항목 | Google Antigravity CLI | Anthropic Claude Code | OpenAI Codex CLI |
|---|---|---|---|
| 출시 연도 | 2026 (Gemini CLI 재편) | 2025 Q1 | 2025 Q2 |
| 기반 언어 | Go (단일 바이너리) | Node.js + Rust(일부) | Python |
| 에이전트 아키텍처 | 공유 하네스 (멀티플랫폼) | Claude Agent SDK | Codex Agent Framework |
| 컨텍스트 윈도우 | 1M 토큰 (Gemini 2.5) | 200K 토큰 (Claude 3.7) | 128K 토큰 (GPT-4o) |
| 도구 통합 | MCP + 자체 툴 스펙 | MCP 표준 | MCP + OpenAI 툴 스펙 |
| IDE 통합 | VSCode·JetBrains·Neovim | VSCode·JetBrains·Cursor | VSCode·JetBrains |
| 오프라인 지원 | 제한적 (로컬 캐시) | 미지원 | 미지원 |
| 멀티에이전트 | 내장 (병렬 서브에이전트) | Claude Agent SDK 별도 | 제한적 |
| 할당량 모델 | ATU 기반 | 토큰 기반 | 토큰 기반 |
| 엔터프라이즈 | Antigravity Enterprise | Claude for Enterprise | ChatGPT Enterprise |
| 오픈소스 | 클라이언트 일부 공개 | 에이전트 SDK 공개 | Codex CLI 오픈소스 |
세 제품은 에이전트 기능을 개발 환경에 연결한다는 목표는 같지만 경계 설정이 다르다. Google은 하네스를 여러 인터페이스가 공유하는 통합 모델을 택했다. Anthropic은 Claude Agent SDK를 공개 API로 제공해 커스텀 에이전트의 자유도를 높이고, 중첩 서브에이전트(Nested Subagent)와 에이전트 작업 전 인간 검토(Human Gate)를 지원한다. OpenAI는 Codex CLI를 오픈소스로 공개해 커뮤니티 기여를 유도하고, 로컬 모델인 GPT-4o Mini 실행 지원 방향과 300M+ 사용자 기반의 ChatGPT 연계를 강점으로 둔다.
개발 조직에 연결할 때 생기는 아키텍처 경계
워크스테이션의 CLI와 IDE는 에이전트 하네스에 직접 연결된다. CI/CD에서는 Antigravity Gateway가 중간에 들어가며, 하네스는 Gemini 모델 API와 ATU 할당량 서비스, 모니터링·감사 로그 시스템을 잇는다.
도구 인터페이스는 MCP(Model Context Protocol)로 표준화해 벤더 락인을 줄인다. Antigravity Gateway에는 인증, 속도 제한과 감사 정책을 모으는 API 게이트웨이 패턴을 적용한다. 에이전트 작업 이벤트를 비동기 메시지 큐로 처리하면 파이프라인과 이벤트 드리븐 방식으로 연계할 수 있다. 재시도 과정에서 같은 작업이 중복 실행되지 않도록 멱등성(Idempotency)도 보장해야 한다.
보안 경계는 도구 단위로 나누는 편이 맞다. 파일 접근 경로는 화이트리스트로 제한하고 각 도구에 독립적인 최소 권한을 부여한다. 에이전트 실행 세션에는 15분 TTL의 단기 자격증명을 발급하며, 코드 실행 도구는 컨테이너 격리 환경에서 동작한다. 모든 도구 호출은 구조화 로그로 남겨 SIEM에 전달한다.
컨텍스트와 멀티에이전트 운영이 다음 경쟁축이다
컨텍스트 엔지니어링은 필요한 시점에 RAG, MCP와 파일 시스템 컨텍스트를 결합하는 JIT(Just-In-Time) 조립 방식으로 표준화되고 있다. Antigravity CLI는 --context-mode jit|eager|cached 옵션으로 전략을 선택하며, 장기 프로젝트에서는 컨텍스트 압축과 우선순위화를 자동 적용한다.
멀티에이전트의 설계 방향은 제품마다 다르다. Antigravity의 병렬 서브에이전트는 대규모 코드베이스 분석과 리팩토링에 맞춰져 있고, Claude Code의 중첩 서브에이전트는 안전성을 중심으로 작업을 계층화한다. 2026년에는 에이전트 간 협력 프로토콜인 A2A(Agent-to-Agent)의 표준화가 진행 중이다.
CLI 에이전트와 iOS·Android 에이전트 플랫폼 사이에서 세션을 공유하는 온디바이스 연동도 포함된다. 엣지 추론에서는 소형 모델을 로컬에서 실행하고 복잡한 작업만 클라우드로 넘긴다.
이 구조는 SOA(Service-Oriented Architecture)의 서비스 분리, EAI(Enterprise Application Integration)의 게이트웨이 통합, DevSecOps의 감사 로그와 SIEM 연동, API Economy의 ATU 기반 할당량과 API 게이트웨이 수익화 전략으로도 해석할 수 있다.
Gemini CLI 사용자는 2026년 6월 18일 전에 바이너리와 설정, 자동화 파이프라인을 이전해야 한다. 운영팀은 마이그레이션과 함께 ATU 소비 구조를 점검해야 하며, 플랫폼 통합으로 얻는 기능 일관성과 중앙 하네스 의존성 사이의 균형도 배포 설계에 반영해야 한다.
Sources
- Google Antigravity 공식 마이그레이션 가이드: https://antigravity.google.com/docs/migrate-from-gemini
- Antigravity 2.0 릴리즈 노트 (2026): https://antigravity.google.com/changelog/2.0
- Google Developers Blog — Gemini CLI End of Life 공지: https://developers.googleblog.com/2026/05/gemini-cli-eol-antigravity-transition
- Anthropic Claude Agent SDK 문서: https://docs.anthropic.com/agent-sdk
- OpenAI Codex CLI GitHub: https://github.com/openai/codex-cli
- CNCF AI Working Group — Agent Interoperability Standards 2026: https://cncf.io/blog/2026/agent-a2a-protocol
- Context Engineering: JIT Assembly, RAG, MCP and the 2026 Paradigm Shift (2026): https://gillilab.tistory.com/context-engineering-2026
- Model Context Protocol (MCP) 공식 스펙: https://modelcontextprotocol.io/spec