Gemini CLI 무료 1000회,
이 방법이면 250회입니다

“구글 계정만 있으면 하루 1,000회 무료”라는 말은 절반의 사실입니다. 로그인 방법을 어떻게 선택하느냐에 따라 한도가 최대 4배까지 줄어드는 구조가 공식 문서에 명시되어 있습니다. Pro 구독을 해도 예고 없이 막히는 이유까지, 아래에 전부 정리했습니다.

“1,000회 무료”의 조건, 아무도 안 알려주는 부분

Gemini CLI를 처음 소개하는 대부분의 글은 “하루 1,000회, 분당 60회 무료”라는 수치만 강조합니다. 그런데 이 숫자에는 전제 조건이 하나 있습니다. Google 계정으로 직접 로그인(Sign in with Google)했을 때의 한도라는 것입니다. 공식 문서(Gemini CLI Quota and Pricing, 2026.04 기준)에 따르면, 인증 방식은 크게 세 가지로 나뉘고, 방식마다 한도가 완전히 다릅니다.

AI Studio에서 API키를 발급받아 GEMINI_API_KEY 환경변수로 설치하는 경우, 무료 한도는 하루 250회로 떨어지고, 모델도 Flash 계열만 사용 가능합니다(Pro 모델 불가). Google 계정 로그인 방식의 1,000회와 단순 비교하면 4분의 1 수준입니다.

▲ 목차로 돌아가기

API키로 설치하면 왜 250회로 줄어드는가

API키 인증과 Google 계정 로그인은 같은 Gemini CLI를 쓰는 것처럼 보이지만, 내부적으로 완전히 다른 할당량 풀(pool)을 사용합니다. Google 계정으로 로그인하면 Gemini Code Assist for individuals 정책이 적용되어 하루 1,000회 한도를 씁니다. 반면 API키 인증은 Gemini API 무료 티어 정책을 따르기 때문에 한도가 250회이고, 사용 가능한 모델도 Flash로 제한됩니다.

숫자로 표현하면 아래와 같습니다.

(출처: Gemini CLI Quota and Pricing, github.com/google-gemini/gemini-cli/blob/main/docs/resources/quota-and-pricing.md, 2026.04 기준)

▲ 목차로 돌아가기

Pro 구독해도 막히는 이유가 따로 있습니다

Google AI Pro 구독자라면 하루 1,500회 한도를 기대합니다. 그런데 실제로는 그 이전에 막히는 경우가 빈번합니다. 2026년 4월 15일, Reddit 커뮤니티 r/GeminiAI에는 “프롬프트 10개도 안 썼는데 한도에 걸렸다”는 제목의 글이 올라와 120개의 추천을 받았습니다(게시글 upvote 비율 89%). 댓글에는 “매일 겪는다”는 반응이 줄을 이었습니다.

공식 문서(Gemini Code Assist Quotas, developers.google.com, 2026.04 기준)에 이런 문구가 있습니다.

“Requests are limited per user per minute and are subject to the availability of the service in times of high demand.”

서비스 과부하가 발생하면 명시된 한도와 무관하게 요청이 제한됩니다. 즉, 동일 시간대에 Gemini CLI 사용자가 급증하면 내 구독 등급과 상관없이 처리가 지연되거나 거절될 수 있습니다. 구독 등급은 최대 한도의 우선순위를 결정하지, 100% 보장된 처리량을 의미하지 않습니다.

에이전트 모드에서는 상황이 더 복잡해집니다. “프롬프트 1회”처럼 보여도 내부적으로 모델 요청이 여러 번 발생합니다. 예를 들어 파일을 검색하고, 읽고, 수정안을 제안하는 단일 작업이 내부에서는 3~7회의 모델 호출로 처리될 수 있습니다. 하루 1,000회처럼 보이는 한도가 실제 체감 작업 수로는 100~300건에 불과한 이유입니다.

▲ 목차로 돌아가기

인증 방식별 실제 한도 한눈에 비교

여기서부터가 핵심입니다. 자신의 사용 패턴이 어느 구간에 해당하는지 확인해보시기 바랍니다.

(출처: Gemini Code Assist Quotas, developers.google.com/gemini-code-assist/resources/quotas, 2026.04 기준)

한 가지 더 확인해야 할 점이 있습니다. Google AI Pro는 현재 개인 Gmail 계정(@gmail.com)에만 구독이 열려 있습니다. 회사나 학교에서 발급받은 Workspace 계정(@company.com)으로는 Pro 구독을 신청할 수 없고, 대신 조직 차원의 Code Assist Standard/Enterprise를 구매해야 합니다. 이 부분은 Jules 공식 플랜 문서에도 동일하게 적용됩니다.

▲ 목차로 돌아가기

한도를 가장 오래 쓸 수 있는 인증 방법 선택 기준

단순하게 정리하면 이렇습니다. 개인 Gmail 계정이 있고, 무료로 시작하고 싶다면 반드시 Google 계정 로그인을 선택해야 합니다. API키 방식은 비개발자나 자동화 파이프라인처럼 로그인 세션을 유지하기 어려운 환경에 사용하는 것이 목적에 맞습니다.

하루 1,000회라는 숫자를 실제 코딩 작업 건수로 환산해보면, 에이전트 모드 기준 파일 읽기·수정·검증까지 포함할 때 약 100~200건의 실질적인 작업에 해당한다고 봐야 합니다. 하루 8시간 개발자 기준으로 시간당 약 12~25건의 작업이 가능한 셈입니다. 이 속도면 취미 개발자나 학생에게는 충분하지만, 복잡한 리팩토링을 반복하는 헤비 유저라면 유료 플랜을 고려할 필요가 있습니다.

한도를 확인하고 싶을 때는 CLI를 실행한 상태에서 /stats model 명령어를 입력하면 현재 세션의 토큰 사용량과 남은 한도 정보를 실시간으로 볼 수 있습니다(공식 문서 Command Reference 기준).

▲ 목차로 돌아가기

Jules와 함께 쓰면 달라지는 점

Gemini CLI와 함께 자주 언급되는 도구가 구글의 자율 코딩 에이전트 Jules입니다. Jules는 Gemini CLI와 한도 구조가 완전히 다릅니다. 요청 수가 아닌 작업(Task) 건수로 한도를 관리합니다. 공식 플랜 페이지(jules.google/docs/usage-limits, 2026.04 기준)에 따른 수치는 아래와 같습니다.

(출처: jules.google/docs/usage-limits, 2026.04 기준)

무료 플랜에서 하루 15건이라는 숫자는 처음엔 적어 보일 수 있습니다. 그런데 Jules의 작업 1건은 GitHub 리포지토리 클론부터 파일 수정, 테스트 실행까지 전체 플로우를 포함하는 단위입니다. 이걸 Gemini CLI 요청 수로 환산하면 수십 회에 해당합니다. 체감 작업 밀도는 Gemini CLI의 명시적 한도보다 Jules 쪽이 오히려 넉넉하게 느껴질 수 있습니다.

▲ 목차로 돌아가기

자주 묻는 질문

▲ 목차로 돌아가기

마치며

Gemini CLI의 “하루 1,000회 무료”라는 수치는 정확하지만, 그 조건이 까다롭게 숨어 있습니다. Google 계정 로그인 방식을 선택해야 1,000회가 적용되고, 많은 설치 가이드가 안내하는 API키 방식을 따라가면 250회로 즉시 줄어듭니다. 4배 차이가 납니다.

Pro 구독을 하더라도 서비스 과부하 시 동적 throttle이 걸린다는 점, 에이전트 모드에서 프롬프트 1회가 내부 다중 호출로 처리된다는 점도 실제 체감 한도를 크게 줄이는 요인입니다. 이 두 가지는 공식 문서에 적시되어 있으나 주요 블로그 포스팅에서 거의 다뤄지지 않았습니다.

솔직히 말하면, 구글의 무료 정책 자체는 경쟁사 대비 여전히 관대한 편입니다. 다만 그 관대함이 “어떤 방법으로 쓰느냐”에 따라 크게 달라진다는 점을 알고 시작하는 것과 모르고 시작하는 것은 경험 차이가 꽤 납니다.

1. Gemini CLI Quota and Pricing (공식) — github.com/google-gemini/gemini-cli
2. Gemini Code Assist Quotas (공식) — developers.google.com
3. Jules Plans & Usage Limits (공식) — jules.google/docs
4. Gemini CLI Authentication Guide (공식) — github.com/google-gemini/gemini-cli
5. Google Blog — Jules 공개 베타 발표 (2025.05.20) — blog.google