실전 가이드

Gemini CLI에서 Antigravity CLI로 옮기기: 설치와 마이그레이션

6월 18일부터 Gemini CLI는 무료, AI Pro, AI Ultra 계정을 지원하지 않는다. 영향 대상과 Antigravity CLI 설치, 이전 방법을 정리한다.

작성: Audryk · 2026년 10월 20일

• 실전 가이드
• 코딩 에이전트
• #가이드
• #Google
• #MCP

Google은 2026년 5월 19일 개인 계정에서 Antigravity CLI가 Gemini CLI를 대체한다고 발표했다(Google Developers Blog). 전환은 2026년 6월 18일에 이뤄졌다. 이 가이드는 영향받는 대상을 먼저 정리한 뒤, Antigravity 공식 문서를 기준으로 설치와 마이그레이션을 설명한다. 문서는 2026년 10월 20일에 확인했다.

영향받는 대상은?

• 영향받음: 2026년 6월 18일부터 Gemini CLI와 Gemini Code Assist IDE 확장은 Google AI Pro와 AI Ultra 구독자, 그리고 Gemini Code Assist for individuals의 무료 사용자를 더 이상 지원하지 않는다. "Login with Google" 옵션으로는 Gemini CLI에 접근할 수 없다(Google).
• 영향받지 않음: Gemini Code Assist Standard 또는 Enterprise 라이선스를 보유하거나 Google Cloud를 통해 Gemini Code Assist for GitHub를 쓰는 조직. 유료 Gemini 또는 Gemini Enterprise Agent Platform API 키로도 Gemini CLI에 계속 접근할 수 있다(Google Developers Blog). Google의 지원 중단 안내 페이지에 따르면 Standard와 Enterprise 구독은 별도 일정을 따른다(Google).

Google에 따르면 Antigravity CLI는 처음부터 완전한 기능 동등성을 제공하지는 않지만, 핵심으로 보는 기능인 Agent Skills, Hooks, Subagents, 그리고 이제 plugins라 부르는 Extensions는 유지한다. Go로 만들어졌으며 Antigravity 2.0 데스크톱 앱과 같은 에이전트 하네스를 공유한다.

Antigravity CLI 설치

명령어 이름은 agy다(Antigravity).

macOS, Linux, Googlebook (바이너리는 ~/.local/bin/agy에 설치됨):

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

Windows PowerShell (바이너리는 C:\Users\<username>\AppData\Local\agy\bin에 설치됨):

irm https://antigravity.google/cli/install.ps1 | iex

Windows CMD:

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

새 터미널에서 설치를 확인한다.

agy --version

처음 실행하면 설정 과정에서 색 구성표와 렌더링 모드(전체 화면 버퍼 또는 터미널 기록에 인라인)를 묻는다.

로그인

agy는 실행할 때 운영체제의 보안 키링(Apple Keychain, Linux Secret Service, Windows Credential Manager)에서 세션을 찾는다. 없으면 브라우저를 열어 준다. 개인 Google 계정(Free, Pro, Ultra 플랜)으로 로그인하거나, Gemini Enterprise 계정이면 "Business account"를 선택한다(Antigravity). SSH로 접속한 경우 CLI가 직접 열어야 할 URL을 알려 준다.

Gemini CLI 설정 이전

처음 실행할 때 agy가 Gemini CLI 설정을 감지하면, 확장과 전역 설정을 변환하고 세션 토큰을 시스템 키링으로 옮기도록 제안하는 대화형 체크리스트가 나온다(Antigravity).

수동으로 Gemini 확장을 Antigravity 플러그인으로 변환하려면 다음 명령을 쓴다.

agy plugin import gemini

이 명령은 이전 로컬 디렉터리를 스캔해 스킬, 명령(스킬로 변환됨), MCP 서버 정의를 변환한다.

그대로인 것: 프로젝트의 GEMINI.md와 AGENTS.md 컨텍스트 파일, 그리고 전역 ~/.gemini/GEMINI.md는 그대로 읽는다.

바뀌는 것:

• 전역 스킬: ~/.gemini/skills/에서 ~/.gemini/antigravity-cli/skills/로.
• 프로젝트 스킬: .gemini/skills/에서 .agents/skills/로. 에이전트가 인식하려면 이 폴더를 직접 옮겨야 한다.
• MCP 서버: 더 이상 ~/.gemini/settings.json에 선언하지 않고 전용 파일인 ~/.gemini/config/mcp_config.json(전역)과 .agents/mcp_config.json(프로젝트)에 선언한다.
• 원격 MCP 서버: 수동으로 이전할 때 url 또는 httpUrl 키가 serverUrl로 바뀐다.

공식 mcp_config.json 예시:

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

Gemini CLI의 일부 사용자 지정 터미널 테마나 실험적 시각 오버레이는 옮겨지지 않을 수 있다. 다른 에이전트와 공통인 MCP 원칙은 MCP 서버 설정 방법 가이드를 참고하길 바란다.

할당량과 플랜

Antigravity는 Google 서비스 약관에서 파생된 조건으로 개인 계정에 제공된다(Antigravity). 모든 플랜에 핵심 에이전트 모델로서 Gemini 3.8 Flash를 포함한 Gemini 모델과 CLI 접근이 들어 있다. 한도는 플랜마다 다르다.

• Google AI Pro나 Ultra가 없는 경우: 주간 할당량과 주간 속도 제한;
• Google AI Pro: 5시간마다 갱신되는 할당량, 더 높은 주간 한도까지;
• Google AI Ultra: 5시간마다 갱신되는 가장 높은 할당량, 그리고 서드파티 모델 접근.

Pro와 Ultra 구독자는 할당량을 넘는 사용을 위해 AI 크레딧을 구매할 수 있다. Google은 추가 속도 제한을 위한 bring-your-own-key(BYOK)를 지원하지 않는다. CLI에서 /usage는 모델별 할당량 사용량을, /credits는 크레딧 잔액을 보여 준다(명령어 레퍼런스).

유용한 명령어

• /model은 모델을 고른다(선택은 세션 간에 유지됨);
• /mcp는 MCP 서버 관리자를, /plugin은 플러그인 관리자를 연다;
• /resume은 이전 대화를 불러오고, /rewind는 이전 메시지로 되돌린다;
• /permissions는 도구 권한을 관리하고, /exit는 종료한다.

더 알아보기

• Google의 주력 모델: Gemini 4 Argon 도구 페이지. Google에 따르면 Antigravity CLI에서 쓸 수 있지만 Antigravity IDE에서는 쓸 수 없다.
• 그 밖의 무료 또는 저렴한 선택지: 예산에 맞춰 코딩 에이전트 고르기.
• 가장 많이 팔로우되는 에이전트 중 하나인 Gemini CLI: GitHub의 오픈소스 코딩 에이전트.

출처

• Google Developers Blog: An important update: Transitioning Gemini CLI to Antigravity CLI (2026년 5월 19일), (확인일: 2026-10-20)
• Google: Gemini Code Assist consumer accounts, (확인일: 2026-10-20)
• Antigravity Docs: Getting started, (확인일: 2026-10-20)
• Antigravity Docs: Authenticate, (확인일: 2026-10-20)
• Antigravity Docs: Migration (Gemini CLI), (확인일: 2026-10-20)
• Antigravity Docs: Plans, (확인일: 2026-10-20)
• Antigravity Docs: CLI commands, (확인일: 2026-10-20)

핵심 요약: 개인 Google 계정은 확장과 MCP 서버를 가져오는 Antigravity CLI(agy)로 옮겨야 하며, 프로젝트 스킬만 .agents/skills/로 직접 옮기면 된다.

이 기사에서 오류를 발견하셨나요? 제보하기 · 정정 정책