Gemini CLIでAPIキーとプロキシのベースURLを設定する方法

Gemini CLI とは

Gemini CLI は、ターミナルベースのチャット、コードの説明、ファイル分析、開発支援のための Google のコマンドライン AI ツールです。これはClaude CodeやCodexのクローンではありません。認証、環境変数、モデルルーティングが異なります。

このガイドでは、プロキシ ユーザーにとって重要な 2 つのパスのみを説明します。

• Google でログイン: Google アカウントを使用します。最初に公式 CLI を試すのに最適です。
• Gemini APIキー (AI Studio): GEMINI_API_KEY を使用します。これは、ほとんどのプロキシ ガイドが期待するパスです。

多くの「Gemini CLI プロキシ」プロバイダーは実際には、Google または Gemini モデルを公開するマルチモデル API アグリゲーターですが、これは自動的にネイティブの Gemini CLI 互換性を意味するものではありません。

最初にグローバル構成を変更しないでください。 Google または Gemini モデルを明確にリストしているプロバイダーを選択し、一時キーまたは少額のクレジット残高を使用して小規模なテストを実行してから、それが日常のコーディング設定に属するかどうかを判断します。

まだサービスを比較している場合は、Gemini CLI対応プロキシ比較から始めてください。より広いマルチモデルの選択肢は、OpenRouter代替サービスとAI API中継サービス一覧でも確認できます。

Gemini CLI をインストールする

まず Node.js を確認してください。 Gemini CLI では Node.js 20 以降を使用する必要があります。

node --version

公式の npm インストール パスは次のとおりです。

npm install -g @google/gemini-cli
gemini --version

グローバル インストールを行わずに一時的に実行する場合は、以下を使用することもできます。

npx @google/gemini-cli

インストール後に一度起動します。

gemini

インストール後も使いやすくする

短いコマンドエイリアスを追加する

毎回 gemini を入力するのが長すぎると感じる場合は、シェル エイリアスを追加してください。 g ではなく gm をお勧めします。g は、git エイリアス、ディレクトリ ジャンプ ツール、またはその他のローカル ショートカットと競合することが多いためです。

Bash または Zsh を使用する macOS / Linux では、シェル プロファイルにエイリアスを追加します。

# Zsh usually uses ~/.zshrc; Bash usually uses ~/.bashrc or ~/.bash_profile
echo 'alias gm="gemini"' >> ~/.zshrc
source ~/.zshrc

次に、Gemini CLI を次のように起動します。

gm

Windows PowerShell で、$PROFILE を開きます。

notepad $PROFILE

次に、以下を追加します。

Set-Alias gm gemini

注: このエイリアスは、Gemini CLI が起動する前に、端末内で gm を gemini に展開するだけです。これは、Gemini CLI の内部エイリアスではありません。プロファイルのシェル エイリアスは、Gemini CLI シェル コマンド内では機能しない可能性があります。

認証パスの選択

初回起動時は、Login with Google と Gemini API Key に注目してください。この単純なルールを使用してください。

• 公式 Gemini CLI のみを試したい場合: Login with Google を選択します。これは、Google サインイン ページを開くことができる個人ユーザーに最適です。
• プロキシ プロバイダーまたは APIキーを使用したい: Gemini API Key (AI Studio) を選択します。これは、ほとんどのプロキシ セットアップ ガイドが想定しているパスです。

一度開始してください:

gemini

後で認証を切り替える必要がある場合は、Gemini CLI 内でこれを実行します。

/auth

次に、一致するオプションを選択します。

○ Login with Google
● Gemini API Key (AI Studio)

ほとんどのプロキシ設定では、Gemini API Key (AI Studio) を選択し、Gemini CLI が端末環境から GEMINI_API_KEY を読み取れるようにします。

APIキーとプロキシ エンドポイントを構成する

公式の AI Studio APIキーの最小設定は次のとおりです。

export GEMINI_API_KEY="your Gemini API key"
gemini

プロキシ プロバイダーの場合、多くのガイドでは APIキーとプロキシ エンドポイントの両方を設定するように求められます。

export GEMINI_API_KEY="your proxy API key"
export GOOGLE_GEMINI_BASE_URL="https://your-proxy.example"
gemini

長期的に使用する場合は、これらの値をシェル プロファイルに入力してください。 Zsh ユーザーは通常、~/.zshrc を編集します。

nano ~/.zshrc

追加：

export GEMINI_API_KEY="your proxy API key"
export GOOGLE_GEMINI_BASE_URL="https://your-proxy.example"

プロファイルをリロードします。

source ~/.zshrc

Bash ユーザーは通常、~/.bashrc を編集します。

nano ~/.bashrc
source ~/.bashrc

Windows CMD は次の方法で一時変数を設定できます。

set GEMINI_API_KEY=your proxy API key
set GOOGLE_GEMINI_BASE_URL=https://your-proxy.example

PowerShell では以下を使用できます。

$env:GEMINI_API_KEY="your proxy API key"
$env:GOOGLE_GEMINI_BASE_URL="https://your-proxy.example"

注: GOOGLE_GEMINI_BASE_URL がサポートされているかどうか、および URL にパス接尾辞が必要かどうかは、プロバイダーによって異なります。別のプロバイダーのエンドポイントをむやみにコピーしないでください。

一般的な起動パターン

セットアップ後、次のパターンを使用します。

# Interactive mode
gm

# Ask one direct question
gemini "Explain this project's directory structure"

# Test a specific model; use the model name from your provider docs
gemini -m gemini-2.5-flash "Introduce Gemini CLI in one sentence"

インストール後に動作を確認する

クリーンなターミナルを使用し、最初に古い変数をクリアします。

unset GEMINI_API_KEY GOOGLE_API_KEY
export GEMINI_API_KEY="provider or official test key"
gemini

プロバイダーがカスタムのベースURL を必要とする場合は、プロバイダーが提供するエンドポイントを追加します。

export GOOGLE_GEMINI_BASE_URL="https://your-proxy.example"
gemini "Explain in one sentence which model you are connected to"

基本的なチャットが機能したら、次の 4 つの小さなチェックを実行します。

1. gemini -p "Explain this codebase architecture" は正常に戻ります。
2. gemini -m gemini-2.5-flash "hello" は特定のモデルで動作します。
3. プロジェクト内で gemini を起動し、小さなファイルを読み取るように依頼します。
4. 低リスクのコード説明タスクまたは生成タスクを 1 つ実行して、ストリーミング、ツールの動作、モデル名を確認します。

通常の応答は、基本的なリクエストが機能することを証明するだけです。コードの読み取り、ファイル編集、ストリーミング動作、モデル名を引き続きテストします。プロバイダーのドキュメントに Gemini CLI について記載されていない場合は、ネイティブ Gemini CLI をサポートしているのか、それとも OpenAI互換エンドポイントを介した Gemini モデルのみをサポートしているのかを尋ねてください。

プロキシプロバイダーに尋ねるべきこと

私は通常、最初に 2 つのことを確認します。ドキュメントに GEMINI_API_KEY について言及しているかどうか、もう 1 つは GOOGLE_GEMINI_BASE_URL について言及しているかどうかです。最初の起動で認証ピッカーが表示される場合は、ガイドで /auth で Gemini API Key (AI Studio) を選択するように指示されているかどうかを確認してください。

プロバイダーが Gemini モデルのみをリストしている場合、または「OpenAI互換」とのみ述べている場合は、まだ Gemini CLI 互換として扱わないでください。 Gemini CLI ファイルの読み取り、ストリーミング、ツールの動作をサポートせずに、OpenAI互換エンドポイントを通じて Gemini を公開する可能性があります。

ドキュメントが不明瞭な場合は、小さな天びんのみを使用してテストしてください。サポートが変数名、ベースURL、および /auth の選択を説明できない場合は、未検証としてマークしたままにしてください。

よくあるエラー

• 401 / 不正: キーのタイプが間違っているか、プロバイダーが Gemini CLI が送信する認証形式を受け入れません。
• 403 / 権限が拒否されました: キーは認証されますが、アカウント、プロジェクト、またはモデルの権限がありません。
• 404 / 見つかりません: ベースURL パスが間違っています。多くの場合、/v1 が必要かどうかに関連します。
• モデルが見つかりません: モデルのエイリアスがプロバイダーのリストされたモデル名と一致しません。
• 429 / リクエストが多すぎます: 使用可能なクォータがないか、レート制限に達したか、CLI / コーディング エージェントがあまりにも積極的に再試行しています。
• ネットワーク エラー/タイムアウト: ローカル ネットワーク、プロキシ、プロバイダー ノード、またはアップストリーム タイムアウト。
• チャットは機能しますが、コーディング ツールは失敗します: プロバイダーは通常の補完をサポートしている可能性がありますが、Gemini CLI が必要とするツールの呼び出しやストリーミング動作はサポートしていません。

401 または 429 の場合は、最初にプロバイダーを切り替えないでください。下部にある関連エラーページを開き、ベースURL、APIキー、モデル名、残高、レート制限の順に確認してください。

セットアップを簡単にするツール

プロキシ エンドポイントを 1 つだけ接続する場合は、~/.zshrc を手動で編集するだけで十分です。プロバイダーを頻繁に切り替える場合は、ツールが役立ちます。

CC Switch などの構成マネージャーは、プロバイダー プロファイル、ベースURL、APIキー、モデル名、および Claude Code、Codex、Gemini CLI、OpenCode にわたる使用状況追跡の管理に役立ちます。

順序は重要です。最初に最小限のセットアップを手動でテストし、次に作業中のセットアップをツールに保存します。それ以外の場合、ツールは壊れた構成をより迅速に整理するのに役立つだけです。

次のステップ

便利な Gemini CLI プロキシ ページには、単に「Gemini をサポート」と記載する必要があります。プロバイダーが Google または Gemini のモデル、価格設定、支払い方法、および Gemini CLI セットアップに関するメモを公開しているかどうかを示す必要があります。モデル リストにより、プロバイダーが候補リストに追加されます。 CLI の動作が安定するかどうかが実際の基準です。