사용자 지정 엔드포인트와 무료 모델을 쓰는 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-clihttp://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>
geminiWindows PowerShell
$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
geminiGemini 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 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 예 | 예 |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.8 Live | Google AI Studio | - | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
일치하는 무료 모델 14개 중 8개를 표시합니다. 모든 모델 보기.
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
| 모델 | 무료 제공 | 컨텍스트 | 무료 한도 (가장 좋은 조건) | 도구 | 비전 |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 요청/분 1 req/min per model | 예 | 아니요 |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 요청/분 40 RPM | 예 | 예 |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | 예 | 아니요 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 요청/분 50 요청/일 50 req/day account-wide (1,000 after a $10 purchase) | 예 | 예 |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 요청/분 50 요청/일 Shared rate limit | 예 | 아니요 |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 요청/분 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" 메시지 | 모든 키가 한도에 도달함 | 다른 제공업체의 키를 추가하거나, 쿨다운이 끝날 때까지 기다리십시오 |
자주 묻는 질문
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 하십시오.
관련 가이드
- free gemini api
- Gemini API 할당량 초과 (429 RESOURCE_EXHAUSTED)
- Claude Code를 무료로 사용하는 방법
- 무료 모델로 Codex CLI 사용하기
- 최고의 무료 코딩 모델 API
출처
- Gemini CLI docs: configuration reference (20 November 2026 확인)
- Gemini CLI docs: authentication (20 November 2026 확인)
- Gemini CLI docs: quota and pricing (20 November 2026 확인)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (20 November 2026 확인)
- Gemini CLI issue 27550: auth with a custom base URL (20 November 2026 확인)
- Google AI Studio: rate limits (20 November 2026 확인)
- FreeLLMAPI docs: native Gemini API (20 November 2026 확인)