목적별 가이드

하려는 일 가이드
설치하고 첫 파일 작업 시작하기 Gemini CLI 첫 사용
로그인 실패나 429가 표시됨 실행·인증 오류 확인
한국 Google AI 구독 가격 확인하기 Gemini 요금제
API의 모델·토큰 단가 확인하기 AI 스튜디오·API 요금

현재 선택한 인증 경로부터 확인하기

같은 Google 계정이 있더라도 CLI에서 선택한 인증 방식에 따라 적용되는 조건은 달라집니다. CLI의 /auth는 인증 방법을 바꾸는 대화상자를 여는 명령입니다. 현재 로그인과 선택한 경로를 확인한 뒤 변경할지 판단하세요.

현재 경로 먼저 확인할 것
개인 Google 로그인 무료 Code Assist 개인용 또는 지원되는 Google AI 구독 계정
회사·학교 등 조직 로그인 배정된 라이선스·Cloud 프로젝트·관리자 조건
Gemini API 키 키가 속한 프로젝트·사용 모델·무료/유료 tier
Vertex AI 프로젝트·위치·API 활성화·해당 과금 조건

개인 Google 로그인은 대부분 별도 Cloud 프로젝트 없이 시작할 수 있지만 공식 문서에는 예외도 있습니다. 회사·학교·Workspace 계정, 특정 개발자 프로그램이나 Code Assist 라이선스는 프로젝트 설정이 필요할 수 있습니다.

Google 로그인 무료·구독 한도 읽기

CLI 공식 한도 문서는 다음과 같은 일일 최대 모델 요청 수를 안내합니다. 이는 사용자 질문 횟수나 특정 모델의 무조건적인 제공량을 뜻하지 않습니다.

개인 계정 경로 CLI 공식 문서의 일일 최대 모델 요청 수 함께 확인할 것
무료 Code Assist 개인용 1,000 제공 지역·계정 자격·현재 가용성
지원되는 Google AI Pro 1,500 구독 계정과 CLI 로그인 계정 일치
지원되는 Google AI Ultra 2,000 실제 적용 상품·현재 모델/기능 조건

공식 문서는 분당 제한과 서비스 가용성도 함께 언급합니다. 일일 상한이 남았다고 모든 요청이 즉시 처리되는 것은 아닙니다. 반대로 한도 부족 안내가 나왔다고 바로 자동으로 추가 결제가 발생한다고 판단하지 마세요. 현재 인증 경로와 결제 조건을 확인해야 합니다.

일반 Gemini 웹앱의 메시지 제한·영상 크레딧과 CLI 요청 수는 같은 단위가 아닙니다. 초기화 시각도 다른 서비스의 안내를 가져다 적용하지 말고, 현재 CLI의 사용량·재개 안내를 확인합니다.

회사·학교 계정과 개인 구독 구분하기

현재 Code Assist 공식 조직 한도는 Standard의 일일 1,500, Enterprise의 일일 2,000 모델 요청을 안내합니다. Code Assist agent mode와 CLI 요청은 합산되며, 모델 계열 전체의 사용이 제한에 포함됩니다.

모든 Workspace 상품이나 개인용 구독이 같은 자격을 주는 것은 아닙니다. 회사·학교 계정에서는 조직이 배정한 라이선스와 프로젝트부터 확인하세요. 개인 Google AI Pro·Ultra의 로그인 방법을 조직 라이선스에 그대로 적용하지 않습니다.

CLI 한도 문서는 2026년 6월 18일, 확인한 Code Assist 조직 문서는 2026년 10월 22일 갱신 표기였습니다. 상품명만 비슷하다는 이유로 혜택을 확정하지 말고 현재 CLI Plans·인증 안내·조직 라이선스의 지원 대상을 함께 확인하세요.

API 키와 Vertex AI의 비용은 별도로 확인하기

Gemini API 키를 쓰면 키가 속한 프로젝트의 모델·tier·요청 제한과 과금 조건을 확인해야 합니다. Google AI 구독료를 냈다는 사실만으로 API 사용료가 모두 포함되는 것은 아닙니다.

CLI 한도 도움말에 실린 무료 API의 Flash·요청 수 안내를 다른 모델의 공통 한도로 확대하지 마세요. Gemini API 현재 한도 안내는 모델·프로젝트·tier에 따른 제한과 실제 프로젝트에서 확인하는 경로를 설명합니다. 무료 tier와 유료 프로젝트의 조건을 구분합니다.

Vertex AI는 Google Cloud 프로젝트와 위치·인증·활성화된 서비스에 따라 확인할 항목이 달라집니다. 무료 체험이나 Express 안내를 일반 Vertex AI 사용 전체의 영구 무료 조건으로 이해하지 마세요. 필요한 경로를 선택한 뒤 해당 프로젝트의 공식 요금·사용량을 확인합니다.

모델별 토큰 단가와 무료/유료 API 프로젝트의 차이는 AI 스튜디오·API 요금 가이드로 이어집니다. 이 글에서는 같은 단가표를 다시 만들지 않습니다.

요청 수·토큰·질문 횟수 나눠 보기

단위 뜻 혼동하기 쉬운 점
사용자 프롬프트 사람이 보낸 요청 한 번 입력했다고 모델 호출도 한 번인 것은 아님
모델 요청 수 CLI가 모델에 보내는 호출 도구 결과 처리·후속 판단으로 여러 번 호출될 수 있음
토큰 모델이 처리한 입력·출력의 양 요청 수와 같지 않으며 과금 방식도 인증 경로에 따라 다름

예를 들어 ‘파일을 읽고 수정한 뒤 확인해줘’라는 한 요청이 파일 읽기·수정 판단·명령 결과 확인을 거치며 여러 모델 요청으로 이어질 수 있습니다. 따라서 무료 1,000 요청을 질문 1,000개로 보장하지 않습니다.

사용량을 확인하고 부족한 지점 찾기

CLI 안에서 다음 명령으로 현재 통계를 확인합니다.

/stats model

공식 명령 안내는 모델별 토큰·한도 정보를 보여 주는 기능으로 설명합니다. 전체 세션 통계는 /stats 또는 /stats session, 도구 사용은 /stats tools로 구분할 수 있습니다. 표시 항목과 적용 한도는 현재 인증 계정에서 확인하세요.

세션 토큰 통계를 최종 청구서로 여기지는 마세요. API·Cloud 비용은 해당 프로젝트의 사용량·결제 내역에서, 구독 적용은 구독 계정·상품에서 확인해야 합니다.

부족하거나 실패한 부분 다음 확인
여러 번의 작은 수정으로 요청이 늘어남 한 번의 요청에 대상·유지 조건·완료 기준을 분명히 적기
현재 모델/일일 한도 안내 계정 경로·사용량·재개 안내 확인
429가 표시됨 오류 단계와 인증/프로젝트 확인
추가 사용이 필요함 지원 구독 또는 API/Cloud 종량 경로의 비용·관리 조건 비교

참고자료