“하루 1,000회 무료”라는 숫자 뒤에 숨은 조건들이 있습니다. 구글 공식 문서와 실사용 기록을 교차해서 확인했더니, 알고 쓰는 것과 모르고 쓰는 것의 차이가 꽤 컸습니다.
Google OAuth 무료 1,000회/일
API Key 무료는 Flash만 250회/일
컨텍스트 윈도우 100만 토큰
Gemini CLI가 뭔지부터 짚고 넘어가야 합니다
설치는 Node.js가 설치된 환경에서 npm install -g @google/gemini-cli 한 줄로 끝납니다. 이후 gemini를 실행하면 구글 계정 로그인(OAuth) 또는 API 키 입력 방식을 선택할 수 있습니다. 여기서 어떤 방식을 선택하느냐에 따라 무료 한도가 크게 달라집니다 — 이건 뒤에서 자세히 다루겠습니다.
Gemini 3.1 Pro가 CLI에 들어왔습니다 — 뭐가 달라졌을까요
구글은 2026년 2월 19일 Gemini 3.1 Pro를 공식 발표했습니다. (출처: Google 공식 블로그, 2026.02.19) 이 모델은 Gemini 3 시리즈의 핵심 추론 엔진을 개선한 버전으로, 가장 눈에 띄는 수치는 ARC-AGI-2 벤치마크 77.1%입니다. ARC-AGI-2는 AI가 완전히 새로운 논리 패턴을 얼마나 잘 풀어내는지를 측정하는 벤치마크로, 전작인 Gemini 3 Pro의 31.1%에서 정확히 2.5배 뛰어오른 수치입니다. 즉, 3개월 만에 추론 성능이 2배 이상 향상된 셈입니다.
💡 공식 발표문과 실제 벤치마크 수치를 같이 놓고 보니 이런 차이가 보였습니다: 3.1 Pro는 Gemini 3 Pro(31.1%)에서 3.1 Pro(77.1%)로 올라갔지만, Gemini 앱의 무료 사용자에게 지급되는 하루 프롬프트 수는 Gemini 3 Pro 기준으로 공식 지원 문서에 “기본 액세스”로만 표기되어 있고 구체적인 숫자가 공시되지 않습니다. 반면 CLI에서의 무료 한도는 구체적인 숫자(1,000회/일)로 공개되어 있습니다. Gemini 앱 무료 사용자와 Gemini CLI 무료 사용자는 사실상 다른 조건으로 사용하는 겁니다.
(출처: Google Gemini 앱 한도 공식 지원 문서, support.google.com/gemini/answer/16275805)
무료 1,000회, 정말 1,000회 다 쓸 수 있을까요
Google OAuth(구글 계정 로그인)로 Gemini CLI를 인증하면 하루에 최대 1,000회 모델 요청이 가능합니다. 분당 60회 한도도 있습니다. 이건 Gemini CLI 공식 문서(geminicli.com/docs)에 명시된 수치입니다.
그런데 막상 써보면 이 단계에서 멈춥니다. 1,000회라는 숫자는 “모델 요청 횟수”인데, 코딩 에이전트 작업 특성상 하나의 작업 지시에도 내부적으로 파일 읽기, 코드 수정, 검증 등 여러 번의 모델 요청이 발생합니다. Reddit r/GeminiCLI 커뮤니티(2026.03.09)에 올라온 실사용 후기에 따르면, 복잡한 분석 요청 한 건이 하루 할당량의 3~5%를 소진한다고 합니다. 그 계산대로면 하루에 20~30번 요청하면 한도에 도달할 수 있다는 뜻입니다. 즉, 숫자는 1,000이지만 실제로 사용할 수 있는 “대화 턴” 수는 이보다 훨씬 적을 수 있습니다.
💡 공식 문서와 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다: 무료 1,000회를 소진하면 Gemini CLI는 자동으로 Gemini 2.5 Pro → Gemini 2.5 Flash 순서로 다운그레이드됩니다. 즉 처음에는 3.1 Pro로 시작하지만, 어느 시점부터 응답 품질이 조용히 내려갑니다. 터미널에서는 현재 어떤 모델이 동작 중인지 /stats model 명령으로만 확인할 수 있습니다. 알림 없이 자동 전환되기 때문에 체감하지 못한 채 품질이 낮은 모델로 작업하게 되는 경우가 생깁니다.
(출처: Gemini CLI 공식 문서 Quota & Pricing, geminicli.com/docs/resources/quota-and-pricing/; Shipyard.build Claude Code vs Gemini CLI 비교, 2026.01.15)
현재 사용 중인 모델과 토큰 사용량을 확인하려면 Gemini CLI 세션 내에서 /stats model 명령을 입력하면 됩니다. 세션 종료 시에도 요약 통계가 자동으로 표시됩니다. 작업 중간에 주기적으로 확인하는 습관을 들이는 게 좋습니다.
로그인 방법 하나로 무료 한도가 4배 차이 납니다
| 인증 방식 | 일일 요청 한도 | 사용 가능 모델 | 비고 |
|---|---|---|---|
| Google 계정 OAuth (권장) |
1,000회/일 분당 60회 |
Gemini 3.1 Pro 포함 전체 모델 패밀리 |
입력·출력 데이터 수집 동의 포함 |
| Gemini API Key (무료 미결제) |
250회/일 분당 10회 |
Flash 모델만 가능 | 3.1 Pro 사용 불가 |
| Vertex AI Express Mode | 90일간 무료 이후 결제 필요 |
계정별 상이 | 엔터프라이즈 용도 |
출처: Gemini CLI 공식 문서 Quota & Pricing (geminicli.com/docs/resources/quota-and-pricing/, 2026.03 기준)
결론부터 말씀드리면, 무료로 Gemini 3.1 Pro를 포함한 전체 모델 패밀리를 쓰려면 반드시 Google 계정으로 OAuth 로그인을 해야 합니다. API Key 방식으로 연결하면 Flash 모델만 사용 가능하고 한도도 250회로 줄어들어, 같은 “무료”라도 실사용 경험이 전혀 다릅니다. 처음 설치할 때 이 선택 화면을 그냥 지나쳤다면, 지금이라도 gemini auth login으로 OAuth 인증으로 전환하는 게 낫습니다.
참고로 Google AI Pro(월 29,000원, 한국 기준) 구독자라면 하루 1,500회, Ultra(월 180,000원 상당) 구독자는 하루 2,000회까지 사용할 수 있습니다. 이 경우 모델도 더 안정적으로 유지됩니다. (출처: Gemini CLI 공식 문서 동일)
Claude Code와 어떻게 다를까요 — 공식 수치 기준으로 봤습니다
💡 벤치마크 수치만 보면 Gemini 3.1 Pro가 우위지만, 실제 코딩 에이전트로 쓸 때 기대와 달랐던 부분이 있습니다. JetBrains의 AI 디렉터는 “3.1 Pro가 더 강력하고 빠르며 더 적은 출력 토큰으로 신뢰할 수 있는 결과를 낸다”고 평가했지만 (출처: Google Cloud 공식 블로그, 2026.02.20), Shipyard.build의 Claude Code vs Gemini CLI 비교(2026.01.15)에 따르면 Gemini CLI는 에러 로그가 주어졌을 때 문제를 정확히 짚어내는 데 Claude Code보다 더 많은 컨텍스트가 필요했고, 일부 경우에서는 작업을 사용자에게 다시 돌려보내는 경향도 보였습니다. 즉 Gemini CLI는 정확한 지시를 줄 수 있는 경우에 더 빛나는 도구입니다.
(출처: Shipyard.build – Claude Code vs Gemini CLI, 2026.01.15)
가격 면에서의 차이도 있습니다. Gemini CLI의 Google OAuth 무료 플랜은 비용이 없지만, Claude Code의 진입 기준인 Claude Pro($20/월)는 Sonnet 모델 위주로 사용하면서 5시간 단위로 토큰이 초기화됩니다. 체감 용량 기준에서는 Gemini CLI 무료 플랜이 더 넉넉하게 느껴지는 경우가 많습니다. 다만 Claude Code Max($100~$200/월) 수준의 고용량 구독과 비교하면 이야기가 달라집니다.
컨텍스트 윈도우는 두 도구 모두 100만 토큰으로 같습니다. Gemini CLI는 대형 코드베이스 리팩토링에서 이 넓은 컨텍스트가 강점으로 작용한다는 실사용 후기가 많습니다. (출처: jwhy-study.tistory.com/144, 2026.03.04 — “8시간 이상 개발에 사용해도 제한에 걸리지 않을 정도로 쿼터가 넉넉하다”)
무료로 쓰면 데이터가 수집된다는 조항이 있습니다
이 부분이 기존에 다른 글들이 잘 짚지 않는 지점입니다. Gemini CLI 공식 문서(geminicli.com)에는 이런 문구가 있습니다: “Unlike Gemini’s paid tiers, the free tier will opt you into input and output collection, so use at your discretion.” 번역하면, 무료 티어는 입력·출력 데이터 수집에 자동으로 동의 처리되므로 사용 시 주의하라는 내용입니다. (출처: Gemini CLI 공식 문서 Quota & Pricing 섹션)
실질적인 의미는, 터미널에서 Gemini CLI를 통해 입력하는 코드와 프롬프트, 그리고 AI 응답이 구글의 학습 및 서비스 개선에 사용될 수 있다는 것입니다. 개인 프로젝트나 포트폴리오 작업이라면 큰 문제가 없을 수 있지만, 회사 코드베이스나 민감한 비즈니스 로직을 다루는 경우라면 반드시 유료 플랜으로 업그레이드하거나, API Key를 사용하는 Vertex AI 방식(유료)을 통해 데이터 수집 설정을 별도로 관리하는 편이 안전합니다.
⚠️ 정리: 구글 계정 무료 티어 → 데이터 수집 자동 동의 / Google AI Pro·Ultra 유료 플랜 → 데이터 수집 거부 가능 / API Key 유료 방식 → 약관에 따라 별도 설정.
업무 코드를 다루는 경우라면 무료 티어 사용 전 소속 조직의 정보보호 정책을 먼저 확인하는 것이 안전합니다.
자주 나오는 질문 5가지
마치며 — 무료가 맞긴 한데, 조건을 알고 써야 합니다
다만 몇 가지는 미리 알고 시작해야 합니다. OAuth 로그인과 API Key 로그인의 차이, 1,000회가 소진됐을 때 모델이 자동으로 바뀐다는 것, 무료 티어에서는 데이터 수집에 동의된다는 것. 이 세 가지만 알아도 Gemini CLI를 훨씬 더 잘 쓸 수 있습니다.
개인적으로는 Gemini CLI를 대형 코드베이스 탐색과 리팩토링에, Claude Code를 복잡한 디버깅에 병행해서 쓰는 방식이 지금 시점에서 가장 실용적이라고 생각합니다. 어느 한 도구만이 정답인 상황은 아직 아닙니다.
본 포스팅 참고 자료
- Google 공식 블로그 — Gemini 3.1 Pro 출시 발표 (2026.02.19)
- Google Cloud 공식 블로그 — Gemini 3.1 Pro on Gemini CLI, Vertex AI (2026.02.20)
- Gemini CLI 공식 문서 — Quota & Pricing (2026.03 기준)
- Google 공식 지원 문서 — Gemini 앱 한도 및 업그레이드 (2026.03 기준)
- Vertex AI 공식 문서 — Gemini 3.1 Pro 스펙 (2026.03.15 기준)
- Shipyard.build — Claude Code vs Gemini CLI 비교 (2026.01.15)
※ 본 포스팅은 2026년 3월 20일 기준 Gemini CLI 공식 문서와 Gemini 3.1 Pro Preview 출시 정보를 바탕으로 작성되었습니다. 본 포스팅 작성 이후 서비스 정책·UI·기능·무료 한도가 변경될 수 있습니다. 최신 정보는 Gemini CLI 공식 문서에서 확인하세요.
댓글 남기기