Gemini CLI 종료 후 Antigravity CLI 설치·설정 옮기기

Antigravity CLI를 winget으로 설치하고 나서, Gemini CLI용 지시 파일 GEMINI.md가 그대로 읽히는지 확인해 봤습니다. 빈 폴더에 “코드워드를 물으면 MANGO-17로 답하라”는 한 줄을 두고 물으니 MANGO-17이 바로 나오더라고요. AGENTS.md로 바꿔 둬도 마찬가지였고요.

그런데 두 파일을 한 폴더에 같이 두니 아무 답도 나오지 않았습니다. 그 상태에서도 종료 코드는 0이었어요. 옮기는 과정 자체는 생각보다 간단한데, 스크립트에서 agy -p를 쓸 생각이라면 이런 데서 걸립니다.

옮겨야 하는 사람부터 정리할게요. 개인 무료 계정이나 Google AI Pro·Ultra로 Gemini CLI를 쓰고 있었다면 2026년 6월 18일부터 요청이 처리되지 않으니 Antigravity CLI(agy)로 옮깁니다.

Windows에서는 PowerShell에 irm https://antigravity.google/cli/install.ps1 | iex 한 줄(또는 winget install --id Google.AntigravityCLI -e)로 설치하고, 프로젝트의 GEMINI.md·AGENTS.md는 그대로 두면 됩니다. 새 위치로 옮길 건 스킬 폴더와 MCP 서버 설정뿐이에요.

2026년 9월 29일 Windows 11 · Windows PowerShell 5.1 테스트 환경에서 Antigravity CLI 1.2.12를 설치해 직접 확인했고, 서비스 종료 공지와 공식 문서도 같은 날 다시 봤습니다. Antigravity CLI는 Google이 Gemini CLI 대신 안내하는 터미널용 코딩 에이전트이고, 명령 이름은 agy입니다.

누가 옮겨야 하나

Gemini CLI 메인테이너는 2026년 5월 19일 공식 저장소 토론 게시판에 이렇게 공지했습니다. “On June 18, 2026, Gemini CLI will stop serving requests for Google AI Pro and Ultra, as well as those using it free of charge.” 같은 공지가 조직 라이선스와 유료 API 키는 계속 지원한다고 밝히고, 나머지 사용자에게는 Antigravity CLI를 안내해요.

사용 방식	2026-06-18 이후 Gemini CLI
개인 Google 계정 무료	멈춤 → Antigravity CLI
Google AI Pro·Ultra 구독	멈춤 → Antigravity CLI
조직 Code Assist Standard·Enterprise, Google Cloud	계속 지원
유료 Gemini API 키	계속 지원

Gemini CLI를 업데이트하거나 다시 설치하면 되지 않을까 싶지만, 그렇게는 안 풀립니다. 막힌 건 프로그램이 아니라 서버 쪽 요청 처리라서, 위 두 계정은 어떤 버전을 깔아도 마찬가지예요.

유료 Gemini API 키가 있다면 Gemini CLI를 계속 써도 됩니다. 애매한 건 무료 Gemini API 키인데, 어느 쪽인지는 공지에 없습니다. 공지가 “무료로 쓰는 경우”를 멈춘다고 했으니, 저라면 무료 키로 쓰던 경우에도 옮길 준비를 해 두겠습니다.

Windows에 설치하기

설치부터 첫 질문까지 세 단계면 끝납니다.

1. 설치 명령 실행

PowerShell에서 공식 설치 스크립트를 실행합니다.

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

다른 셸이라면 이렇게 설치합니다.

• 명령 프롬프트(CMD): curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
• macOS·Linux: curl -fsSL https://antigravity.google/cli/install.sh | bash
• winget: winget install --id Google.AntigravityCLI -e (테스트 환경에서는 이 방법을 썼습니다)

winget으로 설치하면 마지막에 이 두 줄이 나옵니다(한국어 Windows 기준).

경로 환경 변수 수정됨; 셸을 다시 시작하여 새 값을 사용합니다.
명령줄 별칭이 추가되었습니다. "agy"

winget에는 편집기 앱 Google.AntigravityIDE도 따로 있으니 헷갈리지 마세요. 터미널에서 쓸 건 Google.AntigravityCLI입니다.

2. 새 PowerShell 창에서 버전 확인

설치 위치는 %LOCALAPPDATA%\agy\bin이고 PATH가 바뀌었으니, 원래 창이 아니라 새 창에서 확인해야 합니다.

agy --version

1.2.12

3. 로그인하고 짧은 질문으로 확인

agy를 처음 실행하면 운영체제의 자격 증명 저장소에 저장된 로그인이 있는지 보고, 없으면 기본 브라우저를 열어 로그인시킵니다. SSH로 접속한 원격 환경에서는 인증 URL이 출력되니 브라우저에서 받은 코드를 터미널에 붙여 넣으면 돼요. 첫 대화형 실행은 색 구성, 화면 표시 방식(Alt-Screen 또는 Inline), 작업 폴더 신뢰 여부를 차례로 묻습니다.

로그인이 됐는지는 짧은 질문 하나로 봅니다.

agy -p "Reply with exactly the word: ok" --print-timeout 90s

ok

Google 계정 대신 API 키로 쓰려면 ~/.gemini/antigravity-cli/settings.json에 "modelProvider": "gemini"를 넣고 GEMINI_API_KEY 환경 변수를 지정합니다. 직접 설치해 보니 이 파일은 처음에 없어서 손으로 만들어야 했어요. 로그아웃은 대화 화면에서 /logout입니다.

스킬과 MCP 설정 옮기기

Gemini CLI와 Antigravity CLI는 같은 ~/.gemini 폴더를 쓰지만, 스킬과 MCP 서버를 두는 자리가 다릅니다.

항목	Gemini CLI	Antigravity CLI
전역 스킬	~/.gemini/skills/	~/.gemini/antigravity-cli/skills/
작업 폴더 스킬	.gemini/skills/	.agents/skills/
전역 MCP 서버	~/.gemini/settings.json	~/.gemini/config/mcp_config.json
작업 폴더 MCP 서버	.gemini/settings.json	.agents/mcp_config.json

처음 agy를 실행하면 기존 Gemini CLI 설정을 감지해 확장과 전역 설정 중 무엇을 변환할지 고르게 합니다. 그래서 Gemini CLI를 먼저 지울 필요는 없어요. 오히려 변환이 끝나고 agy가 제대로 도는 걸 확인한 뒤에 지워야 설정을 잃지 않습니다.

자동으로 넘어가지 않는 건 직접 옮깁니다.

1. 작업 폴더의 스킬 폴더를 .agents/skills/로 옮깁니다.
2. 원격 MCP 서버의 주소 키를 url·httpUrl에서 serverUrl로 바꿉니다.
3. 확장은 agy plugin import gemini로 플러그인으로 변환합니다.

agy plugin 도움말을 보면 가져오기 대상에 gemini와 함께 claude도 있습니다. Claude Code에서 쓰던 플러그인도 가져올 수 있다는 뜻으로 보여요. MCP 서버를 새로 붙이고 연결을 확인하는 법은 Antigravity CLI MCP 서버 연결과 설정 파일에 있습니다.

GEMINI.md와 AGENTS.md는 그대로

지시 파일은 옮기거나 이름을 바꿀 필요가 없습니다. 글 처음에 말한 확인 방법을 그대로 따라 하면 옮긴 뒤에도 금방 확인할 수 있어요. 빈 폴더에 “코드워드를 물으면 정해진 단어로 답하라”는 한 줄짜리 파일을 두고 물어보면 됩니다.

Set-Content -Encoding utf8 GEMINI.md "When asked for the project codeword, answer exactly: MANGO-17"
agy -p "What is the project codeword? Answer with the codeword only." --print-timeout 90s

MANGO-17

GEMINI.md를 지우고 같은 내용의 AGENTS.md(코드워드 KIWI-42)를 두었을 때도 KIWI-42로 답했습니다. 다만 두 파일을 한 폴더에 함께 두면 답이 나오지 않았는데, 그 이야기는 바로 다음 절에 있어요.

10월 13일 1.3.3에서 같은 세 경우를 다시 돌려도 결과가 똑같았습니다. GEMINI.md만 두면 MANGO-17, AGENTS.md만 두면 KIWI-42, 둘을 함께 두면 빈 답에 셸 명령 거부가 남았어요.

도구마다 어떤 지시 파일을 읽는지는 CLAUDE.md·AGENTS.md·GEMINI.md 비교에서 한 번에 볼 수 있습니다.

직접 해 보니 막힌 세 군데

모두 Antigravity CLI 1.2.12, Windows 11 · Windows PowerShell 5.1에서 공식 문서의 명령을 따라 했을 때 일이고, 첫째와 셋째는 10월 13일 1.3.3에서 다시 해 봐도 그대로였습니다.

답이 없는데 종료 코드는 0

GEMINI.md(MANGO-17)와 AGENTS.md(KIWI-42)를 한 폴더에 두고 agy -p로 코드워드를 물었더니, 표준 출력은 비고 표준 오류에만 이 메시지가 남았습니다. 세 번 물어 세 번 다 같았고, 종료 코드는 0이었어요.

jetski: no output produced — a tool required the "command" permission that headless mode cannot prompt for, so it was auto-denied. …

--output-format json으로 받아도 status는 SUCCESS였습니다. 대신 response가 비어 있고 "denied_actions":[{"action":"command",…}]가 붙었죠.

agy -p는 사람에게 허락을 물을 수 없어서 셸 명령을 자동으로 거부합니다. 두 파일을 직접 열어 보려고 셸 명령을 쓰려다 막힌 것으로 짐작해요. 이전 안내 문서에도 두 파일이 부딪힐 때의 우선순위는 없습니다.

주의: 스크립트에서 agy -p를 쓸 때 종료 코드만 보면 이런 실패를 성공으로 넘기게 됩니다.

스크립트에 넣는다면 이렇게 하세요.

• 종료 코드와 함께 response가 비었는지, denied_actions가 있는지 봅니다.
• 꼭 필요한 명령만 settings.json의 permissions.allow에 허용 규칙으로 엽니다. 모든 도구를 자동 승인하는 --dangerously-skip-permissions보다 안전합니다.
• 지시 파일은 하나로 합치거나 내용이 겹치지 않게 나눕니다.

한 단어 답에도 입력 토큰이 1만 개 넘게

요청	입력 토큰
“ok” 한 단어 받기	12,149
위의 거부로 끝난 요청	58,987

질문보다 도구가 기본으로 싣는 지시문과, 답을 찾으려 도구를 시도한 과정이 대부분을 차지한 것으로 짐작합니다. 사용량 한도가 있다면 짧은 질문을 여러 번 나눠 보내기보다 한 번에 묶고, 필요한 권한을 미리 열어 거부될 시도에 토큰을 쓰지 않게 하세요.

그 한도가 얼마인지는 알 수 없었습니다. 2026년 9월 29일에 본 설치·인증·이전 문서에는 요금제별 한도 수치가 없었어요.

계정 화면이나 공식 요금 안내에서 확인하세요. 요금제마다 쓸 수 있는 모델은 Antigravity CLI 모델 고르기에 정리했습니다.

agy plugin import --help가 도움말 대신 오류

Error: unknown import source or invalid path: --help가 나오고 종료 코드 1로 끝났습니다. import가 --help를 가져올 대상 이름으로 읽은 거예요. 하위 명령 도움말은 agy plugin help로 보면 됩니다. 1.3.3에서도 같은 오류가 그대로 났어요.

마치며

옮기는 작업 자체는 설치 한 줄, 스킬 폴더와 MCP 설정 몇 군데면 끝납니다. 지시 파일은 손댈 필요도 없었고요.

오히려 시간을 들여야 할 곳은 agy -p였습니다. 권한이 막혀 답이 비어도 종료 코드 0, status는 SUCCESS로 끝나니, 스크립트에서 쓸 거라면 response와 denied_actions를 꼭 함께 보세요.

설치가 끝났다면 새 PowerShell 창에서 agy --version과 위의 코드워드 확인을 돌려 설치와 지시 파일을 한 번에 확인해 보시길 권합니다. 스크립트에 넣을 계획이라면 이어서 Antigravity CLI 헤드리스 모드의 출력 형식과 실패 판정을 보세요.