Gemini CLI 무료 써봤습니다 — 4배 차이 나는 이유

“하루 1,000회 무료”라고 알려진 Gemini CLI. 직접 확인해봤더니 인증 방식에 따라 250회짜리도 존재했습니다. 어떤 방식으로 시작했는지에 따라 무료가 맞기도 하고, 생각지 못한 과금이 시작되기도 합니다.

“하루 1,000회 무료”— 절반만 맞습니다

Gemini CLI를 처음 알게 된 사람들이 가장 먼저 찾는 정보가 바로 이겁니다. “하루 1,000회 무료로 쓸 수 있대.” 틀린 말은 아닙니다. 하지만 조건이 있습니다.

1,000회는 개인 Google 계정으로 OAuth 로그인한 경우에만 해당합니다. Gemini CLI를 처음 설치하면 인증 방식을 선택하는 화면이 나오는데, 여기서 “Gemini API Key”를 선택하면 이야기가 달라집니다. API Key 기반 무료 티어는 공식 문서 기준으로 하루 250회, 분당 10회입니다. (출처: geminicli.com 공식 Quota 문서, 2026.03)

같은 “무료”인데 한쪽은 1,000회, 다른 쪽은 250회. 4배 차이입니다. 처음 설정 화면에서 어떤 버튼을 눌렀느냐로 이 숫자가 갈립니다.

▲ 목차로 돌아가기

공식 문서에 딱 이렇게 나와 있습니다: 인증별 한도 비교

Google Developers 공식 페이지(developers.google.com/gemini-code-assist/resources/quotas)에서 인증 방식별 한도를 직접 확인했습니다. 표로 정리하면 이렇습니다.

(출처: Google Developers 공식 문서 — Gemini Code Assist Quotas, 2026.03 기준)

API Key를 쓰더라도 결제 계정이 연결돼 있으면 무료 한도 초과 시 토큰 단위로 자동 과금됩니다. 한도 초과가 뭔지도 모른 채 요청이 계속 날아가면, 청구서는 며칠 뒤에 도착합니다.

또 하나. API Key 무료 티어는 Flash 계열 모델만 사용 가능합니다. OAuth 무료는 Gemini CLI가 작업 성격에 따라 Gemini 모델 패밀리 전체를 자동으로 선택해 씁니다. 단순 요청 수 차이 외에 접근 가능한 모델 범위 자체가 다릅니다.
▲ 목차로 돌아가기

API Key로 시작하면 무료인 게 아닌 이유

Reddit 커뮤니티에 실제 사례가 올라왔습니다. 제목이 딱 이겁니다. “Gemini CLI로 150달러 실수했어. API Key 쓰지 말고, Google로 로그인해.” 어떻게 된 일이냐면, AI Studio에서 API Key를 발급받아 Gemini CLI에 연결했는데, 이 키가 이미 결제 계정과 연결된 프로젝트 소속이었습니다. 무료 티어 250회를 넘어서는 순간 토큰 단위 과금이 자동으로 시작됐고, 사용자는 나중에서야 알았습니다. (출처: Reddit r/GoogleGeminiAI, 2025.07)

API Key가 나쁜 방식은 아닙니다. 하지만 Gemini CLI를 개인 개발 목적으로 시작할 때 API Key를 선택하는 건 굳이 위험 요소를 추가하는 셈입니다. OAuth 로그인은 고정 한도 안에서 작동하기 때문에 한도를 초과해도 추가 과금이 발생하지 않습니다. 그냥 요청이 막힙니다.

반면 API Key + 결제 계정 조합은 한도를 초과하면 요청이 막히는 게 아니라 계속 나가면서 요금이 붙습니다. 한도가 없는 대신 지갑에서 한도가 생기는 구조입니다.

▲ 목차로 돌아가기

무료 OAuth를 쓰는데도 조심해야 할 조건이 있습니다

OAuth 무료 티어를 쓰면 과금 걱정은 없습니다. 대신 이걸 감수해야 합니다. 개인 Gmail 계정으로 OAuth 로그인해서 무료로 쓰는 경우, 입력한 프롬프트와 코드가 Google 모델 학습 데이터로 수집될 수 있습니다. (출처: seonggi.kr 기술 블로그, Gemini CLI 인증 방안 비교, 2025.08 — Google 정책 기반 분석)

Google은 유료 요금제 사용자와 Vertex AI 경로에 대해서는 프롬프트와 코드를 학습에 사용하지 않는다는 입장입니다. 무료로 쓰는 대신 내 코드가 어딘가에 쓰인다는 트레이드오프는 처음 설정 전에 알고 결정하는 편이 낫습니다.

개인 사이드 프로젝트 수준이라면 크게 신경 쓸 일은 아닙니다. 단, GDPR 적용 국가 서비스나 기업 프로젝트에 Gemini CLI를 쓰려면 인증 방식을 Vertex AI로 바꾸거나 유료 Workspace 라이선스로 전환해야 합니다.

▲ 목차로 돌아가기

유료 플랜으로 올리면 실제로 얼마나 달라집니까

무료 OAuth 1,000회로 하루 작업이 부족하다면 선택지는 두 가지입니다. Google AI Pro 또는 Google AI Ultra 구독으로 올리거나, API Key에 결제 계정을 연결해서 무제한 종량제로 전환하는 것입니다.

공식 문서 기준으로 플랜별 한도는 이렇습니다. 무료 개인 계정이 하루 1,000회, Google AI Pro가 하루 1,500회, Google AI Ultra가 하루 2,000회입니다. 분당 처리 한도도 유료는 60회에서 120회로 2배 올라갑니다. (출처: developers.google.com/gemini-code-assist/resources/quotas, 2026.03)

에이전트 모드나 복잡한 멀티 스텝 작업은 1회 프롬프트가 내부적으로 여러 번의 모델 요청으로 분할됩니다. 공식 문서에도 “에이전트 모드에서 하나의 프롬프트가 다수의 모델 요청을 발생시킨다”고 명시돼 있습니다. 단순 질의와 에이전트 작업을 섞어 쓴다면 1,000회가 생각보다 빠르게 소진될 수 있습니다.

▲ 목차로 돌아가기

실제 하루 8시간 개발에서 1,000회가 부족한 경우가 있습니다

국내 티스토리 기술 블로그에서 Gemini CLI 바이브 코딩 후기를 확인했습니다. OAuth 인증 상태에서 8시간 넘게 개발에 사용했는데 한도에 걸리지 않았다고 합니다. 단순 질의 + 파일 생성 + 검색 위주 작업의 경우 이야기입니다. (출처: jwhy-study.tistory.com, 2026.03)

반면, 에이전트 오케스트레이션 도구(oh-my-opencode, Google Antigravity 등)와 Gemini CLI를 함께 쓰면 상황이 달라집니다. 오케스트레이터가 내부적으로 Planning과 Execution을 별개의 모델 호출로 처리하기 때문에 하나의 작업이 실제로는 수십 회의 요청을 발생시킵니다.

한도 관리 팁 하나. /compress 명령어로 컨텍스트를 압축하거나 /clear로 컨텍스트를 리셋하면 불필요한 반복 호출을 줄일 수 있습니다. 긴 세션에서는 컨텍스트 누적으로 인한 중복 토큰 소비가 생각보다 큽니다.

▲ 목차로 돌아가기

자주 나오는 질문들

▲ 목차로 돌아가기

마치며 — 결론부터 말씀드리면

Gemini CLI는 개인 개발 용도라면 분명히 괜찮은 선택입니다. 다만 “무료 1,000회”라는 숫자 하나만 보고 시작했다가 예상치 못한 과금을 만나거나, 내 코드가 어디에 쓰이는지 모르고 쓰는 경우가 생길 수 있습니다.

직접 확인한 핵심 세 가지. 첫째, 인증 방식에 따라 무료 한도가 4배 차이납니다. OAuth는 1,000회, API Key는 250회입니다. 둘째, API Key에 결제 계정이 연결돼 있으면 한도 초과 시 과금이 자동으로 시작됩니다. 셋째, 개인 Gmail OAuth 무료 사용은 데이터 수집 조건이 붙습니다.

개인 사이드 프로젝트라면 OAuth 무료로 시작하는 것이 가장 합리적입니다. 한도가 자주 걸린다면 /compress와 /clear로 컨텍스트를 관리하고, 그래도 부족하면 유료 플랜을 검토하는 순서가 맞습니다. API Key는 특정 모델을 직접 지정해야 하거나 프로덕션 통합이 필요할 때 선택하되, 반드시 결제 계정 연결 여부와 비용 한도 설정을 먼저 확인하세요.

▲ 목차로 돌아가기

1. Google Developers — Gemini Code Assist Quotas and System Limits (공식)
2. Gemini CLI 공식 문서 — Quota and Pricing
3. Google Codelabs — Gemini CLI 실습 공식 가이드
4. Google AI for Developers — Gemini API 비율 제한 공식 문서