Gemini CLI가 큰 전환을 맞은 것은 사실이지만 “모든 사용자에게 완전히 종료됐다”는 설명은 정확하지 않습니다. Google은 2026년 6월 18일부터 개인 free 계정과 개인 Google AI Pro·Ultra 계정의 Gemini CLI 요청을 중단했습니다. 이 계정들은 더 이상 Login with Google로 예전 CLI를 사용할 수 없습니다.
반면 Gemini Code Assist Standard·Enterprise, Google Cloud, API key 인증은 같은 중단 대상이 아닙니다. 오픈소스 저장소와 설치 패키지도 남아 있습니다. 따라서 삭제나 재설치보다 먼저 현재 인증 경로를 확인해야 합니다.
계정과 인증부터 구분하기
| 기존 사용 방식 | 현재 상태 | 적절한 다음 단계 |
|---|---|---|
| 개인 무료 Google 계정 | Gemini CLI 요청 지원 종료 | Antigravity CLI로 이전 |
| 개인 Google AI Pro / Ultra | 예전 CLI 요청 지원 종료 | Antigravity CLI로 이전 |
| Gemini Code Assist Standard / Enterprise | 공식 문서상 접근 변경 없음 | 조직의 지원 계획에 따라 유지 또는 이전 |
| Google Cloud | consumer 종료 범위 밖 | 프로젝트·권한·결제 주체를 확인하고 유지 |
| Gemini / Enterprise API key | API-key 인증은 영향 없음 | 요구사항을 충족하면 기존 경로 유지 |
| 패키지는 설치되지만 요청 실패 | 설치 여부만 확인된 상태 | 실제 인증과 무해한 요청을 확인 |
Google의 consumer 계정 deprecation 문서는 종료된 개인 tier와 Google Login, 그리고 영향받지 않는 Standard·Enterprise를 따로 명시합니다.
같은 gemini 명령이 개인 노트북에서는 실패하고 회사 환경에서는 동작할 수 있습니다. 로컬 명령이 같아도 서비스가 확인하는 entitlement가 다르기 때문입니다.
설치할 수 있다는 사실은 서비스 접근을 증명하지 않는다
다음 세 가지는 별개입니다.
- GitHub 저장소가 공개돼 있다.
- CLI를 설치하고 화면을 열 수 있다.
- 선택한 계정이 실제 모델 응답을 받는다.
앞의 두 조건이 참이어도 마지막 조건은 거짓일 수 있습니다. Google의 전환 공지는 개인 tier 종료와 Apache 2.0 저장소 및 enterprise 업데이트 지속을 동시에 설명합니다.
현재 Gemini CLI README에는 개인 무료 tier와 Google 로그인 설명이 여전히 남아 있어 혼란을 더합니다. 그러나 이 일반 문서는 뒤에 나온 구체적인 deprecation 페이지와 충돌합니다. 현재 가용성은 날짜와 영향을 명확히 적은 후속 공지를 기준으로 판단해야 합니다.
CLI가 실행되더라도 인증이 Google Login, 조직 라이선스, Cloud, API key 중 무엇인지 확인하세요. 실제 read-only 요청이 성공하는지, 의도한 프로젝트와 과금 주체를 쓰는지, headless script가 오래된 OAuth session을 암묵적으로 재사용하지 않는지도 봐야 합니다.
개인 사용자의 공식 후속은 Antigravity CLI
영향받는 개인 사용자에게 Google이 안내한 후속 제품은 Antigravity CLI입니다. 단순한 command rename이 아니라 Antigravity 2.0과 agent harness를 공유하는 새 terminal surface입니다. Agent Skills, Hooks, Subagents, plugin으로 변환되는 extensions 같은 핵심 개념을 이어받지만 처음부터 완전한 1:1 parity를 약속한 것은 아닙니다.
현재 공식 다운로드 페이지는 macOS와 Linux에 다음 설치 명령을 제공합니다.
bashcurl -fsSL https://antigravity.google/cli/install.sh | bash
Windows에는 PowerShell과 Command Prompt용 명령이 따로 있습니다. 원격 script를 즉시 실행하는 방식이므로 공식 페이지에서 최신 명령과 내용을 먼저 확인하고, 관리 기기라면 조직 정책을 따르세요.
설치 후 시작 명령은 다음과 같습니다.
bashagy
첫 실행에서 legacy Gemini profile을 감지하고 이전 항목을 고를 수 있습니다. 자동 감지는 편리하지만 백업도 아니고 기능 검증도 아닙니다.
바꾸기 전에 보존할 것
실제 workflow를 구성하는 항목을 먼저 기록합니다.
- project와 global
GEMINI.md규칙; - project/global skills;
- MCP server 정의와 필요한 환경 변수 이름;
- custom commands, extensions, hooks, agents;
- headless flags, output format, exit code 처리, timeout;
- 필요한 대화와 checkpoint;
- 조직 proxy, 인증서, permission, audit 조건.
API key나 token 값을 스크린샷, 이슈, 이전 노트, Git에 넣지 마세요. 설정 구조는 보관하되 비밀값은 승인된 secret store에 남겨야 합니다.
이전 전에는 작은 무해 테스트를 준비하면 좋습니다. workspace rule을 읽는지, 예상 MCP server가 보이는지, read-only prompt가 응답하는지, 파일 변경 전에 permission을 요청하는지, structured output parser가 통과하는지를 기록하고 이전 후 똑같이 확인합니다.
Skills 경로와 MCP schema가 바뀐다
Google의 현재 마이그레이션 문서는 설치 성공만으로 알기 어려운 차이를 설명합니다.
Workspace skills
Gemini CLI 경로:
text.gemini/skills/
Antigravity CLI 경로:
text.agents/skills/
global skills도 ~/.gemini/skills/에서 ~/.gemini/antigravity-cli/skills/로 이동합니다. slash command가 보이지 않으면 skill을 다시 만들기 전에 경로와 import 결과를 확인하세요.
Extensions는 plugins로 변환
문서의 명시적 변환 명령은 다음과 같습니다.
bashagy plugin import gemini
결과에서 skills, agents, commands, MCP servers가 각각 처리됐는지 봐야 합니다. skipped는 해당 항목이 없다는 뜻일 수도 있지만, 중요한 custom file을 찾지 못했다는 신호일 수도 있습니다.
MCP는 전용 JSON 사용
Gemini CLI는 보통 MCP 정의를 ~/.gemini/settings.json에 넣었습니다. Antigravity CLI는 다음 파일을 사용합니다.
text~/.gemini/config/mcp_config.json .agents/mcp_config.json
원격 WebSocket/SSE 주소 key는 serverUrl입니다. 기존 url 또는 httpUrl은 업데이트해야 합니다. 일반 chat은 되는데 MCP가 모두 실패한다면 model보다 파일 위치, 주소 key, 환경 변수와 network policy를 먼저 확인하세요. 지원 로그에서는 token을 가려야 합니다.
GEMINI.md, AGENTS.md, global ~/.gemini/GEMINI.md 규칙은 호환된다고 문서화돼 있습니다. 하지만 규칙을 읽는다는 사실이 theme, experimental overlay, extension, permission 동작까지 같다는 뜻은 아닙니다.
되돌릴 수 있는 이전 순서
- 계정과 인증을 분류한다. consumer Google Login과 enterprise·Cloud·API key를 나눈다.
- 기준 상태를 기록한다. version, 주요 command, MCP 목록, 안전한 테스트를 비밀값 없이 남긴다.
- 설정을 백업한다. 규칙, skills, extension manifest, MCP 구조를 보존한다.
- 현재 공식 페이지에서 설치한다. 출처 불명 binary나 consumer OAuth proxy를 사용하지 않는다.
- 첫 import 결과를 읽는다. 중요한
skipped항목을 확인한다. - 경로/schema 차이를 고친다.
.agents/skills/,mcp_config.json,serverUrl을 본다. - 부작용 없이 검증한다. 쓰기나 배포 명령 전에 context, tools, permissions, output 처리를 확인한다.
- 백업을 유지한다. 실제 자동화가 통과하기 전에는 rollback 경로를 없애지 않는다.
증상별 판단
화면은 열리지만 첫 요청이 실패한다. 개인 Google Login이라면 공식 종료 범위와 일치합니다. 예전 CLI 업데이트로 종료된 backend entitlement는 돌아오지 않습니다.
README는 개인 무료 tier를 안내한다. 서비스 복구 공지가 아닙니다. 구체적인 deprecation 문서와 Gemini CLI 팀의 6월 18일 상태 공지를 우선하세요.
Antigravity는 실행되지만 skills가 없다. project .agents/skills/와 새 global 경로를 확인하세요.
chat은 되지만 MCP만 실패한다. 별도 JSON, serverUrl, 환경 변수 전달을 확인하세요.
기업 환경의 Gemini CLI는 계속 된다. 공식 예외와 맞는 결과입니다. 이전 시점은 개인 종료일이 아니라 조직의 support, compliance, 기능 요구로 결정합니다.
결론
정확한 상태는 이렇습니다. Gemini CLI는 개인 free, Google AI Pro, Ultra 요청 경로를 종료하고 해당 사용자를 Antigravity CLI로 이동시켰습니다. Standard·Enterprise, Google Cloud, API-key 인증은 같은 공지로 종료되지 않았습니다.
개인 Google Login 사용자는 재설치 대신 설정을 보존하고 workflow를 이전해야 합니다. enterprise/API-key 사용자는 작동하는 환경을 바꾸기 전에 현재 지원 계약과 조직 계획을 확인하세요. 어느 쪽이든 성공 기준은 설치나 prompt 표시가 아니라, 무해한 end-to-end 작업이 실제로 통과하는 것입니다.
