Gemini CLI 전환 가이드: Antigravity CLI로 터미널 작업 옮기는 법

TL;DR

Gemini CLI를 개인 계정으로 쓰던 사람은 이제 Antigravity CLI 전환을 먼저 확인해야 합니다. Google Developers Blog에 따르면 2026년 6월 18일부터 Google AI Pro, Google AI Ultra, 무료 개인 사용자의 Gemini CLI와 Gemini Code Assist IDE 확장 요청 처리가 중단됐습니다. 기존 터미널 작업을 계속 이어가려면 Antigravity CLI로 옮기되, 기업 고객과 유료 API 키 기반 사용자는 적용 범위가 다르므로 본인 계정 유형부터 확인해야 합니다.

핵심 3줄 요약

• 핵심 1
  개인 사용자에게는 Gemini CLI가 더 이상 예전처럼 계속 쓰는 도구가 아니라 Antigravity CLI로 옮겨야 하는 전환 대상입니다.
• 핵심 2
  Antigravity CLI는 Gemini CLI의 모든 기능을 1:1로 복제한 도구가 아니라, 여러 에이전트와 비동기 작업 흐름을 강조하는 새 CLI입니다.
• 핵심 3
  바로 설치부터 하기보다 현재 쓰는 명령, 인증 방식, GEMINI.md 지침, 자동화 스크립트, 민감 파일 접근 권한을 먼저 점검해야 합니다.

이 글에서 다룰 내용

Gemini CLI 전환이 왜 중요한가

Gemini CLI는 터미널 안에서 Gemini 모델을 불러와 코드베이스를 이해하고, 파일을 읽고, 셸 명령과 MCP 서버를 연결하고, 검색 기반 답변까지 받을 수 있는 오픈소스 AI 에이전트 도구입니다. 개발자뿐 아니라 운영자, 마케터, 자동화 담당자도 반복적인 파일 정리, 문서 초안, 코드 수정, 로그 확인에 활용할 수 있습니다.

하지만 2026년 5월 19일 Google Developers Blog는 Gemini CLI를 Antigravity CLI로 전환한다고 공지했습니다. 같은 공지에서 Google은 2026년 6월 18일부터 Google AI Pro, Google AI Ultra, 무료 개인 사용자의 Gemini CLI와 Gemini Code Assist IDE 확장 요청 처리가 중단된다고 설명했습니다. Gemini Code Assist for GitHub에도 같은 변화가 적용됩니다.

한 줄 정리: 개인 계정으로 Gemini CLI를 쓰던 사람에게 이 변화는 단순 이름 변경이 아니라 작업 도구를 바꿔야 하는 일정입니다.

누가 먼저 확인해야 하나

먼저 확인해야 하는 사람은 다음과 같습니다.

• 개인 Google 계정으로 Gemini CLI를 로그인해 쓰던 사용자
• Google AI Pro 또는 Google AI Ultra 계정으로 Gemini CLI를 쓰던 사용자
• Gemini Code Assist IDE 확장을 개인용으로 쓰던 사용자
• 터미널에서 AI에게 파일 수정, 요약, 코드 리뷰, 문서 생성을 맡기던 사용자
• npm, npx, Homebrew 등으로 Gemini CLI를 설치해 팀 내부 가이드에 넣어둔 사람

반대로 Google은 Gemini Code Assist Standard 또는 Enterprise 고객의 IDE 경험은 변경되지 않는다고 설명했습니다. 또 Gemini CLI는 유료 Gemini API 키와 Gemini Enterprise Agent Platform API 키로 계속 접근할 수 있다고 밝혔습니다. 따라서 회사 계정, 엔터프라이즈 라이선스, API 키 기반 자동화를 쓰는 팀은 무조건 같은 방식으로 전환한다고 단정하면 안 됩니다.

핵심 인사이트: 전환 판단의 첫 질문은 "Gemini CLI를 쓰는가?"가 아니라 "어떤 계정과 어떤 인증 방식으로 쓰는가?"입니다.

언제 Antigravity CLI로 옮기면 좋은가

다음 상황이라면 바로 전환 점검을 시작하는 편이 좋습니다.

• 터미널에서 AI에게 코드 수정이나 파일 정리를 자주 맡깁니다.
• Gemini CLI 명령을 사내 문서, 교육 자료, 자동화 스크립트에 넣어두었습니다.
• 개인 Google 계정으로 로그인해 무료 또는 Google AI 유료 플랜 기반으로 사용했습니다.
• 매번 같은 폴더에서 같은 지침 파일을 읽게 하는 반복 작업이 있습니다.
• Gemini Code Assist IDE 확장과 CLI를 함께 사용합니다.

다음 상황에서는 먼저 범위를 확인한 뒤 움직이면 됩니다.

• 회사가 Gemini Code Assist Standard 또는 Enterprise를 계약해 쓰고 있습니다.
• Gemini API 키나 Vertex AI 같은 별도 인증 경로로 CLI를 운용합니다.
• Gemini CLI를 실험용으로만 설치했고 실제 업무 자동화에는 연결하지 않았습니다.

실전 팁: 혼자 쓰는 도구라면 오늘 바로 전환 테스트를 해도 되지만, 팀 문서나 자동화에 들어간 도구라면 기존 명령 목록을 먼저 뽑아 영향 범위를 정리해야 합니다.

Antigravity CLI로 옮기는 순서

1단계: 현재 사용 방식을 적는다

최근 한 달 동안 Gemini CLI로 한 일을 먼저 적습니다. 예를 들면 코드 설명, README 작성, CSV 정리, 릴리스 노트 요약, 오류 로그 분석, 문서 초안 작성, 셸 명령 실행 보조처럼 나눌 수 있습니다.

2단계: 인증 방식을 확인한다

개인 Google 계정 로그인인지, Gemini API 키인지, Vertex AI인지, 회사 계정인지 확인합니다. Google의 전환 공지는 개인 사용자와 기업 고객의 적용 범위를 다르게 설명하므로, 이 단계가 가장 중요합니다.

3단계: 공식 설치 문서를 기준으로 새 CLI를 확인한다

Gemini CLI 문서는 Node.js 20 이상, PowerShell 또는 Bash/Zsh 같은 셸, 인터넷 연결 등 실행 조건을 안내합니다. Antigravity CLI로 옮길 때도 비공식 블로그의 설치 명령을 먼저 복사하지 말고, 공식 문서나 공식 저장소에서 안내하는 설치 경로를 확인해야 합니다.

4단계: 기존 지침 파일을 정리한다

Gemini CLI를 프로젝트별로 썼다면 GEMINI.md 같은 지침 파일을 함께 관리했을 가능성이 높습니다. 이 파일에 오래된 명령, 더 이상 맞지 않는 모델명, 과도한 파일 접근 지시가 들어 있지 않은지 확인합니다.

5단계: 자동화 스크립트를 분리해서 점검한다

Gemini CLI를 비대화형 모드로 호출하던 스크립트가 있다면, 바로 새 도구로 바꾸지 말고 입력 파일, 출력 형식, 실패 시 동작, 로그 저장 위치를 따로 확인합니다. 특히 JSON 출력이나 스트리밍 출력에 의존하던 자동화는 결과 형식이 달라질 수 있습니다.

6단계: 작은 폴더에서 먼저 테스트한다

처음부터 실제 운영 저장소나 중요한 고객 자료 폴더에서 테스트하지 말고, 샘플 파일 몇 개가 있는 폴더에서 요약, 수정 제안, 파일 생성, 명령 실행 보조를 확인합니다.

7단계: 팀 문서와 즐겨 쓰는 프롬프트를 업데이트한다

전환이 끝나면 팀 온보딩 문서, 개인 치트시트, 자동화 README, 터미널 별칭을 함께 고칩니다. 도구 이름만 바꾸는 것이 아니라 권한, 인증, 실패 대응 방식까지 같이 남겨야 합니다.

바로 쓰는 점검 프롬프트

아래 문장은 Antigravity CLI로 옮기기 전 현재 작업을 정리할 때 쓸 수 있습니다.

프롬프트 1: 현재 사용 목록 정리

"이 폴더에서 내가 Gemini CLI로 반복해온 작업을 추정해줘. README, 스크립트, 설정 파일, 문서 폴더를 보고 코드 수정, 문서 작성, 데이터 정리, 배포 보조, 로그 분석으로 나눠서 전환 체크리스트를 만들어줘."

프롬프트 2: 지침 파일 점검

"이 프로젝트의 AI 작업 지침 파일을 읽고 오래된 도구명, 위험한 파일 접근 지시, 모호한 테스트 명령, 비밀 정보 노출 위험을 찾아줘. 수정 제안은 항목별로 이유와 함께 정리해줘."

프롬프트 3: 자동화 스크립트 영향 분석

"이 저장소에서 Gemini CLI나 Gemini Code Assist를 호출하는 스크립트, 문서, CI 설정을 찾아줘. 각 항목에 대해 전환 필요 여부, 실패 위험, 먼저 테스트할 명령을 표 대신 목록으로 정리해줘."

프롬프트 4: 작은 테스트 작업 만들기

"이 프로젝트에서 안전하게 실행할 수 있는 작은 AI 작업 3개를 골라줘. 실제 파일 삭제나 배포는 제외하고, 요약, 문서 초안, 코드 설명 중심으로 Antigravity CLI 전환 테스트 순서를 만들어줘."

실전 팁

• 도구 전환 전에는 "설치"보다 "현재 사용 목록"이 먼저입니다.
• 기존 Gemini CLI 명령을 팀 문서에 넣어두었다면 문서 검색부터 합니다.
• 개인 계정과 회사 계정을 같은 전환 규칙으로 묶지 않습니다.
• 파일 수정 권한이 필요한 작업은 작은 샘플 폴더에서 먼저 확인합니다.
• API 키, 토큰, 고객 파일 경로는 프롬프트에 직접 붙여 넣지 않습니다.
• 새 CLI의 출력 형식이 기존 자동화와 같은지 따로 확인합니다.

한 줄 정리: CLI 전환은 도구 설치 문제가 아니라 인증, 권한, 자동화, 팀 문서가 함께 움직이는 작업입니다.

주의할 점

첫째, Antigravity CLI가 Gemini CLI와 완전히 같은 도구라고 가정하면 안 됩니다. Google은 중요한 Gemini CLI 기능을 유지한다고 설명했지만, 1:1 기능 동등성은 아니라고 밝혔습니다. Agent Skills, Hooks, Subagents, Extensions 성격의 기능은 이어지지만 실제 명령, 흐름, 출력은 다를 수 있습니다.

둘째, 설치 명령은 공식 문서 기준으로 확인해야 합니다. CLI 도구는 터미널 권한을 다루기 때문에 출처가 불분명한 설치 명령을 그대로 붙여 넣으면 위험합니다.

셋째, 셸 명령 실행과 파일 수정은 항상 검토해야 합니다. AI가 제안한 명령이 삭제, 덮어쓰기, 외부 전송, 권한 변경을 포함한다면 실행 전에 멈춰서 확인합니다.

넷째, 개인 사용자의 요청 처리 중단과 기업 고객의 사용 가능 범위를 혼동하면 안 됩니다. 계정 유형과 계약 상태에 따라 해야 할 일이 달라집니다.

주의: 전환 공지의 핵심 날짜는 2026년 6월 18일입니다. 2026년 6월 25일 기준으로 개인 사용자 대상 변경은 이미 적용된 상태로 봐야 합니다.

자주 묻는 질문

Q1. Gemini CLI는 완전히 사라졌나요?

아닙니다. Google은 개인 사용자 대상 요청 처리 중단과 Antigravity CLI 전환을 공지했지만, 유료 Gemini API 키와 Gemini Enterprise Agent Platform API 키 경로는 계속 접근 가능하다고 설명했습니다. 기업 고객의 IDE 경험도 변경되지 않는다고 안내했습니다.

Q2. Antigravity CLI로 바꾸면 기존 Gemini CLI 프롬프트를 그대로 써도 되나요?

일부는 그대로 쓸 수 있지만 전부를 그대로 믿으면 안 됩니다. 특히 도구명, 파일 접근, 셸 명령, 출력 형식, 자동화 스크립트에 연결된 프롬프트는 다시 점검해야 합니다.

Q3. 마케터나 기획자도 이 전환을 신경 써야 하나요?

터미널을 직접 쓰지 않는다면 우선순위는 낮습니다. 하지만 팀 안에서 AI가 문서 생성, 데이터 정리, 리포트 자동화, 랜딩페이지 수정에 CLI로 연결돼 있다면 영향이 있을 수 있습니다.

Q4. 지금 바로 해야 할 최소 작업은 무엇인가요?

내가 Gemini CLI를 어떤 인증 방식으로 쓰는지 확인하고, 최근에 실행한 반복 작업과 자동화 스크립트 목록을 정리하는 것입니다. 그다음 공식 문서 기준으로 Antigravity CLI 전환 테스트를 작은 폴더에서 진행하면 됩니다.

Q5. Gemini Code Assist IDE 확장도 관련이 있나요?

관련이 있습니다. Google Developers Blog는 Gemini Code Assist IDE extensions와 Gemini Code Assist for GitHub에도 개인 사용자 대상 변경이 적용된다고 설명했습니다. 다만 Standard와 Enterprise 고객은 별도로 다뤄집니다.

출처

마무리

Gemini CLI 전환은 개발자만의 이슈처럼 보이지만, 실제로는 AI로 반복 작업을 줄이던 모든 팀의 운영 이슈입니다. 개인 계정으로 Gemini CLI를 쓰던 감자나라ai님이라면 먼저 계정 유형과 인증 방식을 확인하고, 기존 명령과 자동화 문서를 정리한 뒤 Antigravity CLI로 작은 테스트부터 옮기는 순서가 안전합니다.

핵심은 하나입니다. 새 도구를 급히 설치하기보다, 지금 내 업무에서 CLI가 어디에 연결돼 있는지 먼저 파악해야 합니다.