요약 (TL;DR). 2026년 6월 18일, Gemini CLI는 무료 "Google 계정으로 로그인 (Sign in with Google)" 경로와 AI Pro 및 Ultra 로그인을 통한 요청 제공을 중단했습니다. 바이너리(Binary)가 죽은 것은 아닙니다. 여전히 Apache-2.0 라이선스이며, 계속 유지 관리되고 있고 (v0.49.0), API 키를 통해 여전히 실행됩니다. 만약 "This client is no longer supported for Gemini Code Assist for individuals"라는 메시지를 보고 있다면, 이는 설치 오류가 아니라 인증 (Auth) 문제입니다. 해결 방법은 Google 계정으로 로그인하는 것을 중단하고, 결제가 활성화된 API 키를 사용하기 시작하는 것입니다. 2026년 9월에는 제한 없는 Standard 키가 은퇴하는 두 번째 장벽이 기다리고 있으므로, 두 번 작업하지 말고 한 번에 키를 올바르게 설정하십시오. 아래에 무료 티어 임시 방편부터 프로덕션 라우팅 (Production routing)까지 6가지 해결 방법을 정리했습니다.

Google은 6월 18일에 Gemini CLI를 없앤 것이 아닙니다. 무료 로그인을 없앤 것입니다. 도구는 여전히 작동하지만, 이제는 Google 계정 대신 키를 요구합니다.

당신의 Gemini CLI가 고장 났나요? 30초 진단법

세 가지 확인 사항을 순서대로 진행하세요. CLI가 고장 났다고 생각하는 대부분의 사람들은 환경 변수 (Environment variable) 하나만 설정하면 바로 작동할 상태입니다.

단계	확인 사항	의미
1	에러 텍스트	"This client is no longer supported for Gemini Code Assist for individuals"는 무료 OAuth 로그인이 사라졌음을 의미합니다. "Quota exceeded … limit: 0" 또는 429 RESOURCE_EXHAUSTED는 키에 유료 할당량 (Quota)이 없음을 의미합니다.
...

만약 1단계에서 "no longer supported" 메시지가 나타나면 해결 방법 1로 건너뛰세요. 만약 429 또는 limit: 0이 나타난다면 이미 키를 가지고 있지만 할당량이 없는 상태이므로 해결 방법 3으로 가십시오. 이 가이드의 나머지 내용은 9월 키 차단 시점에 다시 작업해야 하는 상황을 방지하기 위해, 한 번에 마이그레이션 (Migration)을 완료하는 방법에 관한 것입니다.

제자리에서 수정할 때와 도구를 교체할 때

이 결정은 잘못된 레이어 (Layer)를 붙잡고 오후 시간을 허비하는 것을 막아줍니다.

다음과 같은 경우 Gemini CLI를 제자리에서 수정하십시오 (해결 방법 1~5):

• gemini를 호출하는 기존 스크립트, 별칭 (alias), 또는 CI (지속적 통합)가 있으며 이를 다시 작성하고 싶지 않은 경우.
• 토큰당 비용을 지불할 의사가 있으며, 이미 익숙한 동일한 도구를 사용하고 싶은 경우.
• Vertex AI 또는 Code Assist 라이선스 경로가 필요하며, 이 두 경로는 6월 18일 변경 사항의 영향을 받지 않은 경우.

다음과 같은 경우 Antigravity CLI로 전환하십시오:

• 오직 무료 소비자 로그인만 사용해 왔고, 결제 (billing)를 활성화하고 싶지 않으며, Google이 소비자를 적극적으로 유도하고 있는 경로를 따르고 싶은 경우.
• 더 새로운 비동기 (async) 백그라운드 에이전트 워크플로 (workflow)를 원하며, 이것이 별도의 폐쇄 소스 (closed-source) 바이너리라는 점은 상관없는 경우.

게이트웨이를 통해 라우팅하는 경우 (해결 방법 6):

• Google Cloud 프로젝트, 결제 계층 (billing tiers), 그리고 9월의 키 마이그레이션 (key migration)을 관리하지 않고 Gemini, GPT, Claude 등을 하나의 키로 사용하고 싶은 경우.
• 단일 제공업체의 정책 변경으로 인해 서비스가 중단되는 일이 다시는 발생해서는 안 되는 사용자 대상 서비스를 구축 중인 경우.

중단 규칙 (Stop rule). 만약 Google 로그인을 세 번이나 다시 실행하고, ~/.gemini를 삭제했으며, CLI를 재설치했음에도 여전히 "더 이상 지원되지 않음 (no longer supported)" 메시지가 나타난다면, 즉시 중단하십시오. 재설치로는 서버 측 인증 (auth) 정책을 해결할 수 없습니다. 토큰 교환이 의도적으로 거부되고 있는 것입니다. API 키로 전환하면 이 루프가 끝납니다.

2026년 6월 18일에 실제로 변경된 내용

Google은 5월 19일 I/O 2026에서 이를 발표했으며, Developers Blog에 "중요 업데이트: Gemini CLI를 Antigravity CLI로 전환합니다"라는 제목으로 게시했습니다. 핵심 문장은 다음과 같습니다:

"2026년 6월 18일부터 Gemini CLI 및 Gemini Code Assist IDE 확장 프로그램은 Google AI Pro 및 Ultra에 대한 요청과, 개인용 Gemini Code Assist를 사용하여 무료로 사용하는 요청에 대한 서비스를 중단합니다."

이 문장을 주의 깊게 읽으십시오. 왜냐하면 대중적인 "Gemini CLI가 죽었다"라는 프레임은 상황을 잘못 짚고 있기 때문입니다. 세 가지 별도의 인증 (auth) 경로가 있으며, 그에 따른 세 가지 서로 다른 결과가 존재합니다:

인증 경로 (Auth path)	2026년 6월 18일 이후 상태	조치 사항
OAuth "Google로 로그인" 무료 티어 (개인용 Code Assist, AI Pro, Ultra)	중단됨. 더 이상 요청이 처리되지 않음.	API 키로 전환하거나, Antigravity CLI로 이동하십시오.
...

Google의 발표는 생존자들에 대해 단호합니다: "Gemini CLI는 유료 Gemini 및 Gemini Enterprise Agent Platform API 키를 통해 계속 접근할 수 있습니다." 또한 기업용 라이선스와 Google Cloud 액세스는 "변경되지 않고 유지됩니다." 후속 리포지토리(repo) 공지인 Discussion #28017은 개인 계정 차단이 예정대로 실행되었음을 확인했습니다.

바이너리(binary) 자체는 문제가 없습니다. 리포지토리는 아카이브(archived)되지 않았고, 라이선스는 여전히 Apache-2.0이며, 중단 일주일 후인 6월 25일에 v0.49.0이 출시되었습니다. Google은 명확하게 밝혔습니다: 이 프로젝트는 "변경 사항 없이 Apache 2.0 라이선스가 적용된 리포지토리로서 커뮤니티에 계속 제공됩니다." 따라서 누군가 당신에게 Gemini CLI 설정을 포기하라고 말한다면, 그들은 "무료 로그인이 종료된 것"과 "도구가 종료된 것"을 혼동하고 있는 것입니다. 오직 전자의 사실만이 참입니다.

이것은 갑자기 발생한 일이 아닙니다. 지난 2026년 3월 18일, Google은 3월 25일부터 적용되는 제한 사항을 담은 서비스 업데이트(Discussion #22970)를 게시했습니다. 해당 업데이트는 이미 무료 OAuth 사용자를 Flash 티어 모델로 제한하고 "정책 위반 사용 사례에 대한 더욱 강력한 탐지"를 추가했으며, 사용자들에게 "AI Studio 또는 Vertex AI에서 제공하는 본인의 유료 API 키를 사용하여 Gemini CLI를 사용하십시오"라고 권장했습니다. 6월 18일은 3월 업데이트가 예고했던 최종 차단 시점이었습니다.

오류 이해하기: 각 오류의 의미

네 가지 오류 시그니처(error signatures)가 거의 모든 보고 사례를 포괄합니다. 자신의 오류를 해당 행과 대조하면 어떤 해결책을 적용해야 하는지 알 수 있습니다.

보이는 오류	실제 원인	해결 방법
This client is no longer supported for Gemini Code Assist for individuals. To continue using Gemini, please migrate to the Antigravity suite of products.	은퇴(retired)된 무료 OAuth 로그인을 사용 중입니다. 브라우저 단계는 성공하지만, 토큰 교환(token exchange)이 거부됩니다.	해결 방법 1 (API 키로 전환)
...

내재화할 가치가 있는 패턴: 로그인 오류는 인증 방식(auth method)을 가리키고, limit: 0 오류는 결제(billing)를 가리킵니다. 터미널에서는 비슷하게 느껴지지만 완전히 다른 해결책이 필요합니다. 로그인 오류를 해결하기 위해 결제를 활성화하지 마세요. 또한 할당량(quota) 오류를 해결하기 위해 다시 로그인하지 마세요.

Gemini CLI를 계속 실행하는 방법 (모든 티어별 해결책)

"5분 안에 작동하는 무료 방식"부터 "프로덕션 라우팅(production routing)" 순으로 정렬되었습니다. 본인에게 맞는 티어를 적용하세요.

무료 / 개인용 티어 (Free / Individual Tier)

해결 방법 1: Google 로그인에서 AI Studio API 키로 전환

이것이 핵심적인 조치이며 "더 이상 지원되지 않음(no longer supported)" 메시지를 직접적으로 해결합니다. aistudio.google.com/apikey에서 키를 생성한 후, 다음을 수행하세요:

export GEMINI_API_KEY="your_ai_studio_key"
gemini "say hi"

정상적인 응답이 돌아온다면 다시 정상적으로 사용할 수 있다는 의미입니다. CLI가 실제로 키를 사용 중인지, 아니면 조용히 캐시된 로그인 방식으로 되돌아간(fallback) 것인지 확인하려면, 시작 시 인증 라인을 확인하거나 변수를 먼저 출력해 보세요:

echo "${GEMINI_API_KEY:0:6}..."   # 비어 있지 않고 키의 앞 글자들이 보여야 합니다

만약 메뉴에서 선택하는 방식을 선호한다면, CLI 내부에서 /auth를 실행하고 "Login with Google" 대신 Gemini API key 옵션을 선택하세요. 설정은 ~/.gemini/settings.json에 저장되므로 한 번만 수행하면 됩니다. 우선순위에 관한 주의사항 하나: 클라이언트 라이브러리는 GEMINI_API_KEY와 GOOGLE_API_KEY를 모두 허용하며, 두 가지가 모두 설정되어 있다면 GOOGLE_API_KEY가 우선합니다. 키가 올바른 것 같은데 동작이 이상하다면, 이전 Vertex 실험에서 남겨진 잘못된 GOOGLE_API_KEY가 셸 프로필(shell profile)에 있는지 확인하세요.

Flash 및 Flash-Lite 제품군을 위한 무료 키는 여전히 존재하므로, 해결 방법 1(Fix 1)만으로도 많은 사용자가 다시 작동하게 할 수 있습니다. 하지만 이는 최선의 노력(best-effort)일 뿐이며, 다음 해결 방법이 필요할 수 있습니다.

해결 방법 2: 키를 탓하기 전에 깨진 인증 상태(auth state)를 초기화하세요

키를 변경했음에도 CLI가 여전히 Google 계정으로 로그인을 시도한다면, 이전의 selectedAuthType이 캐시(cached)되어 있는 것입니다. 이를 삭제하세요:

# 먼저 백업한 후, CLI의 저장된 인증 선택 사항을 초기화합니다
mv ~/.gemini/settings.json ~/.gemini/settings.json.bak
gemini   # 다시 /auth 프롬프트가 나타납니다. API 키 옵션을 선택하세요

이 방법은 "인증 방법(Auth method)을 설정해 주세요"라는 오류와, API 키가 설정되어 있는 동안 CLI가 인증 유형 전환을 거부하는 이슈 #2111의 사례에 대한 해결책이기도 합니다. 오래된 설정 파일(settings file)은 실제 키 문제보다 더 많은 "여전히 작동하지 않는다"는 보고의 원인이 됩니다.

유료 / 팀 티어 (Paid / Team Tier)

해결 방법 3: 429 limit: 0 함정에서 벗어나기 위해 결제(billing)를 활성화하세요

이것은 "키를 추가했는데도 여전히 429 오류가 발생한다"는 모든 보고에 대한 해결책입니다. 순수 AI Studio 키는 무료 티어(Free Tier)에 머물러 있으며, Google One AI Pro 구독을 한다고 해서 유료 할당량(paid quota)이 해당 키로 넘어가지 않습니다. 이 경우 지표(metric)가 limit: 0으로 반환되는데, 이는 버그처럼 보이지만 실제로는 할당되지 않은(unprovisioned) 키일 뿐입니다.

다음 과정을 한 번만 수행하세요:

1. AI Studio 결제(billing) 페이지를 열고, 사용 중인 키의 프로젝트에 Google Cloud 결제 계정(Google Cloud Billing account)을 연결합니다.
2. 실제 지출 한도(spend cap)를 설정합니다. $0 한도는 무료 티어에 머물게 하여 429 오류를 재현하므로, 본인이 감당할 수 있는 금액을 설정하세요 (단 $10만 설정해도 유료 티어 1(Tier 1)로 이동하기에 충분합니다).
3. CLI 인증을 새로고침합니다: 해결 방법 2의 방식대로 캐시를 삭제하거나 키를 다시 내보내기(re-export)한 후 재시도하세요.

Google의 티어는 지출액에 따라 단계적으로 상승합니다: 무료(Free), 그 다음 티어 1(Tier 1, 결제 활성화됨), 그 후 더 높은 유료 임계값에서 티어 2 및 티어 3로 올라가며, 각 단계마다 속도 제한(rate limits)이 높아집니다. 티어 1만으로도 일정 시간당 지출 허용량(예: 10분당 약 $10 수준)이 제공되므로 개인 사용에는 충분합니다.

해결 방법 4: 유료 요금이 적게 나오도록 모델 크기를 적절히 조절하세요 (Right-size)

이제 토큰(token)당 비용을 지불해야 하므로, 모델을 신중하게 선택해야 합니다. Gemini API의 현재 표준 가격은 1M 토큰당 다음과 같습니다 (2026-07-07 공식 가격 페이지 확인 기준):

모델	입력 / 1M	출력 / 1M	비고
Gemini 3.1 Flash-Lite	$0.25	$1.50	가장 저렴함; 일상적인 편집 및 셸(shell) 작업에 적합
...

대부분의 터미널 작업에는 Flash-Lite가 적절한 기본값이며, 사용량이 많은 날에도 1달러 미만으로 유지할 수 있습니다. 본격적인 코딩에는 Flash로 업그레이드하고, 정말 어려운 프롬프트(prompt)에 대해서만 Pro를 사용하세요. 더 자세한 가격 및 성능 분석을 원하시면 Gemini 3.1 Pro API 가격 가이드를 참조하십시오. Google 측의 모델 이름은 빠르게 변경되므로, 스크립트에 하드코딩(hard-code)하기 전에 가격 페이지에서 정확한 ID를 다시 확인하십시오.

엔터프라이즈 / 프로덕션 티어 (Enterprise / Production Tier)

해결 방법 5: Vertex AI 또는 Code Assist 라이선스 사용

이 두 가지 경로는 6월 18일 이후에도 영향을 받지 않았으므로, 이미 Google Cloud 환경을 사용 중이라면 가장 깔끔한 옵션이 됩니다. Vertex AI의 경우:

export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_CLOUD_PROJECT="your-project-id"
export GOOGLE_CLOUD_LOCATION="us-central1"
...

Vertex는 사용자의 Cloud 프로젝트의 결제 및 IAM을 사용하므로, 할당량(quota)과 액세스(access)는 Google이 재분류할 수 있는 개인 계정이 아닌 프로젝트에 의해 관리됩니다. 조직에서 Gemini Code Assist Standard 또는 Enterprise 라이선스를 보유하고 있다면, CLI 및 IDE 확장 프로그램은 아무런 변경 없이 계속 작동합니다. 이는 Google의 발표에 직접 명시되어 있습니다. 팀 단위의 경우, 이것이 보통 가장 안정적인 해결책입니다.

해결 방법 6: 하나의 게이트웨이를 통해 라우팅하고 Google의 티어에 신경 쓰지 않기

만약 Cloud 프로젝트, 결제 티어(billing tier), 그리고 9월에 예정된 키 마이그레이션(key migration)을 직접 관리하고 싶지 않다면, Gemini 프로토콜을 지원하는 게이트웨이로 Gemini CLI를 지정하십시오. ofox.ai를 통하면, 동일한 CLI에서 하나의 키만 사용하며 Google Cloud 계정 없이도 페일오버(failover) 및 라우팅(routing) 기능을 추가로 활용할 수 있습니다:

{
  "apiKey": "<your OFOX_API_KEY>",
  "baseUrl": "https://api.ofox.ai/gemini"
...

또는 이전과 동일한 형태의 환경 변수(environment variable)로 설정할 수 있습니다:

export GEMINI_API_KEY="<your OFOX_API_KEY>"

이 하나의 키는 동일한 계정을 통해 GPT, Claude, Qwen, DeepSeek 및 기타 모델 마켓플레이스 (model marketplace)에도 접근할 수 있으므로, 향후 특정 벤더가 소비자 정책을 변경하더라도 귀하의 CLI가 함께 중단되는 일을 방지할 수 있습니다. 이는 멀티 모델 라우터 가이드 (multi-model router walkthrough)에서 다루었던 라우팅 개념을 Gemini CLI에 구체적으로 적용한 것입니다.

두 번째 장벽: 아직 마주하지 않은 API 키 마감일

로그인 문제를 해결하는 것이 끝이 아닙니다. 이 부분은 대부분의 "그저 키를 추가하세요" 식의 가이드들이 생략하는 내용입니다. Google은 별도의 일정에 따라 기존 방식의 API 키를 폐지하고 있습니다:

날짜	발생하는 현상
2026년 6월 19일	Gemini API가 제한이 없는 Standard 키를 거부하기 시작합니다. 명시적인 API 제한(API restrictions)이 설정된 Standard 키는 계속 작동합니다.
2026년 9월	Gemini API가 모든 Standard 키를 거부합니다. 반드시 Cloud 서비스 계정(service account)에 종속된 인증 키(auth keys)를 사용해야 합니다.

실질적인 결과는 다음과 같습니다: 만약 오늘 로그인을 해결하기 위해 2025년의 오래된 제한 없는 키를 찾아낸다면, 9월에 다시 장벽에 부딪힐 수 있습니다. 새로운 키는 기본적으로 인증 키(auth keys)로 발급되므로 지금 바로 새 키를 생성하거나, 현재 사용하는 키에 명시적인 API 제한을 적용하십시오. 마이그레이션을 한 번에 올바르게 수행하는 것이, 엉망이 된 오후를 한 번 겪느냐 두 번 겪느냐의 차이를 만듭니다.