gemini cli 서비스 종료 — antigravity cli 이전

Gemini CLI는 2026년 6월 18일부로 무료·Google AI Pro·Ultra 사용자에게 요청 처리를 중단했습니다. 대신 구글이 내놓은 후속 터미널 도구가 Antigravity CLI이고, 실행 명령은 agy 입니다. 다만 모두가 끊긴 것은 아닙니다 — Gemini Code Assist Standard·Enterprise 라이선스로 쓰던 조직은 그대로이고, 유료 API 키로 쓰는 경로도 살아 있습니다. 아래는 구글 공식 공지와 Antigravity 공식 문서에서 확인한 날짜·영향 범위·이전 절차입니다. (2026년 8월 29일 확인 · Antigravity CLI 1.1.22)

1. 누가 언제부터 끊겼나

공지는 2026년 5월 19일에 나왔고, 중단일은 6월 18일입니다. 대상이 갈리므로 표로 정리합니다.

쓰던 방식	6월 18일 이후
구글 계정 무료 사용 (Gemini Code Assist for individuals)	요청 처리 중단
Google AI Pro · Ultra 구독	요청 처리 중단
Gemini Code Assist for GitHub	신규 설치 불가, 이후 몇 주에 걸쳐 요청 처리도 중단
Gemini Code Assist Standard · Enterprise 라이선스	그대로 사용 가능 (공지 원문: access remains unchanged)
유료 Gemini API 키 / Gemini Enterprise Agent Platform API 키	그대로 사용 가능

💡 "프로젝트가 죽었다"와는 다릅니다. 확인해 보면 @google/gemini-cli 는 지금도 npm에 새 버전이 올라오고 있고(확인 시점 0.57.0), GitHub 저장소도 보관 처리되지 않은 Apache-2.0 오픈소스 그대로입니다. 끊긴 것은 "무료·구독 계정으로 붙는 백엔드"입니다.

2. Antigravity CLI 설치 (agy)

공식 문서가 안내하는 설치 명령은 운영체제별로 다음과 같습니다.

# macOS · 리눅스
curl -fsSL https://antigravity.google/cli/install.sh | bash

# 윈도우 (PowerShell)
irm https://antigravity.google/cli/install.ps1 | iex

# 윈도우 (CMD)
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

설치되는 실행 파일 이름은 agy 이고, 기본 위치는 아래와 같습니다.

운영체제	설치 경로
macOS · 리눅스	~/.local/bin/agy
윈도우	C:\Users\<사용자명>\AppData\Local\agy\bin

설치한 뒤 작업할 프로젝트 폴더로 이동해 agy 를 실행하면 터미널 화면(TUI)이 뜹니다.

⚠️ npm에서 antigravity-cli 를 설치하지 마세요. 이름이 같은 패키지가 npm에 있지만 설명이 "placeholder"인 0.0.1 버전이고 구글의 배포처가 아닙니다. Antigravity CLI는 Go로 만든 실행 파일이라 위 설치 스크립트로 받습니다.

3. 쓰던 설정 옮기기

처음 agy 를 실행하면 기존 설정을 감지해 무엇을 가져올지 목록으로 물어봅니다. 그때 놓쳤다면 나중에 명령으로도 됩니다.

agy plugin import gemini

기존 확장(extension)을 뒤져 플러그인으로 바꾸고, 그 안의 명령·스킬·MCP 서버 정의를 옮깁니다. 공식 문서에 실린 출력 예시는 이런 모양입니다.

[ok]   google-workspace
  skills     : 5 skills processed
  agents     : skipped (none detected)
  commands   : 2 legacy commands converted to skills
  mcpServers : 1 server definition migrated to mcp_config.json

손으로 옮겨야 하는 것 — 스킬 폴더

자동으로 안 되는 게 하나 있습니다. 프로젝트 안에 만들어 둔 스킬 폴더는 직접 옮겨야 새 CLI가 알아봅니다.

구분	Gemini CLI	Antigravity CLI
전역 스킬	~/.gemini/skills/	~/.gemini/antigravity-cli/skills/
프로젝트 스킬	.gemini/skills/	.agents/skills/

MCP 설정은 파일이 분리됐다

예전에는 ~/.gemini/settings.json 안에 MCP 서버를 같이 적었지만, 이제는 전용 파일로 빠졌습니다.

범위	새 위치
전역	~/.gemini/config/mcp_config.json
프로젝트	.agents/mcp_config.json

원격 서버(SSE·웹소켓)를 손으로 옮긴다면 주소를 담는 키 이름도 바뀐 점을 놓치기 쉽습니다. 예전 url·httpUrl 대신 serverUrl 을 씁니다.

{
  "mcpServers": {
    "remote-indexer": {
      "serverUrl": "https://mcp.internal.enterprise.com/sse",
      "env": {
        "AUTH_TOKEN": "secure_alpha_token"
      }
    }
  }
}

등록 명령과 안 붙을 때 확인할 것들은 gemini cli mcp 설정 글에 정리해 두었는데, 위치와 키 이름만 위 표대로 바꿔 읽으면 그대로 통합니다.

그대로 두면 되는 것 — 규칙 파일

GEMINI.md 와 AGENTS.md 는 손댈 필요가 없습니다. Antigravity CLI도 작업 폴더의 두 파일을 그대로 읽고, 전역 규칙은 여전히 ~/.gemini/GEMINI.md 를 봅니다.

4. 그래서 무엇이 달라졌나

항목	내용
유지되는 기능	스킬, 훅, 서브에이전트, 확장(이제 플러그인)
달라진 실행 방식	여러 에이전트를 백그라운드로 돌리는 비동기 작업 지원
구현	Go로 작성. 데스크톱 앱(Antigravity 2.0)과 같은 엔진을 공유
아쉬운 점	기능이 1:1로 같지는 않다고 공지에 명시. 일부 테마·시각 효과는 이전되지 않음
소스 공개	공개 저장소에 README·변경 로그·예제만 있고 소스 코드는 없습니다

자주 묻는 질문 (FAQ)

Q. 무료로 계속 쓸 방법은 없나요?
Gemini CLI를 구글 계정 무료 사용으로 붙이는 경로는 닫혔습니다. 터미널에서 계속 쓰려면 Antigravity CLI로 옮기거나, Gemini API 키를 발급받아 붙이는 방식으로 바꿔야 합니다.

Q. 회사에서 쓰고 있는데 당장 옮겨야 하나요?
Gemini Code Assist Standard·Enterprise 라이선스로 쓰고 있다면 아닙니다. 공지에 접근 권한이 그대로라고 명시돼 있습니다.

Q. 로그인이 안 되는데 종료 때문인가요?
꼭 그렇진 않습니다. 인증 방식 설정 누락처럼 예전부터 있던 원인이 훨씬 흔합니다. gemini cli 로그인 안됨 글의 항목을 먼저 훑어보고, 그래도 안 되면 계정 종류를 확인하세요.

Q. 남은 무료 한도를 확인하고 싶습니다.
한도 표시는 계정 종류에 따라 다릅니다. Gemini CLI 쪽 확인 방법은 gemini cli 사용량 확인 글에 정리해 두었고, Antigravity CLI에는 /usage 와 /credits 명령이 따로 있습니다.

Q. 예전 설정을 지워야 하나요?
아닙니다. ~/.gemini 는 그대로 두세요. Antigravity CLI도 그 아래 경로 일부(GEMINI.md, 전역 스킬, MCP 설정)를 계속 씁니다.

마무리

정리하면, 무료·Pro·Ultra로 쓰던 Gemini CLI는 6월 18일에 백엔드가 끊겼고 후속은 agy 입니다. 옮길 때 손이 가는 곳은 세 군데입니다 — 프로젝트 스킬 폴더(.gemini/skills → .agents/skills), MCP 설정 파일 분리, 원격 서버의 serverUrl 키. 나머지는 첫 실행 때 안내되는 가져오기로 대부분 넘어갑니다. 회사 라이선스로 쓰고 있다면 서두를 이유는 없습니다.

---

📚 참고 출처 (2026년 8월 29일 원문 확인 · Antigravity CLI 1.1.22)
· Google Developers Blog — Transitioning Gemini CLI to Antigravity CLI
· Antigravity CLI — Getting Started
· Antigravity CLI — Migrating from Gemini CLI