Gemini CLI 종료: 오류 원인, Antigravity CLI 전환과 삭제 방법

개인 Google 계정으로 로그인해 쓰던 Gemini CLI는 2026년 6월 18일 종료됐다. 무료 사용자와 Google AI Pro·Ultra 구독자 모두 해당한다. 대체 도구는 Antigravity CLI(agy 명령)이고, 무료 계정과 기존 AI Pro·Ultra 구독으로 쓸 수 있다. 유료 Gemini API 키나 회사의 Gemini Code Assist Standard·Enterprise 라이선스로는 지금도 Gemini CLI를 쓸 수 있다. (Google 발표)

개인용 로그인에서 지원 종료 안내가 나올 때

개인용 로그인을 계속 쓰려 할 때 클라이언트 지원 종료 안내가 나오면, Google의 6월 18일 종료 대상에 해당하는지 확인한다. 개인용 계정 로그인의 종료는 Gemini CLI 패키지를 다시 설치하는 것으로 해결되지 않는다. 유료 API 키나 기업 라이선스로 이용 중이라면 해당 인증 방식의 설정을 따로 확인한다.

누가 계속 쓸 수 있나

사용 방식	6월 18일 이후
무료 개인 로그인	종료. Antigravity CLI로 이전
Google AI Pro·Ultra 계정 로그인	종료. Antigravity CLI로 이전
Gemini Code Assist IDE 확장(개인)	종료
Gemini Code Assist for GitHub(개인)	새 설치 불가, 이후 요청 처리 중단
유료 Gemini API 키, Enterprise Agent Platform API 키	계속 사용 가능
회사의 Gemini Code Assist Standard·Enterprise 라이선스	변화 없음

Google은 기업 고객을 위해 Gemini CLI에 최신 모델과 보안 수정을 계속 넣는다고 밝혔다. 오픈소스 저장소(Apache 2.0)도 남는다. (GitHub 공지)

Antigravity CLI로 옮기기

1. 설치한다. PowerShell에서 irm https://antigravity.google/cli/install.ps1 | iex를 실행한다. 로그인과 한국어 설정은 Antigravity 사용법에 있다.
2. agy를 처음 실행한다. 기존 Gemini CLI 설정을 찾아 옮길 확장과 전역 설정을 고르는 목록을 보여 준다. 로그인 토큰은 운영체제 키링으로 옮겨진다.
3. 확장을 플러그인으로 바꾼다. 목록에서 빠진 확장은 agy plugin import gemini로 변환한다.
4. 워크스페이스 스킬 폴더를 옮긴다. 프로젝트의 .gemini/skills/는 자동으로 인식되지 않으니 .agents/skills/로 옮긴다.
5. MCP 서버 설정을 옮긴다. 원격 서버 주소 키 url·httpUrl은 serverUrl로 바꾸고, 로컬 서버는 그대로 command로 실행한다.

항목	Gemini CLI	Antigravity CLI
명령	gemini	agy
전역 스킬	~/.gemini/skills/	~/.gemini/antigravity-cli/skills/
워크스페이스 스킬	.gemini/skills/	.agents/skills/
전역 MCP 설정	~/.gemini/settings.json 안	~/.gemini/config/mcp_config.json
워크스페이스 MCP 설정	설정 파일 안	.agents/mcp_config.json
확장	Extensions	플러그인

GEMINI.md와 AGENTS.md 규칙 파일은 그대로 쓰고, 전역 규칙 ~/.gemini/GEMINI.md도 계속 읽는다. 일부 터미널 테마와 실험 기능은 지원되지 않을 수 있다. (이전 가이드)

사용 한도도 바뀐다. 무료는 매주, Google AI Pro·Ultra는 5시간마다 주간 한도 안에서 갱신되고, AI Ultra의 한도가 가장 크다. 모든 요금제가 Gemini 3.1 Pro와 3.8 Flash를 쓸 수 있다. Pro·Ultra는 한도를 넘으면 구매한 AI 크레딧으로 이어 쓰고, 설정의 AI Credit Overages에서 자동 사용 여부를 정한다. (요금제)

Gemini CLI 삭제

npm으로 전역 설치했다면 npm list -g @google/gemini-cli로 확인하고 다음 명령으로 지운다. (삭제 문서)

npm uninstall -g @google/gemini-cli

설정 폴더 %USERPROFILE%\.gemini는 통째로 지우지 않는다. Antigravity CLI도 이 폴더 안의 antigravity-cli와 config 폴더를 쓴다. 9월 28일 읽기 전용 확인 기록에서도 이 PC의 .gemini 안에 antigravity, antigravity-cli, antigravity-ide 폴더가 함께 있었다.

유료 API 키·기업 라이선스로 계속 쓸 때

Node.js 20 이상에서 npm install -g @google/gemini-cli로 설치하고 gemini를 실행한다. 명령을 못 찾으면 새 터미널을 연다. (설치 문서)

• 유료 Gemini API 키: GEMINI_API_KEY 환경 변수를 설정하고 Use Gemini API key를 고른다. 키 발급은 Gemini API 키 발급 방법을 본다.
• 회사 라이선스: Google 로그인에 더해 Google Cloud 프로젝트 ID, Gemini for Cloud API 활성화, IAM 권한이 필요하다.
• Vertex AI: GOOGLE_CLOUD_PROJECT, GOOGLE_CLOUD_LOCATION과 Vertex AI API 활성화가 필요하다.

(인증 문서) 인증 방식에 따라 사용 한도와 청구 주체가 달라진다. 첫 요청은 파일을 바꾸지 않는 저장소 설명으로 하고, 한 번만 실행할 때는 gemini -p "질문"을 쓴다.

자주 묻는 질문

Gemini 앱(웹)도 종료됐나? 아니다. 종료된 것은 개인 계정으로 쓰던 Gemini CLI와 Code Assist 개인용이다. Gemini 웹·앱은 그대로다.

무료로 계속 코딩 에이전트를 쓰려면? Antigravity를 쓴다. 개인 Google 계정이면 무료로 쓰고 주간 한도가 있다.