개인 계정으로 Gemini CLI를 사용했다면 지금 Antigravity CLI로 이전하는 편이 맞습니다. 기업 라이선스나 유료 API 인증을 사용한다면 기존 환경을 바로 지우지 말고 일주일 동안 두 도구를 병행 검증하십시오.
이 글은 개인 계정 중단으로 터미널 작업이 끊긴 개발자, Skills·MCP·Hooks를 직접 관리하는 고급 사용자, 원격 맥 개발 환경과 팀 권한을 운영하는 책임자를 위한 이전 실행 가이드입니다.
마지막 업데이트: 2026년 8월 15일. 계정 범위와 이전 방식은 Gemini CLI 공식 공지, Antigravity CLI 이전 문서, 권한·샌드박스 문서를 기준으로 확인했습니다.
중단 당일: 계정 유형부터 분리하십시오
Google은 2026년 6월 18일부터 무료 개인 계정과 Google AI Pro, Google AI Ultra 계정의 Gemini CLI 요청 처리를 중단한다고 공식 안내했습니다. 반면 Gemini Code Assist Standard·Enterprise 라이선스, Google Cloud 인증, 유료 API 키 사용자는 같은 중단 대상이 아닙니다. Gemini CLI 전체가 모든 사용자에게 종료된 것은 아닙니다. 개인 계정 중단 공식 공지
먼저 다음처럼 분류하십시오.
- 무료 또는 개인 구독 계정: Antigravity CLI로 이전합니다. 기존 OAuth 인증이 복구되기를 기다리는 전략은 작업 연속성을 보장하지 못합니다.
- 기업 라이선스 사용자: Gemini CLI를 잠시 유지할 수 있습니다. 다만 신규 도구의 권한 모델과 조직 정책을 함께 시험해야 합니다.
- 유료 API 사용자: API 기반 자동화를 유지하면서 Antigravity CLI를 별도 작업 공간에서 검증할 수 있습니다.
- 계정 유형이 불명확한 팀: 인증 방식, 결제 주체, 호출 경로를 먼저 기록합니다. 계정 이름만 보고 판단하면 안 됩니다.
Antigravity CLI는 Gemini CLI의 터미널 경험을 하나의 에이전트 플랫폼으로 통합하려는 경로로 안내되고 있습니다. 공식 문서도 대부분의 핵심 작업 흐름을 지원하지만 완전한 기능 동등성을 보장하지는 않는다고 설명합니다. Antigravity CLI 이전 안내
이전 전: 설정과 자동화 자산을 복제하십시오
개인 계정 사용자라면 설치보다 백업이 먼저입니다. 기존 폴더를 덮어쓰지 말고 별도 복사본을 만드십시오.
다음 항목을 목록으로 만들어야 합니다.
- 전역 및 프로젝트 Skills
- MCP 서버 정의와 환경 변수
- Agents와 Subagents 설정
- Hooks 및 사용자 정의 명령
GEMINI.md,AGENTS.md같은 프로젝트 문맥 파일- 무인 실행과 CI 스크립트
- 브라우저 로그인, API 키, 시스템 키체인 사용 여부
- 파일 수정과 셸 명령에 적용한 승인 정책
특히 자동화 스크립트는 별도 위험 항목으로 표시하십시오. 첫 실행의 가져오기 기능은 대화형 설정을 옮기는 데 도움을 주지만, 무인 실행의 종료 코드나 출력 형식까지 보장하지 않습니다.
구성 파일은 다음처럼 보존하는 방식이 안전합니다.
mkdir -p ~/gemini-cli-backup-2026
cp -R ~/.gemini ~/gemini-cli-backup-2026/
이 명령은 예시일 뿐입니다. 실제 경로와 민감 정보 포함 여부를 확인한 뒤 실행하십시오. API 키가 들어 있는 파일은 일반 압축 파일이나 팀 공유 폴더에 그대로 올리지 마십시오.
첫 실행: 자동 가져오기를 검증하십시오
Antigravity CLI를 설치한 뒤 첫 실행에서 기존 Gemini CLI 구성과 확장 기능을 감지하면 가져오기 선택지가 표시됩니다. 확장 기능을 플러그인으로 변환하는 명령도 제공됩니다.
agy plugin import gemini
공식 이전 문서에 따르면 Skills, MCP 서버, Hooks, Subagents 같은 작업 흐름 요소는 지원 대상입니다. 그러나 사용자 정의 테마와 일부 실험 기능은 일대일 변환되지 않을 수 있습니다. 프로젝트 Skills 경로도 기존 .gemini/skills/에서 .agents/skills/로 옮겨야 할 수 있습니다. 공식 이전 문서의 경로·변환 설명
첫 한 시간에는 실제 주 저장소가 아니라 최소 테스트 저장소를 사용하십시오.
- 새 테스트 저장소에서 Antigravity CLI를 실행합니다.
- 프로젝트 문맥 파일이 읽히는지 확인합니다.
- 가져온 Skills와 플러그인을 하나씩 호출합니다.
- MCP 서버의 목록 조회와 읽기 작업을 시험합니다.
- 작은 파일을 수정하고
git diff로 변경 범위를 확인합니다. - 기존 Gemini CLI 설정을 삭제하지 않은 상태에서 실패 로그를 저장합니다.
MCP는 특히 주의해야 합니다. Gemini CLI가 기본 설정 파일 안에 서버를 넣었다면 Antigravity CLI에서는 별도 mcp_config.json으로 분리될 수 있습니다. 원격 서버 주소도 url 또는 httpUrl 대신 serverUrl을 요구할 수 있습니다. 자동 변환이 끝났어도 실제 호출까지 확인해야 합니다.
첫날: 같은 작업으로 두 흐름을 비교하십시오
기능 목록만 읽고 이전 여부를 정하면 안 됩니다. 같은 저장소와 같은 작업 지시를 사용해 구형 흐름과 새 흐름을 비교하십시오.
시험 작업은 다음 순서가 적합합니다.
- 여러 파일의 구조를 설명하게 합니다.
- 작은 기능을 여러 파일에 나누어 수정하게 합니다.
- 테스트와 린트를 실행하게 합니다.
- 변경 차이를 요약하게 합니다.
- 실패한 명령을 스스로 복구하게 합니다.
- 세션을 종료한 뒤 작업을 다시 이어 갑니다.
- 무인 실행 스크립트에서 출력과 종료 상태를 확인합니다.
비교할 항목은 속도 하나가 아닙니다. 다음을 기록하십시오.
- 사람이 승인해야 했던 횟수
- 잘못된 파일을 수정한 횟수
- 실패 뒤 복구에 필요한 단계
- 최종 테스트 통과 여부
- MCP와 Hooks의 실행 결과
- 세션 복구 뒤 문맥 보존 여부
공식 문서는 Antigravity CLI가 다단계 추론, 여러 파일 수정, 도구 호출, 지속적인 기록을 지원한다고 설명합니다. 하지만 이는 기능 범위에 대한 설명이지 당신의 저장소에서 성공률이나 처리 속도를 보장하는 실측 결과가 아닙니다. 그런 수치는 직접 같은 환경에서 측정해야 합니다. Antigravity CLI 기능 개요
중간 판단표: 누구에게 어떤 이전 전략이 맞는가
| 사용자 유형 | 지금 할 일 | 유지 조건 | 전환 조건 | 주요 위험 |
|---|---|---|---|---|
| 개인 계정 개발자 | Antigravity CLI 이전 | 기존 설정 백업본 보관 | 핵심 저장소 테스트 통과 | 인증 중단, 자동화 누락 |
| 기업 라이선스 팀 | Gemini CLI와 병행 | 기존 정책과 업무가 안정적으로 작동 | 권한·감사·플러그인 검증 완료 | 조직 권한 불일치 |
| 유료 API 사용자 | API 흐름 유지 후 별도 시험 | CI 호출과 비용 추적 가능 | 새 도구의 무인 실행 검증 | 호출 방식과 비용 변화 |
| 원격 맥 개발자 | SSH와 키체인부터 확인 | 브라우저 인증과 세션 복구 성공 | Xcode 작업까지 폐쇄 루프 확인 | 키체인 잠금, 연결 단절 |
| 장기 자동화 운영자 | 구형 스크립트 보존 | 출력·종료 코드 동일 | 롤백 조건과 승인 정책 확정 | 무인 명령의 권한 확대 |
Antigravity CLI의 개인용 요금제와 사용량 한도는 변경될 수 있으므로, 구매 전에는 반드시 공식 요금 안내를 확인하십시오. 공개된 현재 페이지에는 무료 개인 계층과 별도 Google AI 요금제가 구분되어 있지만, 실제 사용 가능량은 계정과 시점에 따라 달라질 수 있습니다.
첫 주: 맥, SSH와 권한 경계를 확인하십시오
macOS에서는 로그인 자체보다 키체인과 권한이 더 자주 문제를 일으킬 수 있습니다. Antigravity CLI는 운영 체제의 키체인에 인증 토큰을 저장하며, 헤드리스 SSH 세션에서는 키체인이 잠겨 있거나 접근 권한이 없어 인증이 실패할 수 있습니다. 맥 키체인·SSH 문제 해결 문서
다음 순서로 확인하십시오.
- 로컬 맥에서 브라우저 인증을 완료합니다.
- 터미널을 닫고 다시 열어 세션이 유지되는지 봅니다.
- SSH로 접속한 뒤 인증 상태를 확인합니다.
- 키체인 접근 승인과 잠금 상태를 확인합니다.
- 네트워크가 끊긴 뒤 세션 복구 명령을 시험합니다.
- Xcode 빌드, 서명, 테스트를 실제 프로젝트에서 실행합니다.
원격 맥에서 작업한다면 단순히 CLI가 실행되는 것만으로 충분하지 않습니다. 에이전트가 코드를 수정한 뒤 Xcode 빌드와 테스트까지 끝내야 납품 가능한 흐름입니다. 원격 환경이 없다면 원격 맥 개발 환경 준비 안내를 참고해 테스트 기간에 필요한 macOS 환경을 먼저 마련하십시오.
권한은 편의보다 범위를 우선하십시오. Antigravity CLI는 파일 읽기, 파일 쓰기, 명령 실행, URL 접근, MCP 호출을 서로 다른 권한 대상으로 다룰 수 있습니다. command(*), read_file(*), mcp(*)처럼 전체 범위를 허용하면 확인 창은 줄지만 사고 범위가 커집니다. 허용·거부·확인 정책은 거부가 가장 우선하며, 프로젝트 폴더 안에서도 실제 필요한 명령만 허용하는 편이 안전합니다. 세분화 권한 공식 문서
샌드박스도 별도로 시험하십시오. macOS에서는 네이티브 샌드박스 설정으로 파일과 네트워크 접근 범위를 제한할 수 있지만, 빌드 도구나 서명 과정이 제한될 수 있습니다. 샌드박스를 끈 상태에서만 통과하는 작업이 있다면 전역 권한을 넓히기 전에 필요한 경로와 명령을 좁혀야 합니다. 터미널 샌드박스 문서
일주일 뒤: 전면 이전 또는 이중 운영을 결정하십시오
개인 계정 개발자는 핵심 작업, MCP 호출, 파일 수정, 테스트까지 통과했다면 전면 이전하십시오. 구형 설정은 즉시 삭제하지 말고 일정 기간 읽기 전용 백업으로 보관하십시오.
기업과 유료 API 사용자는 다음 조건을 모두 확인한 뒤 전환하십시오.
- 주요 저장소의 코드 수정과 테스트가 통과했는가
- Hooks와 무인 작업의 출력·종료 상태가 예상과 같은가
- MCP 서버가 필요한 범위에서만 호출되는가
- SSH와 키체인 인증이 재현 가능한가
- Xcode 빌드와 서명 과정이 맥 환경에서 끝나는가
- 팀 권한과 감사 로그가 기존 정책에 맞는가
- 장애 때 Gemini CLI 또는 API 흐름으로 되돌릴 수 있는가
하나라도 확인되지 않았다면 이중 운영을 유지하십시오. 특히 자동화 파이프라인은 대화형 작업보다 늦게 바꾸는 것이 안전합니다.
현재 장비가 오래되어 macOS, SSH, Xcode 검증을 지속하기 어렵다면 바로 장비를 구매하기보다 테스트 기간에 맞는 클라우드 맥 또는 맥 미니 렌탈 환경을 검토하는 편이 합리적입니다. 예를 들어 서울 지역 맥 미니 렌탈 환경은 이전 검증용 원격 작업 공간을 별도로 구성할 때 비교 대상이 될 수 있습니다.
기존 방식만 계속 고수하면 개인 계정 인증 중단, 설정 변환 누락, 원격 키체인 장애라는 세 가지 비용을 떠안게 됩니다. 반대로 Antigravity CLI로 성급하게 전환하면 MCP 경로 변경, 권한 정책 재검토, 무인 스크립트 실패를 놓칠 수 있습니다. 따라서 개인 사용자는 지금 이전하되, 팀과 자동화 운영자는 병행 검증을 거쳐야 합니다. 장비가 부족해 일주일 검증 환경을 유지하기 어렵다면 MACCOME의 맥 환경을 테스트 기간에 맞춰 활용한 뒤 장기 구매 여부를 판단하는 순서가 더 안전합니다.