홈 / 가이드 / 사용자 지정 엔드포인트와 무료 모델을 쓰는 Gemini CLI

사용자 지정 엔드포인트와 무료 모델을 쓰는 Gemini CLI

Gemini CLI는 Google의 오픈 소스 터미널 코딩 에이전트입니다. 요청을 사용자 지정 기본 URL로 보낼 수 있습니다. 이 가이드는 Gemini CLI를 FreeLLMAPI에 연결합니다. FreeLLMAPI는 /v1beta에서 네이티브 Gemini API를 제공합니다. 그러면 요청은 무료 제공업체 풀로 전달되며, 여기에는 무료 Gemini API 키도 포함될 수 있습니다.

코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.

2026년 Gemini CLI 무료 등급 변경

먼저 이 내용을 읽으십시오. Google은 2026년에 Gemini CLI의 무료 사용 방식을 바꾸었습니다. Gemini CLI 할당량 페이지는 이렇게 말합니다. "무료 등급 및 Google One 사용자: Gemini CLI는 2026년 6월 18일에 Antigravity CLI로 대체되었습니다."

Google 공지에 따르면 Gemini CLI는 유료 Gemini API 키와 기업 고객을 통해 계속 사용할 수 있습니다.

  • 무료 등급의 Google 로그인: 개인 계정에는 더 이상 Gemini CLI가 제공되지 않습니다.
  • 사용자 지정 기본 URL이 있는 Gemini API 키: Gemini CLI 설정 참조는 여전히 GOOGLE_GEMINI_BASE_URL을 설명합니다. 이 변수를 설정하면 Gemini CLI는 요청을 Google이 아니라 설정한 URL로 보냅니다.
  • 무료 Gemini API 키: Google AI Studio는 여전히 Gemini API의 무료 등급을 나열합니다. FreeLLMAPI는 이 키를 다른 제공업체의 키와 함께 사용할 수 있습니다.

이 가이드는 두 번째 방법을 사용합니다. FreeLLMAPI가 요청에 응답하며, 각 요청을 풀의 무료 모델로 보냅니다.

1단계: FreeLLMAPI와 Gemini CLI 설치

두 가지 모두 설치

curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cli

http://localhost:3001을 여십시오. Keys 페이지에서 무료 제공업체 키를 두 개 이상 추가하십시오. 무료 Google AI Studio 키가 좋은 첫 키입니다. 같은 페이지에서 통합 키를 복사하십시오.

2단계: Gemini CLI가 게이트웨이를 가리키게 하기

환경 변수 두 개를 설정한 다음 Gemini CLI를 시작하십시오. 기본 URL은 /v1beta가 없는 서버 오리진입니다. API 경로는 Gemini CLI가 직접 추가합니다.

macOS 또는 Linux

export GOOGLE_GEMINI_BASE_URL=http://localhost:3001
export GEMINI_API_KEY=<unified-key>
gemini

Windows PowerShell

$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
gemini

Gemini CLI가 인증 방법을 물으면 Use Gemini API key를 선택하십시오. 이 선택을 저장하려면 ~/.gemini/settings.json에 설정하십시오:

~/.gemini/settings.json

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
중요: GEMINI_API_KEY를 사용하십시오. Gemini CLI 이슈에 따르면 0.44.x 버전은 GOOGLE_API_KEY를 GOOGLE_GEMINI_BASE_URL과 함께 사용하면 "Invalid auth method selected"로 실패합니다. GOOGLE_API_KEY가 설정되어 있다면 unset GOOGLE_API_KEY로 제거하십시오.

3단계: Gemini 모델 이름을 무료 모델에 매핑하기

Gemini CLI는 gemini-2.5-flash와 같은 Gemini 모델 이름을 요청합니다. FreeLLMAPI는 이 이름을 Google로 직접 보내지 않습니다. Keys, Agents 탭의 Gemini 계열 맵을 통해 이름을 처리합니다. 각 계열(Pro, Flash, Flash-Lite)을 Auto 또는 고정된 카탈로그 모델에 매핑하십시오.

  • Auto를 선택하면 라우터가 각 요청에 무료 모델을 선택합니다. 한 제공업체가 429 오류를 보내면 다음 제공업체를 시도합니다.
  • 카탈로그 ID도 모델 이름으로 작동합니다. gemini -m <catalog-id>로 Gemini CLI를 시작하거나 GEMINI_MODEL을 설정하십시오.
  • Gemini CLI는 도구를 사용하는 에이전트입니다. 계열을 도구 호출과 큰 컨텍스트 창을 지원하는 모델에 매핑하십시오.

첫 번째 표는 오늘 카탈로그의 무료 Gemini 모델을 보여 줍니다. 두 번째 표는 Gemini 계열에 매핑할 수 있는 다른 무료 모델을 보여 줍니다.

도구 호출을 지원하는 무료 Gemini API 모델 (Google AI Studio)
모델무료 제공컨텍스트무료 한도 (가장 좋은 조건)도구비전
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quota예예
Gemini Flash (latest alias)Google AI Studio-10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
Gemini 3.7 FlashGoogle AI Studio1M10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
Gemini 3.6 FlashGoogle AI Studio1M10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
Gemini 3.5 FlashGoogle AI Studio1M10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
Gemini 3.8 LiveGoogle AI Studio-10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
Gemini 3.5 Flash LiteGoogle AI Studio1M15 요청/분
20 요청/일
250,000 토큰/분
~3M
예예

일치하는 무료 모델 14개 중 8개를 표시합니다. 모든 모델 보기.

FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.

Gemini CLI용 다른 무료 모델: 도구 호출 및 128K 이상 컨텍스트
모델무료 제공컨텍스트무료 한도 (가장 좋은 조건)도구비전
GLM 5.3UnoRouter1M1 요청/분
1 req/min per model
예아니요
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 요청/분
40 RPM
예예
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowance예아니요
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring credit예예
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring credit예예
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 요청/분
50 요청/일
50 req/day account-wide (1,000 after a $10 purchase)
예예
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 요청/분
50 요청/일
Shared rate limit
예아니요
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 요청/분
250 요청/일
70,000 토큰/분
~6M
예예

일치하는 무료 모델 104개 중 8개를 표시합니다. 모든 모델 보기.

FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.

Gemini 무료 등급 한도

Google의 요청 한도 페이지에 따르면 한도는 API 키가 아니라 프로젝트 단위로 적용됩니다. 한 프로젝트에 키를 더 추가해도 할당량이 늘지 않습니다. Google은 또한 한도가 보장되지 않으며, Google AI Studio에서 현재 한도를 확인할 수 있다고 설명합니다. 미리 보기 모델은 한도가 더 낮습니다.

무료 Gemini Flash 키는 하루에 요청을 조금만 허용합니다. Gemini CLI 작업 하나가 많은 요청을 보낼 수 있습니다. 다른 제공업체의 키를 추가하면 Gemini 할당량이 멈춘 뒤에도 라우터가 계속 작동할 수 있습니다. 네이티브 인터페이스는 generateContent, streamGenerateContent와 ?alt=sse, countTokens, 모델 목록을 지원합니다.

FreeLLMAPI는 키를 x-goog-api-key 헤더, Bearer 토큰, 또는 Gemini의 ?key= 쿼리 매개변수로 받습니다. URL의 키는 셸 기록과 프록시 로그에 남을 수 있으므로 헤더를 사용하십시오.

문제 해결

문제원인해결 방법
Gemini CLI가 Google 로그인을 엽니다인증 유형이 Gemini API key로 설정되지 않음Use Gemini API key를 선택하거나 security.auth.selectedType을 설정하십시오
"Invalid auth method selected"사용자 지정 기본 URL과 함께 GOOGLE_API_KEY를 사용함GEMINI_API_KEY를 사용하고, GOOGLE_API_KEY를 unset 하십시오
요청이 게이트웨이가 아니라 Google로 감이 셸에 GOOGLE_GEMINI_BASE_URL이 설정되지 않음변수를 export한 다음 gemini를 다시 시작하십시오
모델 호출에서 404기본 URL에 /v1beta가 포함됨오리진 http://localhost:3001만 사용하십시오
도구 호출이 실패함Gemini 계열이 도구 호출 성능이 약한 모델에 매핑됨위 표의 모델로 계열을 매핑하십시오
"All models rate-limited after N attempts" 메시지모든 키가 한도에 도달함다른 제공업체의 키를 추가하거나, 쿨다운이 끝날 때까지 기다리십시오
하나의 키로 이 모델을 모두 사용하십시오. FreeLLMAPI는 오픈 소스이며 직접 호스팅하는 라우터입니다. 이 모든 무료 제공 서비스를 하나의 OpenAI 호환 엔드포인트로 묶고, 요청 한도에 걸리면 다른 모델로 자동 전환합니다. 카탈로그 보기 또는 바로 시작.

자주 묻는 질문

Gemini CLI는 여전히 무료입니까?

Google은 2026년 6월 18일에 무료 등급 및 Google One 사용자의 Google 로그인을 통한 무료 Gemini CLI 사용을 종료했습니다. CLI는 여전히 사용자 지정 기본 URL을 지원하므로 FreeLLMAPI 같은 무료 게이트웨이에서 실행할 수 있습니다.

사용자 지정 엔드포인트와 함께 Gemini CLI를 사용하려면 어떻게 합니까?

GOOGLE_GEMINI_BASE_URL을 엔드포인트 오리진으로, GEMINI_API_KEY를 해당 키로 설정한 다음 Use Gemini API key를 선택하십시오. 엔드포인트는 /v1beta에서 네이티브 Gemini API를 지원해야 합니다.

Gemini CLI가 Gemini가 아닌 모델을 사용할 수 있습니까?

예, FreeLLMAPI를 통해 가능합니다. 게이트웨이는 Gemini Pro, Flash, Flash-Lite 계열 이름을 Auto 또는 카탈로그의 모델(예: Qwen 또는 GLM 모델)에 매핑합니다.

Gemini API 무료 등급 한도는 얼마입니까?

Google은 키 단위가 아니라 프로젝트 단위로 한도를 정하며, 현재 값은 Google AI Studio에 표시합니다. 이 페이지의 표는 FreeLLMAPI 카탈로그에서 가져온 오늘의 무료 Gemini 모델과 그 한도를 보여 줍니다.

'Invalid auth method selected' 오류가 나는 이유는 무엇입니까?

Gemini CLI 이슈에 따르면 GOOGLE_API_KEY를 GOOGLE_GEMINI_BASE_URL과 함께 사용하면 0.44.x 버전에서 이 오류가 발생합니다. GEMINI_API_KEY를 사용하고 GOOGLE_API_KEY를 unset 하십시오.

관련 가이드

출처

전체 가이드 · 무료 모델 전체 보기