제미나이 CLI는 터미널에서 Gemini 모델에게 코드 작업을 맡기는 구글의 오픈소스 도구입니다. 그런데 2026년 6월 18일부터 무료 사용자와 Google AI Pro·Ultra 구독자는 제미나이 CLI를 더 이상 쓸 수 없고, 후속 도구인 안티그래비티 CLI로 옮겨야 합니다. 아직 검색되는 설치 글 상당수가 "Google 로그인만 하면 하루 1,000회 무료"라는 예전 기준이라, 이 글은 2026년 10월 12일 구글 공식 블로그와 geminicli.com·antigravity.google 문서를 기준으로 지금 쓸 수 있는 사람과 옮기는 법을 정리했습니다.
제미나이 CLI, 지금 내 계정으로 쓸 수 있나요?
구글은 2026년 5월 19일 개발자 블로그에서 전환을 예고했고, 6월 18일에 실행했습니다. 계정 유형에 따라 갈립니다.
| 계정 유형 | 기존 CLI 사용 | 공식 안내 |
|---|---|---|
| 무료(Google 로그인, Code Assist for individuals) | 2026년 6월 18일 종료 | 안티그래비티 CLI로 이동 |
| Google AI Pro·Ultra 구독 | 2026년 6월 18일 종료 | 안티그래비티 CLI로 이동 |
| Gemini Code Assist Standard·Enterprise | 계속 사용 | 변화 없음(하루 1,500회·2,000회) |
| 유료 Gemini API 키 | 계속 사용 | 쓴 만큼 과금 |
정리하면 개인이 무료나 구독으로 쓰던 기존 CLI는 끝났고, 회사 라이선스나 유료 API 키가 있는 경우만 남았습니다. 구독 요금제 자체가 궁금하다면 제미나이 요금제 정리에서 무료·Plus·Pro·Ultra 차이와 API 요금이 따로인 이유를 먼저 보시면 됩니다.
참고
geminicli.com 할당량 문서에는 아직 무료 API 키 항목(하루 250회, Flash 모델만)이 남아 있지만, 전환 공지 글은 "유료 API 키"로 계속 쓸 수 있다고만 적고 있습니다. 무료 키로 오래 쓸 계획이라면 실제로 요청이 처리되는지 먼저 확인하세요.
제미나이 CLI는 어떻게 설치하나요?
회사 라이선스나 유료 API 키가 있어서 계속 쓴다면 설치는 그대로입니다. 공식 문서 기준 Node.js 20.0.0 이상이 필요하고, macOS 15 이상, Windows 11 24H2 이상, Ubuntu 20.04 이상을 지원합니다.
# npm (전역 설치)
npm install -g @google/gemini-cli
# Homebrew (macOS·Linux)
brew install gemini-cli
# 설치 없이 한 번만 실행
npx @google/gemini-cli
설치 후 프로젝트 폴더에서 gemini를 실행하면 인증 방법을 고르는 화면이 나옵니다. 유료 API 키를 쓰는 경우 환경변수 GEMINI_API_KEY에 키를 넣고, Vertex AI나 Code Assist 라이선스는 조직의 Google Cloud 프로젝트를 지정합니다. 제미나이 CLI는 Apache 2.0 라이선스의 오픈소스라 GitHub(google-gemini/gemini-cli)에서 코드도 볼 수 있습니다.
GEMINI.md와 MCP는 어떻게 쓰나요?
이 도구에서 프로젝트 규칙은 GEMINI.md 파일에 적습니다. 빌드 명령, 코드 스타일, 건드리면 안 되는 폴더 같은 내용을 두면 세션마다 이 파일을 읽고 그 규칙대로 움직입니다. 클로드 코드의 CLAUDE.md와 같은 역할이고, 실제로 이 블로그도 클로드 코드의 CLAUDE.md에 같은 종류의 규칙을 적어 두고 운영합니다.
외부 도구 연결은 MCP(Model Context Protocol)로 합니다. 설정은 ~/.gemini/settings.json에 MCP 서버를 등록하는 방식입니다. MCP가 무엇이고 어떤 서버를 믿고 연결해도 되는지는 클로드 MCP 연결 방법에 보안 주의점까지 정리해 두었는데, 프로토콜이 같아서 여기에도 그대로 적용됩니다.
안티그래비티 CLI로는 어떻게 옮기나요?
무료·AI Pro·Ultra 사용자라면 이제 안티그래비티 CLI가 답입니다. 구글은 이 도구를 Go로 새로 만들었고, 여러 에이전트를 백그라운드에서 돌리는 기능과 데스크톱 앱(Antigravity 2.0)과 같은 에이전트 구조를 쓴다고 설명합니다. 다만 공지 글에서 처음부터 기능이 1:1로 같지는 않다고 밝혔습니다. 데스크톱·IDE까지 포함한 전체 구성은 구글 안티그래비티 사용법에 따로 정리했습니다.
설치와 첫 실행
# macOS, Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
# Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex
명령어는 agy입니다. 예전 설정이 있는 환경에서 처음 실행하면 온보딩 체크리스트가 뜨고, 로그인 세션을 운영체제 키체인으로 옮겨 줍니다.
옮길 때 바뀌는 것
| 항목 | 기존(gemini) | 안티그래비티(agy) |
|---|---|---|
| 프로젝트 규칙 | GEMINI.md | GEMINI.md·AGENTS.md 그대로 읽음 |
| MCP 설정 | ~/.gemini/settings.json 안 | ~/.gemini/config/mcp_config.json, .agents/mcp_config.json |
| 원격 MCP 주소 키 | url 또는 httpUrl | serverUrl |
| 확장 | extensions | 플러그인(agy plugin import gemini 로 변환) |
| 워크스페이스 스킬 | .gemini/skills/ | .agents/skills/ (직접 옮겨야 함) |
규칙 파일은 그대로 두면 되고, 손이 가는 곳은 MCP 설정과 스킬 폴더 두 군데입니다. 특히 워크스페이스 스킬은 공식 문서가 직접 이름을 바꾸거나 옮겨야 한다고 적어 두었으니, 옮긴 뒤 스킬이 안 불리면 폴더 위치부터 확인하세요.
안티그래비티 CLI는 무료인가요, 얼마나 쓸 수 있나요?
안티그래비티 요금 문서에는 가격 숫자가 없고 할당량 방식만 나옵니다. Google AI Ultra는 가장 넉넉한 할당량이 5시간마다 갱신되고, Pro는 주간 한도에 닿을 때까지 5시간마다 갱신됩니다. Pro·Ultra가 아닌 사용자는 주 단위로 갱신되는 할당량을 받습니다. 모든 요금제에서 CLI를 쓸 수 있고, Pro·Ultra는 할당량을 넘긴 뒤 AI 크레딧을 사서 이어 쓸 수 있습니다.
할당량이 "작업량 기준"이라는 점이 중요합니다. 단순한 요청은 여러 번 보낼 수 있지만 여러 파일을 고치는 복잡한 작업은 할당량을 빨리 씁니다. 크레딧 초과 설정을 "Always"로 두면 한도를 넘는 순간부터 돈이 나가므로, 처음에는 "Never"로 두고 한 주 동안 얼마나 쓰는지 보는 편이 안전합니다.
제미나이 CLI 대신 다른 도구를 쓰는 게 나을 때는?
옮기는 김에 도구 자체를 다시 고르는 것도 방법입니다. 판단 기준은 이렇습니다.
| 상황 | 맞는 선택 |
|---|---|
| 구글 생태계(Gemini 구독, Google Cloud)를 이미 쓴다 | 안티그래비티 CLI |
| 회사가 Code Assist Standard·Enterprise 라이선스를 준다 | 기존 CLI 계속 사용 |
| 터미널에서 여러 파일을 맡기고 규칙 파일을 중심으로 일한다 | 클로드 코드 |
| 편집기 안에서 자동완성과 대화를 같이 쓴다 | 커서AI |
클로드 코드는 무료 요금제에 포함되지 않아 Pro 구독(연간 결제 시 월 $17)부터 시작해야 한다는 점이 차이입니다. 무료로 계속 시작하고 싶다면 안티그래비티 CLI의 주간 할당량이 지금 남은 선택지입니다.
이 방법이 안 통하는 경우는?
- 무료 계정으로 제미나이 CLI를 새로 설치하는 경우: 설치는 되지만 요청이 처리되지 않습니다. 예전 블로그 글의 "로그인만 하면 무료" 안내를 따르면 여기서 막힙니다.
- 회사 보안 정책이 새 CLI 설치를 막는 경우: 안티그래비티 CLI는 설치 스크립트가 셸 프로필의 PATH를 고칩니다.
--skip-path옵션이 있지만, 승인 없이 설치하기 전에 보안 담당자와 확인하세요. - 커스텀 테마나 실험 기능에 기대던 경우: 마이그레이션 문서는 일부 터미널 테마와 실험적 화면 기능이 옮겨지지 않을 수 있다고 적고 있습니다.
- CI에서 무인으로 돌리는 경우: 안티그래비티 CLI에서 API 키를 쓰려면
GEMINI_API_KEY만으로는 안 되고, 설정 파일에modelProvider를gemini로 지정해야 합니다.
정리: 지금 무엇을 하면 되나요?
- 내 계정이 무료·AI Pro·Ultra라면 기존 도구 대신 안티그래비티 CLI를 설치합니다.
- GEMINI.md는 그대로 두고, MCP 설정과 워크스페이스 스킬 폴더만 새 위치로 옮깁니다.
- 회사 라이선스나 유료 API 키가 있다면 지금 쓰는 CLI를 그대로 써도 됩니다.
- 처음 한 주는 크레딧 초과를 꺼 두고 할당량 소모를 본 뒤, 부족하면 요금제나 도구를 다시 고릅니다.
AI 코딩 도구로 만든 서비스를 실제로 운영까지 가져가는 과정이 궁금하다면 바이브코딩이란?에 막히는 지점을 정리해 두었습니다.
참고 자료
- An important update: transitioning Gemini CLI to Antigravity CLI — Google Developers Blog
- Gemini CLI 할당량과 요금 — geminicli.com
- Gemini CLI 설치 — geminicli.com
- google-gemini/gemini-cli — GitHub
- Antigravity CLI 설치와 인증 — antigravity.google
- Gemini CLI에서 옮기기 — antigravity.google
- Antigravity 요금제와 AI 크레딧 — antigravity.google
