에이전트 소식
Gemini CLI가 작동을 멈췄다: 지금 무엇을 써야 할까
2026년 6월 18일부터 Gemini CLI는 개인 Google 계정을 받지 않습니다. 영향을 받는 사람과 받지 않는 사람, 그리고 각 대안으로 옮기는 정확한 명령을 정리했습니다.
빠른 답변
2026년 6월 18일부터 Gemini CLI는 개인 Google 계정(무료, Google AI Pro, Ultra)을 더 이상 지원하지 않으며, "This client is no longer supported for Gemini Code Assist for individuals" 오류를 반환합니다. Gemini CLI 설정을 가져올 수 있는 Antigravity CLI(agy)로 옮기거나, 유료 Gemini API 키로 Gemini CLI를 계속 쓰세요. Code Assist Standard/Enterprise 사용자는 영향을 받지 않습니다.
올여름 gemini가 작동하지 않게 되었다면, 설치에 문제가 있는 것이 아닙니다. 2026년 6월 18일, Google은 개인 Google 계정, 즉 무료 등급, Google AI Pro, Google AI Ultra에 대한 Gemini CLI 제공을 중단했습니다. 다시 설치하거나 다른 개인 계정으로 로그인해도 되돌아오지 않습니다. 앞으로 갈 길은 세 가지입니다. 첫째, Google이 대체재로 내놓은 Antigravity CLI(agy)로 옮깁니다. 둘째, 유료 API 키로 Gemini CLI를 계속 씁니다. 셋째, 다른 코딩 에이전트로 바꿉니다.
Gemini CLI에 무슨 일이 있었나
Google은 2026년 5월 19일 Google Developers Blog의 게시물과 그에 대응하는 GitHub 토론(#28017)에서 이 변경을 발표했습니다. 2026년 6월 18일부터 Gemini CLI와 Gemini Code Assist IDE 확장 프로그램은 개인 계정의 요청을 처리하지 않게 되었습니다. Google은 이런 사용자를 Antigravity CLI로 안내하며, Agent Skills, Hooks, Subagents, Extensions(현재는 plugins라고 부름) 등 Gemini CLI의 핵심 기능을 이어받았다고 설명합니다.
지금 개인 계정으로 로그인하면, 브라우저에는 인증에 성공했다고 나온 뒤 터미널에 다음이 출력됩니다.
This client is no longer supported for Gemini Code Assist for individuals. To continue using Gemini, please migrate to the Antigravity suite of products.이는 gemini-cli issue #28229에 보고된 문구입니다. 일부 이전 가이드는 CLI에서 HTTP 410 Gone이 반환된다고 보고합니다. Google이 상태 코드를 문서화한 것은 확인하지 못했으니 메시지를 기준으로 판단하세요. 이 메시지가 보이면 그 로그인 방식은 폐지된 것입니다. 할당량 문제가 아닙니다.
영향을 받는 사람과 받지 않는 사람
| Gemini CLI 사용 방식 | 2026년 6월 18일 이후 |
|---|---|
| 개인 Google 계정, 무료 등급 | 중단 |
| Google AI Pro 또는 Ultra 구독 | 중단 |
| 무료 Gemini Code Assist for individuals | 중단 |
| Gemini Code Assist for GitHub (Google Cloud를 거치지 않는 GitHub 앱) | 2026년 6월 18일부터 신규 설치 불가, 이후 몇 주 안에 요청 처리 중단 |
| Gemini Code Assist Standard 또는 Enterprise 라이선스 | 영향 없음 |
| Google Cloud를 통한 Gemini Code Assist for GitHub | 영향 없음 |
| 유료 Gemini API 키 또는 Google의 엔터프라이즈 에이전트 플랫폼 | 영향 없음 |
이 표는 Google의 발표를 따릅니다. Google이 유료 API 키라고 명시한 점에 유의하세요. 무료 AI Studio 키에 의존하고 있다면, 그걸 믿기 전에 발표를 직접 확인하세요.
방법 1: Antigravity CLI(agy)로 옮기기
Google 계정으로 Gemini CLI를 쓰던 대부분의 사람에게 이것이 Google이 의도한 경로입니다. 공식 설치 페이지에서 설치하세요.
# macOS and Linux (installs ~/.local/bin/agy)
curl -fsSL https://antigravity.google/cli/install.sh | bash
# Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iexagy를 실행하고 Google 로그인을 고릅니다. 데스크톱에서는 브라우저가 열립니다. SSH로 접속한 경우에는 대신 인증 URL을 출력하므로, 아무 기기에서 그 URL을 열고 코드를 터미널에 붙여넣으면 됩니다. 덕분에 헤드리스 서버에서도 쓸 수 있습니다.
Gemini CLI 설정 가져오기
Google의 이전 가이드는 자동으로 옮겨지는 것과 그렇지 않은 것을 설명합니다.
- 첫 실행:
agy가 기존 Gemini CLI 프로필을 찾으면 체크리스트를 보여 주고, 확장 프로그램과 전역 설정 변환, 세션 토큰의 OS 키링 이동, 설정 매핑을 제안합니다. - 확장 프로그램: 직접 변환하려면
agy plugin import gemini를 실행하세요. 확장 프로그램을 Antigravity 플러그인으로, 기존 명령을 스킬로 바꾸고 MCP 서버 정의도 옮깁니다. 처리한 것과 건너뛴 것을 출력하니 꼭 읽어 보세요. - 컨텍스트 파일:
GEMINI.md와AGENTS.md는 이름을 바꾸지 않아도 그대로 작동합니다. - 스킬: 워크스페이스 스킬은
.gemini/skills/에서.agents/skills/로 옮기세요. 전역 스킬은 이제~/.gemini/antigravity-cli/skills/에 있습니다. - MCP: 서버 정의는
~/.gemini/settings.json에서mcp_config.json(전역은~/.gemini/config/, 워크스페이스별은.agents/)으로 옮겨지며, 원격 서버는url/httpUrl대신serverUrl을 씁니다.
Google은 Gemini CLI의 일부 사용자 지정 터미널 테마와 실험적인 시각 오버레이가 옮겨지지 않을 수 있다고도 밝힙니다. 브라우저 없는 로그인을 포함해 VPS에서의 전체 과정은 서버에서 Antigravity CLI 실행하기를 참고하세요.
방법 2: API 키로 Gemini CLI 계속 쓰기
gemini 명령을 중심으로 만든 스크립트가 있다면, Google AI Studio의 유료 키로 계속 실행할 수 있습니다. Gemini CLI 인증 문서에 따르면 다음과 같습니다.
export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"
gemini
# then pick "Use Gemini API key"애플리케이션 기본 사용자 인증 정보, 서비스 계정, Google Cloud API 키를 통해 Vertex AI도 사용할 수 있습니다. 대가는 과금 방식입니다. 정액 구독이 아니라 토큰 단위로 비용을 냅니다. 회사에서 Code Assist Standard나 Enterprise를 쓰고 있다면 달라지는 것이 없습니다.
API 키는 agy에서도 작동합니다. ~/.gemini/antigravity-cli/settings.json에 {"modelProvider": "gemini"}를 설정하고 GEMINI_API_KEY를 export하세요. 대화형 로그인이 번거로운 CI나 헤드리스 머신에 적합합니다.
방법 3: 다른 코딩 에이전트로 바꾸기
이번 종료는 Gemini가 여전히 원하는 에이전트인지 다시 생각해 볼 좋은 기회이기도 합니다. Claude Code는 Claude Pro 또는 Max 요금제로 실행됩니다. Codex는 ChatGPT 요금제나 OpenAI API 키로 실행됩니다. OpenCode는 오픈 소스이며 여러 모델 제공자와 작동합니다. AGENTS.md는 그대로 가져갈 수 있습니다. Codex는 이를 기본으로 읽고, 최근 Claude Code 버전은 CLAUDE.md가 없을 때 읽습니다. 세 가지는 Claude Code vs Codex vs OpenCode에서 비교합니다.
| 방법 | 적합한 대상 | 비용 구조 | 수고 |
|---|---|---|---|
| Google 로그인으로 Antigravity CLI | 개인 계정으로 Gemini CLI를 쓰던 사용자 | 내 Google 요금제 | 설치, 로그인, 가져오기 |
| API 키로 Antigravity CLI 또는 Gemini CLI | CI, 스크립트, 서버 | 토큰당 과금 | 변수 하나 설정 |
| Code Assist Standard/Enterprise로 Gemini CLI | 회사 계정 | 조직 라이선스 | 없음 |
| 다른 에이전트 (Claude Code, Codex, OpenCode) | 재검토하는 누구나 | 해당 업체의 요금제나 키 | 새로 설치하고 습관 바꾸기 |
Antigravity의 요금 페이지에는 주간 사용량 제한이 있는 $0 Individual 요금제와, 한도가 더 높은 Google AI Pro와 Ultra가 나와 있습니다. 하지만 어떤 요금제에도 구체적인 수치는 없고, 각 할당량 중 CLI가 얼마나 쓸 수 있는지도 확인하지 못했습니다. 비용을 정하기 전에 Google의 최신 요금제 페이지를 확인하세요.
Maude에서 한 일
Maude는 코딩 에이전트를 내 서버에서 실행하고 휴대폰으로 조작할 수 있게 해 줍니다. 저희가 Gemini CLI 지원을 중단한 이유는 여러분이 이 글을 읽는 이유와 같습니다. Maude는 각 에이전트를 사용자 자신의 계정에 연결하는데, Gemini CLI의 경우 그것은 개인 Google 로그인을 의미했고, 이제 그것이 작동하지 않습니다. Maude 2.0은 대신 Antigravity CLI를 Claude Code, Codex, OpenCode, Grok Build와 함께 지원합니다. 앱은 검증된 고정 버전의 agy를 서버에 설치하고, 휴대폰에서 Google(코드를 붙여넣는 방식)이나 Gemini API 키로 로그인합니다.
주의할 점이 하나 있습니다. 헤드리스 모드의 agy는 도구를 실행하기 전에 멈춰서 물어볼 수 없습니다. 권한이 필요한 작업은 거부되고, 턴에서 이를 보고합니다. Maude는 거부된 작업을 하나씩 보여 주고 나중에 승인할 수 있게 합니다. 승인하면 agy 자체 설정에 허용 규칙을 추가하고 다시 시도합니다. 작동은 하지만 먼저 묻는 Claude Code의 방식과는 다르므로, 고르기 전에 알아 두세요.
Google도 자체 Antigravity Remote Control을 제공합니다. agy 안에서 /remote-control을 실행하거나, 헤드리스 데몬으로 agy remote-control start를 실행한 뒤 웹 대시보드에서 조작합니다. Antigravity만 쓴다면 이것부터 써 보세요.
자주 묻는 질문
Gemini CLI는 끝난 건가요?
API 키로는 Gemini CLI가 아직 작동하나요?
GEMINI_API_KEY를 export하고 gemini를 실행한 뒤 "Use Gemini API key"를 고르세요. 구독 대신 토큰당 요금이 청구됩니다.Gemini CLI를 대체한 것은 무엇인가요?
agy로 실행하는 Antigravity CLI입니다. macOS나 Linux에서는 curl -fsSL https://antigravity.google/cli/install.sh | bash로 설치합니다. 첫 실행 시 Gemini CLI 설정을 가져오도록 제안하며, agy plugin import gemini로 확장 프로그램을 플러그인으로 변환합니다.GEMINI.md는 Antigravity에서도 작동하나요?
GEMINI.md와 AGENTS.md는 이름을 바꾸지 않아도 계속 작동합니다. 워크스페이스 스킬은 .gemini/skills/에서 .agents/skills/로 옮겨야 하고, MCP 서버는 mcp_config.json으로 옮겨집니다.Maude에서 아직 Gemini 모델을 쓸 수 있나요?
변경 사항
- — 최초 게시. Google의 발표, Antigravity CLI 설치 및 이전 문서, Gemini CLI 인증 문서로 사실을 확인했습니다.
