오늘 Gemini CLI 지원 종료! 후속 agy로의 전체 마이그레이션 단계

Gemini CLI(6월 18일 종료)에서 후속 'Antigravity CLI (agy)'로의 전체 마이그레이션 가이드

오늘 갑자기 Gemini CLI를 사용할 수 없게 되어 놀라신 분들이 많을 것입니다. Google은 개발자 컨퍼런스 'Google I/O 2026'에서 명령줄 AI 도구인 'Gemini CLI'의 개인 및 무료 서비스를 2026년 6월 18일부로 종료한다고 발표했습니다. 이에 따라 사용자들은 새로운 터미널용 후속 AI 에이전트인 'Antigravity CLI(명령어: agy)'로 마이그레이션해야 합니다.

Gemini CLI는 오픈 소스 대화형 CLI로서 엄청난 인기를 누렸으나, 이번 전환을 통해 더 빠른 실행 바이너리 및 백그라운드에서의 병렬 자율 작업 처리 등 더욱 강력한 기능들이 제공될 예정입니다. 이 글에서는 서비스 종료의 영향 범위, 새로운 'agy' 명령어의 강력한 특징, 구체적인 마이그레이션 단계, 그리고 기존 Gemini CLI를 깔끔하게 제거(언인스톨)하는 방법까지 자세히 설명합니다.

서비스 종료의 영향 범위와 마이그레이션 배경

Gemini CLI는 2025년 6월 오픈 소스로 공개된 이후 GitHub에서 10만 개 이상의 스타를 획득하고 6,000개 이상의 풀 리퀘스트가 병합되는 등 매우 활발한 커뮤니티를 형성해 왔습니다. 이번 후속 도구로의 완전한 전환과 함께 진행되는 '소스크로즈화'는 개발자 커뮤니티 내에서 큰 찬반 논쟁을 일으켰습니다.

이번 서비스 종료 및 마이그레이션 데드라인인 '2026년 6월 18일'은 주로 무료 사용자, Google AI Pro/Ultra 요금제 가입자, 개별 Gemini Code Assist 사용자에게 적용됩니다. 반면, 기업용 Standard/Enterprise 라이선스 또는 Vertex AI 등 Google Cloud를 통해 Gemini CLI를 사용하는 사용자는 현재 영향이 없으며 기존 CLI를 계속 사용할 수 있습니다. 그러나 향후 모든 새로운 기능 개발은 Antigravity CLI에 집중될 예정이므로 장기적으로는 전환을 고려하는 것이 좋습니다.

후속 도구 'Antigravity CLI (agy)'의 성능과 새로운 기능

새로운 도구인 'Antigravity CLI(명령어: agy)'는 기존 TypeScript/Node.js 구현에서 벗어나 Go 언어로 완전히 재작성되었습니다. 그 결과 메모리 소비량이 크게 줄어들고 시작 및 응답 속도가 크게 향상되었습니다. 또한 최첨단 'Gemini 3.5 Flash'를 기본 모델로 채택하여 복잡한 개발 워크플로를 이전보다 훨씬 더 원활하게 처리할 수 있습니다.

가장 주목할 만한 새로운 기능은 '비동기 병렬 백그라운드 서브 에이전트'입니다. 대규모 코드 리팩토링, 문서 작성, 테스트 자동화와 같이 시간이 오래 걸리는 작업을 백그라운드에서 실행할 수 있어 터미널 화면을 차단하지 않고 동시에 병렬 작업을 진행할 수 있습니다. 또한 상호 작용 중에 '@'를 입력하여 파일을 선택 및 첨부하거나 '!'를 사용하여 쉘 명령을 직접 호출하는 등 대화형 개발 효율성을 높이는 많은 단축키가 포함되어 있습니다.\n

비교 항목	Gemini CLI (gemini)	Antigravity CLI (agy)
구현 언어	TypeScript (Node.js)	Go
시작/작동 속도	보통	매우 빠름 / 메모리 효율적
멀티 에이전트 지원	지원 안 함 (단일 작업)	지원함 (백그라운드 비동기 병렬)
개발/배포 모델	오픈 소스 (Apache 2.0)	클로즈드 소스

Antigravity CLI로의 단계별 마이그레이션 절차

마이그레이션 프로세스는 간단하며 주로 다음 단계를 따릅니다:\n

단계 1: 설치 macOS 또는 Linux 환경인 경우 터미널에서 다음 설치 명령을 실행합니다.

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

Windows 환경(PowerShell)의 경우 다음을 실행합니다:

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

단계 2: 최초 실행 및 인증 설치가 완료되면 터미널에서 agy 명령을 실행합니다. 브라우저가 자동으로 열리며 Google OAuth 인증 흐름이 시작됩니다. 기존 Gemini CLI에서 사용하던 Google 계정으로 로그인합니다.\n

단계 3: 기존 설정 가져오기 다음 명령을 실행하면 Gemini CLI의 MCP 서버 설정, 키 바인딩, 허용된 명령어 등 환경 설정이 Antigravity CLI로 자동으로 연동됩니다. agy plugin import gemini

단계 4: MCP 설정 조정 가져온 후 MCP 서버 설정 파일인 mcp_config.json을 확인합니다. 설정 내의 연결 대상 지정에서 기존 url 필드가 serverUrl로 변경되었습니다. 연결 오류가 발생하면 수동으로 설정을 업데이트하십시오.\n

단계 5: 프로젝트 Skills 디렉터리 마이그레이션 프로젝트 내에서 맞춤 정의한 Agent Skills를 사용 중인 경우, 기존 Skills 배치 디렉터리인 .gemini/skills/에서 새로운 경로인 .agents/skills/로 콘텐츠를 이동(복사 또는 이름 변경)해야 합니다.

mkdir -p .agents/skills && cp -r .gemini/skills/* .agents/skills/\n

단계 6: 작동 확인 마지막으로 agy doctor 명령을 실행하여 설정 및 연결 상태에 대한 진단 테스트를 수행합니다. 문제가 감지되지 않으면 마이그레이션이 완료됩니다.

지원 종료된 Gemini CLI 제거 단계

Antigravity CLI로의 마이그레이션이 완료되면 시스템에서 사용하지 않는 기존 Gemini CLI를 깔끔하게 제거(언인스톨)하는 것이 좋습니다.

1. 글로벌 패키지 제거

Gemini CLI는 일반적으로 npm 글로벌 패키지로 설치됩니다. 제거하려면 다음 명령을 실행합니다:

npm uninstall -g @google/gemini-cli

* macOS/Linux에서 권한 오류가 발생하는 경우 명령 앞에 sudo를 붙여 다시 실행하십시오.

2. 설정 파일 및 캐시 삭제

인증 정보 및 로컬 설정이 남아 있으므로 불필요한 디렉터리를 삭제합니다. macOS/Linux의 경우 ~/.config/gemini-cli 디렉터리를 삭제합니다.

rm -rf ~/.config/gemini-cli

Windows(PowerShell)의 경우 다음 명령으로 설정 파일과 캐시를 삭제합니다:

Remove-Item -Recurse -Force $env:USERPROFILE\.config\gemini-cliRemove-Item -Recurse -Force $env:LOCALAPPDATA\gemini-cli

3. 인증 정보 정리

OS 인증 저장소에 저장된 오래된 OAuth 토큰을 삭제합니다. Windows의 경우 '자격 증명 관리자'를 열고 'Windows 자격 증명' 아래에서 google-gemini-cli 또는 gemini-cli 관련 항목을 삭제합니다. macOS의 경우 '키체인 접근' 앱을 사용하여 유사한 관련 항목을 찾아 삭제합니다.

클로즈드 소스 전환이 우려되는 경우의 대안 도구

Antigravity CLI의 클로즈드 소스 전환에 대해 우려하는 개발자를 위해 몇 가지 훌륭한 오픈 소스 대안을 사용할 수 있습니다:

1. Claude Code:

Anthropic에서 제공하는 최신 터미널 에이전트 도구로, 고급 코드 이해 및 도구 실행 기능을 제공합니다.

2. Aider:

다양한 LLM(GPT-4o, Claude 3.5 Sonnet 등)과 통합할 수 있고 완전한 오픈 소스로서 높은 커스텀 가능성을 자랑하는 명령줄 채팅 도구입니다.

3. GitHub Copilot CLI:

GitHub 공식 CLI 도구로, GitHub 생태계와 긴밀하게 연동되어 작동합니다.

4. Ollama + open-webui:

완전 로컬 환경에서 LLM을 실행하여 개인정보를 100% 직접 관리할 수 있는 솔루션입니다.

결론

Go 기반의 agy는 빠른 시작 속도를 제공하며 비동기 병렬 처리와 같이 개발 효율성을 높이는 기능으로 가득 차 있습니다. 반대로 Gemini가 지금까지 서브 에이전트조차 지원하지 않았다는 점은 놀랍지만, 이번 기회에 agy로 전환하는 것이 좋은 선택이 될 것입니다.

【출처】