Gemini CLI 6월 18일 종료｜Antigravity CLI 마이그레이션 가이드 (가격·명령어 정리)

3줄 요약

• 언제: 2026년 6월 18일부터 개인·무료·AI Pro/Ultra 계정의 Gemini CLI 요청 지원이 중단됩니다.
• 누가: AI Pro·Ultra·무료 계정, 개인 계정 기반 Gemini Code Assist 사용자가 영향받습니다. Workspace 엔터프라이즈와 Gemini Code Assist Standard/Enterprise는 영향이 없습니다.
• 뭘 하면 되나: agy 설치 후 agy plugin import gemini로 이전하세요. 기본 설정은 10분 안팎, 커스텀 MCP·스킬·CI가 있으면 추가 점검이 필요합니다.

이미지 출처: Google Developers Blog

이 글은 Gemini CLI 종료 일정, Antigravity CLI 마이그레이션 명령어, agy 설치·이전 방법, 새 가격 정책, 바뀐 슬래시 명령어까지 한 번에 정리한 가이드입니다. 유료 Gemini API 키와 Workspace 엔터프라이즈 예외도 함께 다루므로, 개인 개발자와 팀 운영자가 발행 전환 계획을 빠르게 확인할 수 있습니다.

Gemini CLI 종료 일정과 영향 범위

Google이 2026년 5월 19일 I/O 2026에서 발표한 핵심은 두 가지입니다. Gemini CLI를 새 Antigravity CLI(agy)로 통합하고, 2026년 6월 18일부터 개인 계정의 Gemini CLI 요청 지원을 중단한다는 것입니다.

계정 유형	6월 18일 이후	조치
AI Pro / AI Ultra / 무료 개인 계정	요청 지원 중단	Antigravity CLI로 이전 권장
개인 계정 기반 Gemini Code Assist	영향 있음	Antigravity CLI 또는 대체 경로 확인
Gemini Code Assist for GitHub	신규 설치 제한 및 이후 요청 중단 예정	공식 공지 기준으로 전환 일정 확인
Workspace 엔터프라이즈	유지	조치 불필요
Code Assist Standard / Enterprise	유지	조치 불필요
유료 Gemini API 키 사용	유지 가능	예산·사용량 제한 설정 권장

개인 계정이라도 AI Studio·Vertex AI에서 발급한 유료 Gemini API 키로 인증하면 Gemini CLI를 계속 사용할 수 있습니다. 단, 사용량 기반 과금이 발생할 수 있으므로 Google Cloud 예산 알림과 사용량 제한을 먼저 설정해두는 것이 안전합니다.

Antigravity CLI vs Gemini CLI 핵심 차이 4가지

이미지 출처: Google Antigravity 공식 사이트

Antigravity CLI는 Gemini CLI의 단순 이름 변경이 아니라, Google의 새 에이전트형 개발 플랫폼인 Antigravity와 연결되는 터미널 도구입니다. 핵심 차이는 아래 4가지입니다.

1. 런타임 구조: TypeScript/Node.js 기반에서 Go 기반 CLI로 전환
기존 Gemini CLI는 TypeScript/Node.js 기반이었고, Antigravity CLI는 Go 기반으로 새로 설계됐습니다. Google은 Antigravity CLI가 이전보다 더 빠르고 반응성이 좋아졌다고 설명합니다. 다만 실제 체감 속도는 환경, 프로젝트 규모, 네트워크 상태에 따라 달라질 수 있습니다.

2. 비동기 서브에이전트 실행
Antigravity CLI는 복잡한 작업을 여러 에이전트가 나눠 처리하는 구조를 지향합니다. 대규모 리팩토링이나 멀티 토픽 리서치를 백그라운드에 걸어두고 다른 작업을 이어가는 식의 워크플로가 가능해졌습니다.

3. 인증 방식 단순화
Antigravity CLI의 기본 사용 흐름은 Google OAuth 인증입니다. 개인 계정 환경에서는 첫 실행 시 브라우저 인증을 거쳐 사용할 수 있습니다. 다만 CI·Docker·헤드리스 환경은 별도 인증 파일 또는 공식 문서 기준의 설정 확인이 필요합니다.

4. Gemini CLI 핵심 기능의 재구성
Google은 Agent Skills, Hooks, Subagents, Extensions 같은 핵심 기능을 Antigravity CLI에 이어간다고 설명했습니다. 다만 1:1 완전 호환은 아니므로, 기존 스킬·MCP·확장 설정은 마이그레이션 후 실제로 로드되는지 확인해야 합니다.

Antigravity CLI 설치

macOS / Linux

curl -fsSL https://antigravity.google/cli/install.sh | bash

Windows
Windows는 PowerShell 또는 별도 설치 방식이 안내될 수 있으니 공식 마이그레이션 문서에서 최신 명령어를 확인하세요.

설치 후 새 터미널을 열고 agy를 입력하면 첫 부팅 흐름이 시작됩니다. 기존 ~/.gemini/ 설정이 있다면 자동 감지되거나, 아래 import 명령어로 직접 가져올 수 있습니다.

Gemini CLI 설정 그대로 옮기는 명령어

기존 확장·플러그인·MCP 설정을 가져오는 핵심 명령어는 아래입니다.

agy plugin import gemini

이 명령어는 ~/.gemini/ 설정을 기준으로 Antigravity CLI용 설정을 구성합니다. 원본 ~/.gemini/ 폴더는 보존하는 방식이므로, 마감 전까지는 기존 gemini 명령으로 돌아가 확인할 수 있습니다.

로드 상태는 agy 실행 후 /help, /skills, /mcp에서 확인하세요. 자세한 진단·점검 명령어는 공식 마이그레이션 문서를 참고하는 것이 가장 안전합니다.

워크스페이스 스킬 폴더는 수동 확인 필요

스킬 폴더가 자동으로 이전되지 않는 경우, 원본을 보존한 상태로 복사하세요. 전역 스킬은 ~/.gemini/skills, 프로젝트별 스킬은 현재 프로젝트의 .gemini/skills 위치를 확인한 뒤 복사하는 것이 안전합니다.

mkdir -p .agents/skills
cp -a ~/.gemini/skills/. .agents/skills/

프로젝트 안에 .gemini/skills를 따로 쓰고 있었다면 해당 폴더도 확인하세요. 기본 설정은 10분 안팎으로 끝날 수 있지만, 커스텀 스킬과 MCP 서버를 많이 쓰는 환경이라면 30~60분 정도 점검 시간을 잡는 편이 좋습니다.

CI·Docker 환경 주의사항

CI 파이프라인이나 Docker 컨테이너처럼 브라우저·TTY가 없는 환경은 별도 설정이 필요할 수 있습니다. 기본 OAuth 흐름이 브라우저 인증을 요구할 수 있기 때문입니다.

• 로컬에서 먼저 인증 흐름을 확인
• 인증 파일 경로는 agy 실행 후 공식 문서 또는 설정 화면에서 확인하고, CI 시크릿으로 마운트
• CI 스크립트의 gemini 호출부를 찾아 agy 기준으로 명령어와 옵션을 하나씩 검증
• MCP 서버를 쓰는 프로젝트라면 실제 작업을 한 번 실행해 연결 상태 확인

CI 스크립트에 gemini 호출이 남아 있으면 2026년 6월 18일 이후 해당 호출부에서 오류가 날 수 있습니다. 단순 치환으로 끝내기보다, 실제 명령어 옵션과 출력 결과까지 확인하는 것이 안전합니다.

Antigravity 가격 정리 (AI Pro / 신규 중급 / 상위)

Antigravity 2.0 출시와 함께 Google AI 구독 플랜도 개편됐습니다. 핵심은 신규 중간 가격대 플랜이 생겼고, 최상위 플랜 가격이 하향 조정됐다는 점입니다.

플랜	월 요금	Antigravity 사용 한도	대상
AI Pro	기존가 유지	기준선 (1x)	개인 개발자
신규 중급 플랜	$100/월	Pro의 약 5배	중급 사용자
상위 플랜	$200/월 (기존 대비 인하)	Pro의 약 20배	헤비 유저, 팀

※ 정확한 플랜 명칭과 한도는 출시 시점·지역에 따라 다를 수 있으니, Google AI 공식 가격 페이지에서 최신 정보를 확인하세요.

과금 방식이 컴퓨트 기반으로 바뀐 점도 중요합니다. 기존처럼 단순 요청 수나 토큰 수만 보는 방식이 아니라, 에이전트 작업의 컴퓨트 자원 소비량을 기준으로 한도가 차감될 수 있습니다. 실행 전에 컴퓨트 소모량을 정확히 알기 어려울 수 있으므로, 무료 또는 Pro 티어에서 워크플로를 먼저 테스트한 뒤 한도가 큰 플랜으로 옮기는 방식이 안전합니다.

바뀐 슬래시 명령어

Antigravity CLI는 슬래시(/) 기반 명령어 구조를 씁니다. /만 입력하면 현재 계정과 플랜에서 사용할 수 있는 명령어 목록을 확인할 수 있습니다.

• /help — 도움말, 사용 가능한 명령어 확인
• /model — 모델 변경. 사용 가능한 모델은 계정·플랜에 따라 다를 수 있음
• /permissions — 에이전트 권한·자율성 설정. 처음에는 검토 모드로 시작하는 것을 권장
• /skills — 스킬 관리
• /mcp — MCP 서버 설정 확인 및 관리
• /usage — 사용량 또는 컴퓨트 한도 확인

기존 Gemini CLI에서 쓰던 일부 세부 실행 옵션은 Antigravity CLI에서 동일하게 동작하지 않을 수 있습니다. 특히 호출 옵션, 시스템 지침, 스킬·MCP 설정은 마이그레이션 후 실제 실행 결과를 확인하는 것이 안전합니다.

# AGENTS.md 예시 (프로젝트 루트에 위치)
Always use TypeScript.
Never modify files in /vendor.
Use 2-space indentation.

프로젝트 지침은 AGENTS.md 같은 루트 지침 파일로 관리할 수 있습니다. 기존에 GEMINI.md를 쓰던 프로젝트라면 Antigravity CLI에서 인식 여부를 확인하고, 필요하면 핵심 지침을 AGENTS.md로 옮겨두는 것이 안전합니다.

자주 묻는 질문 (FAQ)

Q. 마감 이후에도 Gemini CLI를 쓸 수 있는 방법은?
개인 Pro·Ultra·무료 계정의 기본 인증으로는 어렵습니다. 대안은 3가지입니다. ① 유료 Gemini API 키(AI Studio 또는 Vertex AI)로 인증, ② Workspace 엔터프라이즈 또는 Code Assist Standard/Enterprise 라이선스 사용, ③ Antigravity CLI로 이전입니다.

Q. 마이그레이션 중 문제가 생기면 롤백 가능한가?
2026년 6월 18일 전까지는 Gemini CLI와 Antigravity CLI를 병행해서 사용할 수 있습니다. agy plugin import gemini는 원본 ~/.gemini/ 폴더를 보존하는 방식이므로, 문제가 생기면 기존 gemini 명령으로 돌아가 확인할 수 있습니다.

Q. API 키 관리는 어떻게 바뀌나?
Antigravity CLI의 기본 사용 흐름은 Google OAuth 인증입니다. 별도 API 키를 .env에 저장하지 않아도 됩니다. 다만 Gemini CLI를 유료 API 키 방식으로 계속 쓰는 경우에는 Google Cloud 과금, 예산 알림, 키 보안 설정을 따로 관리해야 합니다.

Q. MCP 서버 설정은 그대로 옮겨지나?
대부분의 MCP 설정은 이전 대상이지만, 원격 MCP 서버나 커스텀 설정은 일부 수동 확인이 필요할 수 있습니다. 마이그레이션 후 /mcp에서 실제 로드 여부를 확인하세요.

Q. 무료 계정으로도 Antigravity CLI를 쓸 수 있나?
사용할 수 있습니다. 다만 사용 가능한 모델과 한도는 계정·플랜에 따라 달라질 수 있으니, 설치 후 /model과 /usage에서 직접 확인하는 것이 정확합니다.

Q. Antigravity CLI와 Antigravity 2.0 데스크톱 앱은 같은 건가?
다릅니다. Antigravity CLI는 터미널용 에이전트 도구이고, Antigravity 2.0은 여러 에이전트를 관리하는 데스크톱 앱입니다. 코드 에디터 환경까지 원한다면 Antigravity IDE를 별도로 확인해야 합니다.

Gemini CLI 마이그레이션 체크리스트

• ☐ agy 설치 후 첫 실행으로 Google OAuth 인증 완료
• ☐ agy plugin import gemini 실행
• ☐ /skills, /mcp, /usage로 로드 상태 확인
• ☐ 워크스페이스 스킬 폴더가 있다면 원본을 보존한 상태로 복사
• ☐ 평소 쓰던 Gemini CLI 작업 하나를 agy 기준 명령어로 바꿔 결과 확인
• ☐ CI 스크립트의 gemini 호출부를 찾아 agy 기준으로 옵션까지 검증
• ☐ MCP 서버를 쓰는 프로젝트라면 실제 작업을 한 번 실행해 연결 상태 확인
• ☐ 유료 API 키를 계속 쓸 경우 Google Cloud 예산 알림과 사용량 제한 설정

CI 스크립트에 gemini 호출이 남아 있으면 2026년 6월 18일 이후 해당 호출부에서 오류가 날 수 있습니다. 단순 치환으로 끝내기보다, 실제 명령어 옵션과 출력 결과까지 확인하는 것이 안전합니다.

함께 보면 좋은 글

• AI 에이전트란? 뜻, 챗봇과의 차이, 구글 검색이 바뀌는 이유
• Gemini Intelligence가 바꾸는 안드로이드 AI 사용법

출처

• Google Developers Blog, Transitioning Gemini CLI to Antigravity CLI
• Google Antigravity Docs, Migrating from Gemini CLI
• Google Antigravity Blog, Introducing Google Antigravity 2.0
• GitHub, google-antigravity/antigravity-cli

※ 본 글은 2026년 5월 27일 기준 Google Developers Blog, Google Antigravity 공식 문서, Google I/O 2026 발표 내용을 참고해 작성했습니다. 플랜명, 가격, 명령어, 지원 범위는 변경될 수 있으므로 최신 정보는 공식 문서에서 확인하시기 바랍니다.