カスタムエンドポイントと無料モデルで使う Gemini CLI
Gemini CLI は、Google がターミナル向けに提供するオープンソースのコーディングエージェントです。リクエストを、カスタムのベース URL に送信できます。このガイドでは、Gemini CLI を FreeLLMAPI に向けます。FreeLLMAPI は、ネイティブの Gemini API を /v1beta で提供します。リクエストは無料プロバイダーのプールに送られます。このプールには、無料の 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 は、これらのキーを、ほかのプロバイダーのキーと一緒に使用できます。
このガイドでは 2 つ目の方法を使用します。FreeLLMAPI がリクエストに応答し、各リクエストをプール内の無料モデルに送信します。
手順 1: FreeLLMAPI と Gemini CLI をインストールする
両方をインストールする
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-clihttp://localhost:3001 を開きます。Keys ページで、2 つ以上の無料プロバイダーのキーを追加します。無料の Google AI Studio キーは、最初のキーとして適しています。同じページで統合キーをコピーします。
手順 2: Gemini CLI をゲートウェイに向ける
2 つの環境変数を設定してから、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 を選ぶと、ルーターはリクエストごとに無料モデルを選択します。1 つのプロバイダーが 429 エラーを返すと、次のプロバイダーを試します。
- カタログ ID もモデル名として使用できます。
gemini -m <catalog-id>で Gemini CLI を起動するか、GEMINI_MODELを設定します。 - Gemini CLI はツールを使うエージェントです。ファミリーは、ツール呼び出しとコンテキストウィンドウの大きいモデルに対応付けてください。
1 つ目の表は、本日カタログにある無料の Gemini モデルを示します。2 つ目の表は、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 のレート制限ページによると、上限はキーごとではなくプロジェクトごとに適用されます。1 つのプロジェクトでキーを増やしても、クォータは増えません。Google はまた、上限は保証されないこと、現在の上限は Google AI Studio で確認できることも述べています。プレビューモデルの上限は低くなっています。
無料の Gemini Flash キーで送信できるリクエストは、1 日あたり少数です。Gemini CLI の 1 つのタスクで、多数のリクエストが送信されることがあります。ほかのプロバイダーのキーを追加すると、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 が設定されていない | 変数をエクスポートしてから、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)