Gemini CLI 429 "No capacity available"

429 는 같은 번호로 두 가지 일이 올 수 있습니다. 내 한도가 찬 것과 서버에 자리가 없는 것이고, 조치가 다릅니다.

[1] 오류 문구를 찾습니다. 아래 두 문구가 이슈와 포럼에 실제로 올라온 원문입니다.

용량 쪽 포럼 글의 로그에는 상태 RESOURCE_EXHAUSTED 와 이유 MODEL_CAPACITY_EXHAUSTED 가 함께 찍혀 있습니다(보고 버전 v0.35.3). 한도 쪽 이슈에는 Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 50 처럼 어느 지표가 찼는지가 적힙니다.

[2] 화면에 뜬 안내문으로 한 번 더 가립니다. 0.64.0 코드에서 두 경우의 문구가 다릅니다.

We are currently experiencing high demand for all Pro models.We apologize and appreciate your patience./model to switch models.

위는 용량 부족이고, 아래는 한도 도달입니다.

Usage limit reached for all Pro models.Access resets at <시각>./stats model for usage details/model to switch models./auth to switch to API key.

[3] 한도 초과이면 사용량부터 봅니다. 세션 안에서 아래를 실행하면 모델별 토큰 사용량과 한도가 나옵니다(문서).

/stats model

공식 표의 일일 한도는 이렇습니다.

일일 한도(quota ID 에 PerDay·Daily 가 들어간 경우)에 걸리면 CLI 는 You have exhausted your daily quota on this model. 로 보고 자동 재시도를 하지 않습니다. 초기화 시각까지 기다리거나 [4]·[5] 로 갑니다.

[4] 모델을 바꿉니다. 세션 안에서는 /model 입니다. 처음부터 지정하려면 -m 옵션을, 고정하려면 ~/.gemini/settings.json 의 model.name 을 씁니다.

$ gemini -m gemini-2.5-flash

{  "model": { "name": "gemini-2.5-flash" }}

용량 부족 대화상자에는 Keep trying · Switch to <대체 모델> · Stop 세 선택지가 나옵니다. 용량은 모델별로 차므로 Pro 가 막혔다면 Flash 쪽이 열려 있을 수 있습니다.

[5] 한도가 문제이고 Google 로그인을 쓰고 있다면 API 키로 바꿉니다. 안내문의 /auth 가 그 메뉴입니다. 공식 문서는 중단 없는 사용을 보장하는 유일한 방법으로 API 키를 듭니다. 다만 [1] 의 이슈처럼 API 키에도 한도 오류는 납니다. 결제 계정을 프로젝트에 연결하자 풀렸다는 사용자 보고가 있습니다(공식 확인은 아님).

[6] 재시도 간격을 정합니다. 서버가 재시도 시간을 알려 줄 때(예: Please retry in 15.002899939s.) CLI 는 0.64.0 코드에서 300초 이하면 기다렸다 다시 시도하고, 300초를 넘으면 바로 멈춥니다. 용량 부족(MODEL_CAPACITY_EXHAUSTED)은 시간과 관계없이 자동 재시도하지 않고 위 선택지를 띄웁니다.

• 분당 한도: 15~60초 뒤 다시 시도합니다.
• 용량 부족: Keep trying 을 몇 번 눌러 보고, 계속되면 [4] 로 모델을 바꿉니다. 포럼 글에는 수 주간 이어졌다는 보고도 있고 해결 확인은 없습니다.
• 일일 한도: 안내된 초기화 시각 이후에 다시 합니다.

비대화형 -p 실행은 대화상자가 없으므로 스크립트 쪽에서 -m 으로 모델을 정해 두고, 실패하면 간격을 두고 다시 호출하게 짭니다.