Gemini CLI 할당량: 현재 어디에서 오며 한도에 도달했을 때 할 일

Gemini CLI의 현재 할당량은 유료 이용 관계에서 비롯됩니다. Google이 Standard에는 사용자당 하루 요청 1,500건, Enterprise에는 2,000건으로 제한하는 Gemini Code Assist 라이선스 또는 종량제 키(Gemini API 키나 Gemini Enterprise Agent Platform 키)입니다. 종량제 키의 경우 Google의 요청 처리량 제한 페이지에는 일일 요청 수가 전혀 게시되어 있지 않으며, 모델별 한도는 AI Studio 내부에서 확인해야 합니다. 대부분의 답변이 여전히 인용하는 이용 방식인 무료 등급, Google AI Pro 또는 Google AI Ultra에서 개인 Google 계정으로 로그인하는 방식은 2026년 6월 18일에 Gemini CLI에 대한 서비스 제공이 중단되었습니다.

이 날짜 때문에 이 질문은 보기보다 어렵습니다. 2026년 9월 21일 main 브랜치에서 가져온 Google 자체 저장소 README에는 여전히 "무료 등급: 개인 Google 계정으로 분당 60건, 하루 1,000건의 요청"이라고 안내되어 있습니다. 이는 아직 누구도 수정하지 않은 오류이며, 대부분의 제3자 문서가 복사하는 수치입니다.

현재 Gemini CLI 할당량의 출처

두 개의 Google 공식 페이지가 중단 시점을 확정합니다. Google의 2026년 5월 19일 발표: "2026년 6월 18일부터 Gemini CLI와 Gemini Code Assist IDE 확장 프로그램은 Google AI Pro 및 Ultra 사용자와 Gemini Code Assist 개인용을 통해 무료로 사용하는 사용자에 대한 요청 처리를 중단합니다." 또한 자체 바닥글에 최종 업데이트 날짜가 2026-09-02로 표시된 지원 중단 페이지에는 다음과 같이 나와 있습니다. "이는 Gemini CLI 사용에도 적용됩니다. 지원 중단의 일환으로 더 이상 Google로 로그인 옵션을 사용하여 IDE 확장 프로그램이나 Gemini CLI에 액세스할 수 없습니다." 해당 페이지의 FAQ는 Standard/Enterprise에 관한 질문에도 직접 답합니다. 이러한 구독은 영향을 받지 않습니다.

실시간 수치는 Google의 Code Assist 할당량 페이지(최종 업데이트 2026-09-18)에서 가져온 것이며, 수치보다 작동 방식이 더 중요합니다. 에이전트 모드와 Gemini CLI의 할당량은 통합되어 있고, 하나의 프롬프트가 여러 모델 요청을 생성할 수 있습니다. 일일 한도는 "모든 모델 버전 또는 제품군과의 모든 상호작용에 걸쳐 집계"되며, 최대치에 도달하면 "할당량이 재설정될 때까지 이러한 인터페이스를 통해 어떤 모델에도 추가 요청을 보낼 수 없습니다". 따라서 더 작은 모델로 전환해도 이 경로에서 사용할 수 있는 여유가 늘어나지 않으며, 1,500이라는 수치는 프롬프트 1,500개를 뜻하지 않습니다. Google은 재설정 시점이 언제인지 밝히지 않습니다. 읽어 보셨을 수 있는 태평양 시간 자정 규칙은 Gemini API에 대해 문서화된 것이며 라이선스 경로에는 해당하지 않으므로, 이를 그대로 적용하는 것은 추측입니다.

같은 페이지에는 또 하나의 함정이 있습니다. '초당 2건 요청', 일일 6,000건 및 일일 960건 행은 코드 완성 및 Cloud Assist 패널 채팅을 위한 Gemini for Google Cloud 할당량입니다. 이는 CLI의 에이전트 모드 예산이 아니므로, 두 수치가 모두 실제 수치라 해도 하나를 가져와 적용하면 잘못된 것입니다.

잘못된 수치를 제공하는 네 개의 Google 공식 페이지

geminicli.com은 무단 점유 사이트가 아닙니다. 저장소가 자체적으로 선언한 홈페이지이므로 오히려 위험합니다. 비공식 사이트가 아니라 오래된 정보로 취급해 폐기해야 합니다. 현재 배너는 본문 내용과도 모순됩니다. "무료 등급 사용자 및 Google One 사용자: Gemini CLI는 2026년 6월 18일 Antigravity CLI로 대체되었습니다." 배너와 표의 내용이 다르면 배너와 날짜가 표시된 지원 중단 페이지가 더 최신 정보입니다.

공식 페이지 어디에도 답이 없는 질문이 하나 있습니다. API 키를 사용하는 경로에 대해 Google의 5월 19일 블로그는 유료 API 키로 CLI에 계속 접근할 수 있다고 설명합니다. 유지관리자들의 6월 18일 종료 공지는 "Gemini Code Assist 라이선스를 보유하고 API 키 인증을 사용하는 기업 사용자는 전혀 영향을 받지 않습니다"라는 내용만 덧붙입니다. 이 문장의 주어는 기업 사용자이므로, 무료 키가 여전히 작동한다는 설명은 아닙니다. 6월 18일 이후 날짜의 자료 중 무료 키를 다루는 것은 없으며, 무료 사용 시 하루 250회 요청이라는 수치는 업데이트가 중단된 할당량 문서에만 남아 있습니다. 무료 키는 사용 예산의 근거로 삼기보다 검증되지 않은 것으로 취급하세요.

나는 어떤 경로를 사용 중이며, 한도는 어떻게 표시되나요?

변경하기 전에 결제 관계를 확인하세요. Gemini CLI 문서에서는 /auth를 "인증 방법을 변경할 수 있는 대화 상자"로 설명하고, /stats model는 "토큰 수와 할당량 정보를 포함한 모델별 사용 통계"를 표시한다고 설명합니다. 할당량 문서에는 세션 종료 시 사용량 요약도 표시된다고 나와 있습니다. 두 기능 모두 2026년 9월 21일에 확인한 문서화된 동작이며, 여기서 테스트한 동작이 아닙니다.

서로 다른 두 가지 실패가 비슷한 중단을 일으키지만 해결 방법은 다릅니다. 할당량 초과는 다음과 같은 선택지를 제공하는 것으로 문서화되어 있습니다. "해당 한도에 도달하면 Gemini 2.5 Pro로 전환하거나, 더 높은 한도로 업그레이드하거나, 중지할 수 있는 옵션이 제공됩니다. 사용량 한도가 언제 재설정되는지도 안내됩니다." 또한 2.5 Pro 한도에 도달하면 Gemini 2.5 Flash로 대체할지 묻는 추가 프롬프트가 표시됩니다. 용량 오류는 대신 모델 과부하입니다. 문서에 따르면 CLI는 Gemini 3 Pro를 계속 시도할지 또는 Gemini 2.5 Pro로 대체할지 묻고, "계속 시도"는 지수 백오프를 사용합니다. 두 번째 문제는 기다리면 해결되지만, 첫 번째 문제는 재설정, 라이선스 또는 다른 결제 경로가 있어야 해결됩니다.

질문 없이 발생하는 대체 동작도 있습니다. 문서에 따르면 CLI가 기본 "pro" 모델에서 비율 제한을 감지하면 "현재 세션에서 자동으로 'flash' 모델로 전환"하며, gemini-2.5-flash-lite를 사용하는 내부 유틸리티 호출은 할당량이 소진될 때 구성된 모델을 변경하지 않고 다른 모델로 "조용히 대체"됩니다. 종량제 키에서는 이것이 출력뿐 아니라 청구 금액에도 영향을 줍니다. 응답한 모델이 항상 선택한 모델인 것은 아닙니다.

한도에 도달했을 때의 네 가지 선택지와 각각의 비용

Google Cloud 가격표의 자체 헤더는 "Gemini 라이선스 유형 / 라이선스 비용(월 약정) / 라이선스 비용(12개월 약정)"이며 수치 옆에 "사용자당"이라는 문구를 표시하지 않습니다. 할당량은 명시적으로 사용자당 일일 기준이므로, 주문 조건에서 좌석 약관을 확인하기 전까지 요금을 라이선스당으로 해석하세요.

첫 번째 선택지: 기다리기. 중단이 할당량 초과가 아니라 용량 오류일 때 무료이며 올바른 방법입니다. 두 번째 선택지: 라이선스 구매. 로그인 경로에서 일일 요청 허용량을 늘리는 유일한 방법이며 Google이 Gemini CLI에 대해 문서화한 방법입니다. 세 번째 선택지: 종량제 키로 전환. 일일 요청 한도를 없애고 토큰당 청구와 지출 한도로 대체합니다. Google의 요청 처리량 제한 페이지에는 Tier 1~3에 대해 10분 이동 구간당 각각 $10, $50, $200의 지출 기반 한도가 게시되어 있으며, 초과 시 429 RESOURCE_EXHAUSTED를 반환합니다. 또한 한도는 "보장되지 않는다"고 명시하고, 모델별 수치는 AI Studio에서만 볼 수 있다고 설명합니다. 결제 페이지(최종 업데이트 2026-09-20)에는 Gemini API 사용량에 대해 Postpay에서 Prepay로 전환되었으며 최소 크레딧 구매 금액이 $5라는 내용도 기록되어 있습니다. 동일한 선택지의 Agent Platform 버전에는 자체 무료 기간이 있습니다. Express 모드(최종 업데이트 2026-09-18)를 사용하면 신규 Google Cloud 사용자가 결제 정보를 제공하지 않고 최대 90일 동안 사용해 볼 수 있으며, 기존 Cloud 사용자 또는 결제가 활성화된 경우 90일 무료 등급이 제거된다고 명시되어 있습니다.

네 번째 선택지: 클라이언트 변경. Google이 자체적으로 권장하는 것은 Antigravity CLI이며, 이를 선택하기 전에 유연성 측면의 비용을 알아둘 필요가 있습니다. Antigravity의 요금제 문서에는 "현재 지원하지 않는 기능: 요청 처리량 한도를 추가로 확보하기 위한 자체 키 또는 자체 엔드포인트 사용"이라고 나와 있습니다. AI Pro 또는 Ultra를 사용하지 않는 사용자에게는 "매주 갱신되는 의미 있는 할당량"과 "주간 요청 처리량 한도"만 약속되며, 해당 페이지에는 수치가 표시되어 있지 않습니다. 유료 할당량은 "5시간마다 갱신"되고, Pro에서는 "주간 한도에 도달할 때까지" 갱신됩니다. Google은 이러한 한도가 프롬프트 수가 아니라 "에이전트가 수행한 작업량과 상관관계가 있다"고 설명합니다. 이 페이지를 위해 Antigravity CLI 바이너리를 설치하지 않았으며, 속도나 호환성 비교도 주장하지 않습니다.

Gemini CLI 할당량을 늘리지 않는 것은 Google AI Plus 구독(월 $4.99) 또는 Google AI Pro 구독(월 $19.99)입니다(gemini.google/subscriptions, 2026년 9월 21일 확인). 2026년 6월 18일부터 이러한 구독은 Gemini 앱 및 Antigravity 한도를 제공합니다. $100 및 $200 AI Ultra 등급은 구독 페이지가 아니라 Google의 2026년 5월 19일 발표에서 가져온 것이며, 동일한 주의사항이 적용됩니다.

사용자 지정 엔드포인트가 할 수 있는 일과 할 수 없는 일

Gemini CLI는 기본 URL 재정의를 문서화하고 있지만, 그 범위는 보이는 것보다 좁습니다. GOOGLE_GEMINI_BASE_URL는 "gemini-api-key 인증을 사용할 때" Gemini API 요청의 기본 URL을 재정의하며, localhost를 가리키는 경우를 제외하고 HTTPS여야 합니다. 또한 Vertex 경로를 위한 별도 변수인 GOOGLE_VERTEX_BASE_URL가 있습니다. Google은 이후 Vertex의 명칭을 Gemini Enterprise Agent Platform으로 변경했지만 CLI는 이전 변수 이름을 유지했습니다. 릴리스된 v0.60.0 소스에서는 해당 변수만 설정하면 공개 문서 어디에도 나타나지 않는 인증 유형(GATEWAY = 'gateway')이 선택되고, 그 키는 빈 문자열로 대체됩니다. 이는 지원되는 기능이 아니라 코드로 해석해야 하며, 변경 로그 없이 바뀔 수 있습니다.

이 문제는 할당량에 관한 답변인지 여부를 결정하는 세 가지 경계를 따릅니다. 기본 URL은 httpOptions.baseUrl로 GoogleGenAI SDK에 전달되므로 모든 요청은 여전히 Google 네이티브 프로토콜을 사용하고, 기본적으로 x-goog-api-key 헤더로 인증됩니다. 인증 열거형에는 OpenAI 호환 또는 Anthropic 제공업체가 없습니다. Kunavo의 API는 OpenAI 호환 및 Anthropic Messages만 지원합니다. 이 커밋의 경로 목록에는 /v1/chat/completions, /v1/responses 및 /v1/messages가 있으며 Gemini 네이티브 generateContent 경로는 없습니다. 따라서 해당 변수에 바로 연결할 수 없으며, 이 페이지에서 그 반대의 내용을 안내해서는 안 됩니다. 이는 런타임 테스트가 아니라 프로토콜 형태와 경로 목록에서 도출한 추론입니다. 또한 재정의는 API 키 경로에만 존재하므로 어떤 게이트웨이를 가리켜도 Google 측 일일 허용량을 늘리거나 연장하거나 재설정하지 않습니다. 대신 다른 결제 관계로 전환하며, 이후 할당량은 해당 계정의 할당량이 됩니다.

따라서 Kunavo를 사용하는 정직한 방법은 엔드포인트가 아니라 클라이언트를 변경하는 것입니다. Gemini CLI와 Claude Code 비교에서는 두 에이전트를 비교하고, Gemini API 키 문서에서는 OpenAI 호환 경로로 Gemini 모델에 액세스하는 방법을 설명합니다. Kunavo는 이러한 클라이언트 중 어느 것도 해당 엔드포인트에서 런타임 테스트하지 않았습니다. 게시된 설정 가이드는 구성 참고 자료이지 호환성 테스트가 아닙니다.

클라이언트를 변경할 때의 계산 예시

이는 측정된 작업 비용이나 청구 상한이 아닌, 토큰 산술을 설명하기 위한 예시입니다. 하나의 에이전트 세션이 캐시되지 않은 입력 토큰 300,000개를 보내고 출력 토큰 20,000개를 받는다고 가정합니다. 요금은 100만 토큰당 Kunavo 카탈로그의 현재 가격이며, 위 표의 Google 정가와 비교하세요.

두 세계의 단위를 서로 환산하려 하지 마세요. Code Assist 라이선스는 사용자당 일일 요청 수를 기준으로 계산하고, 토큰 키는 토큰을 기준으로 계산합니다. Google 자체도 하나의 프롬프트가 여러 모델 요청을 생성할 수 있다고 설명하므로 월 $22.80과 세션당 수치 사이에는 환산 비율이 없습니다. 유일하게 정직한 비교 방법은 동일하게 범위를 제한한 작업을 양쪽에서 실행하고 각 계정의 자체 기록을 확인하는 것입니다. Kunavo 카탈로그 금액은 상한이 아니라 청구 하한입니다. 업스트림에서 비용을 보고하면 청구 금액은 카탈로그 비용과 업스트림 비용에 해당 마크업을 적용한 금액 중 더 큰 금액입니다. 캐시 요금과 외부 도구는 이 예시에 포함되지 않으며, 최소 충전 금액은 선불 크레딧 $10 입니다. 이는 작업 요금이나 구독료가 아니라 자금 충전 최소 금액입니다. 결제 세부 정보를 참조하세요.

어떤 경우에 어떤 경로가 적합한가

작업을 다른 Google 요금제가 아니라 다른 에이전트로 옮기는 경우, OpenCode 통합 또는 Cline 설정부터 시작하고, 모델 카탈로그에서 요금을 비교한 다음, 키에 자금을 충전할 준비가 되면 Kunavo 계정을 만드세요. Gemini의 전체적인 가격 정보는 Gemini API 가격을, 다른 에이전트에서 동일한 무료 등급 소멸 문제를 확인하려면 Codex 사용량 한도를 참조하세요.

자주 묻는 질문

2026년 9월 21일 확인: Google의 지원 종료 공지, Code Assist 할당량 페이지, Google Cloud 가격표, Gemini API 가격·청구·속도 제한 페이지, geminicli.com 문서 모음과 할당량 페이지, Antigravity 요금제 페이지, 저장소 README, GitHub 저장소 API 및 npm 레지스트리(안정 버전 0.60.0, 2026-09-15 게시)를 확인했습니다. 확인하지 않은 항목: Gemini CLI 또는 Antigravity CLI 바이너리는 설치되어 있지 않았고, Google 계정에도 로그인하지 않았으며, CLI를 가리키는 프록시도 설정하지 않았습니다. 프로토콜 경계는 릴리스된 v0.60.0 소스와 Kunavo 자체 경로 목록에서 확인했습니다. Kunavo 토큰 요금은 실시간 카탈로그에서 가져왔으며, 여기의 모든 달러 금액은 예시 토큰 산술입니다.