제미나이(Gemini) CLI 설치, 직접 해 보니 막힌 Google 로그인

빈 폴더에서 npm으로 Gemini CLI 설치를 3번 하면 중앙값 3.9초 만에 끝나고, 용량은 100MB입니다. --version 첫 실행도 0.71초로 빨랐어요. 그런데 이 Mac에 저장된 개인 Google 로그인으로 제미나이 CLI에 질문을 보내자 3번 모두 IneligibleTierError로 멈췄습니다. 설치는 금방 끝나는데, 개인 계정 로그인은 지금 막혀 있습니다.

설치는 금방, 개인 계정 로그인은 실패

결과부터 볼까요? 2026-10-23에 Gemini CLI 0.65.0으로 잰 값입니다.

AI 에이전트로 혼자 제품을 만들면서 무료 개인 계정으로 Gemini CLI를 붙이려 했다면, 설치보다 인증 방식을 먼저 정해야 합니다. 설치 속도부터 다른 도구와 비교해 보겠습니다.

함께 읽을 글

• 코덱스(Codex) 설치 방법, npm과 설치 스크립트 비교
• 제미나이(Gemini) CLI 로그인 오류, 직접 해 보니 원인과 해결 방법
• 코덱스(Codex) 사용법, 설치부터 요청 문장 쓰는 법까지

클로드 코드·코덱스와 설치 속도를 비교하면?

같은 조건(빈 임시 폴더, 빈 npm 캐시, 3번씩 번갈아 설치)에서 Claude Code와 Codex의 npm 설치도 쟀습니다.

도식출처: Gemini CLI 설치 실측

세 도구 중 Gemini CLI가 설치 시간과 용량 모두 가장 작았습니다. 다만 무엇이 이 차이를 만드는지는 이 측정만으로 가를 수 없습니다. 궁금하다면 설치 뒤 lib/node_modules 폴더 안을 직접 열어 어떤 패키지가 들어왔는지 비교해 보세요. 회차별 편차도 작았어요. Gemini CLI의 설치 시간은 3.8~4.2초 사이였습니다.

도식출처: Gemini CLI 설치 실측

공식 문서대로 설치하는 순서

공식 설치 문서가 권하는 환경과 순서는 다음과 같습니다.

1. 환경을 확인합니다. 운영체제는 macOS 15+, Windows 11 24H2+, Ubuntu 20.04+이고 런타임은 Node.js 20.0.0+입니다. 셸은 Bash, Zsh, PowerShell 중 하나를 쓰고 인터넷 연결이 필요합니다. 메모리는 가벼운 사용에 4GB+, 긴 세션과 큰 코드베이스에는 16GB+를 권합니다.
2. 설치 방법 하나를 고릅니다. npm 외에 Homebrew(macOS/Linux)와 MacPorts(macOS)도 있습니다.

npm install -g @google/gemini-cli

brew install gemini-cli

3. gemini 명령으로 실행합니다. 설치 없이 한 번만 써 보려면 npx @google/gemini-cli로도 됩니다.

gemini

태그 없이 설치하면 매주 나오는 안정판(stable)이 깔립니다. 그래서 위 측정의 0.65.0도 그 시점의 기본 설치 버전입니다.

Gemini CLI 로그인, 왜 막혔을까요?

gemini -p "Reply with only: OK" --output-format json을 3번 실행한 결과입니다. 인증 방식은 oauth-personal(Sign in with Google)이었습니다.

오류의 등급 이름은 무료 개인용인 Gemini Code Assist for individuals(free-tier)였습니다. 메시지는 이 클라이언트가 더는 개인용 등급을 지원하지 않으니 Antigravity 제품군으로 옮기라는 내용이었죠. 대화형 화면에서도 같았습니다. 브라우저 인증은 성공으로 표시됐지만, 바로 뒤에 로그인 실패 메시지가 같은 내용으로 나왔어요. 브라우저 단계만 보고 로그인이 됐다고 판단하면 안 되는 이유입니다.

이유는 Google 문서에 그대로 적혀 있습니다. 지원 종료 문서에 따르면 2026년 6월 18일부터 Gemini Code Assist for individuals, Google AI Pro, Google AI Ultra 등급의 요청 처리가 멈췄고, 이는 Gemini CLI 사용에도 적용됩니다. 그래서 이 등급에서는 Login with Google로 Gemini CLI에 접근할 수 없습니다.

그럼 같은 계정으로 Antigravity CLI는 될까요? agy -p로 같은 문장을 3번 보내자 모두 SUCCESS였고, 걸린 시간은 10.1초, 10.4초, 8.7초였습니다. 개발자 블로그 공지는 Antigravity CLI가 Agent Skills, Hooks, Subagents, Extensions(이제 Antigravity 플러그인)를 이어받는다고 밝혔습니다. 다만 처음부터 기능이 1:1로 같지는 않다고 적었습니다.

도식출처: 근거를 바탕으로 코드가 그린 도식

영향을 받지 않는 계정과 인증 방식

공지에 따르면 조직이 Gemini Code Assist Standard 또는 Enterprise 라이선스로 Gemini CLI를 쓰는 경우는 접근이 그대로입니다. Google Cloud를 통한 Gemini Code Assist for GitHub도 마찬가지예요. 다만 지원 종료 문서는 Standard·Enterprise 구독이 별도의 지원 종료 일정을 따른다고 적었습니다. 또 Gemini CLI는 유료 Gemini API 키와 Gemini Enterprise Agent Platform API 키로 계속 쓸 수 있다고 공지했습니다.

인증 문서에 나온 다른 방식은 두 가지입니다. 이 측정에서는 둘 다 실행하지 않았습니다.

• Gemini API 키: Google AI Studio에서 키를 받아 환경 변수에 넣고 gemini 실행 후 Use Gemini API key를 고릅니다.

# Replace YOUR_GEMINI_API_KEY with the key from AI Studio
export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"

• Vertex AI: Vertex AI API를 켠 Google Cloud 프로젝트가 필요합니다. 인증 방법과 관계없이 프로젝트 ID와 위치를 설정한 뒤 Vertex AI를 고릅니다.

# Replace with your project ID and desired location (for example, us-central1)
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
export GOOGLE_CLOUD_LOCATION="YOUR_PROJECT_LOCATION"

API 키는 계정의 민감한 자격 증명이라 문서도 보호하라고 경고합니다. 에이전트가 읽는 저장소에 키를 넣지 않도록 주의하세요.

설치 전에 먼저 확인할 것

설치는 4초 남짓이면 끝나니, 시간을 쓸 곳은 계정 확인입니다.

• 내 계정 등급이 무료 개인용, Google AI Pro, Ultra 중 하나인지 확인합니다. 그렇다면 Login with Google로는 쓸 수 없습니다.
• 유료 Gemini API 키나 Vertex AI용 Google Cloud 프로젝트가 있는지 봅니다.
• 개인 Google 계정을 그대로 쓰고 싶다면 Antigravity CLI가 대안입니다. 같은 계정으로 3번 모두 답을 받았습니다.
• Node.js 20.0.0 이상인지 확인합니다.

측정 조건과 한계

측정은 darwin arm64 Mac 한 대, Node.js v22.23.1, 그 시점의 인터넷에서 했습니다. npm은 전역 설치 위치를 빈 임시 폴더로 바꾸고 매번 빈 캐시를 써서 모든 파일을 새로 받게 했습니다. 설치 시간은 인터넷 속도에 따라 달라지니 숫자는 참고용으로 보세요.

로그인 실험은 무료 개인용 등급 Google 계정 하나로만 했습니다. Pro·Ultra 계정이나 조직 계정, API 키, Vertex AI는 실행하지 않았고 문서 내용만 옮겼습니다. Antigravity CLI는 모델을 지정하지 않고 짧은 한 문장만 보냈으니, 실제 코딩 작업에서의 속도는 따로 확인해야 합니다.