오늘 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를 깔끔하게 제거(언인스톨)하는 방법까지 자세히 설명합니다.

\n

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

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에 집중될 예정이므로 장기적으로는 전환을 고려하는 것이 좋습니다.

\n

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

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

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

\n

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

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

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

단계 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/로 콘텐츠를 이동(복사 또는 이름 변경)해야 합니다.

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

\n

지원 종료된 Gemini CLI 제거 단계#

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

1. 글로벌 패키지 제거

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

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

2. 설정 파일 및 캐시 삭제

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

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

3. 인증 정보 정리

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

\n

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

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% 직접 관리할 수 있는 솔루션입니다.

\n

결론#

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

\n

\n

【출처】

\n

1. Gemini CLI 서비스 종료 가이드 — Antigravity CLI 마이그레이션 단계 및 6월 18일 데드라인 (Qiita)
2. Google Developers Blog: Transitioning Gemini CLI to Antigravity CLI
3. Gemini CLI에서 Antigravity CLI로 마이그레이션 (Antigravity Docs)

\n