Gemini CLIを日本から使う方法|Clash Vergeの接続設定と対処法

Gemini CLIは、ターミナルから質問、コードの確認、ファイルの読み取り、開発作業の補助を行えるAIツールです。ブラウザーで利用するAIサービスと違い、Shell、Node.js、Git、エディターなどと組み合わせやすい一方、認証処理やAPI通信が複数のドメインに分かれるため、ネットワーク環境によってはログイン画面が開かない、認証後に戻れない、リクエストがタイムアウトするといった問題が起こります。

Clash Vergeを使う場合は、アプリ全体を無条件にプロキシへ通すのではなく、まずローカルポート、ターミナルの環境変数、Clashのルール、認証に使われるブラウザーの経路を順番に確認することが大切です。日本から利用する場合も、地域やアカウントの利用条件、Google側の提供状況、利用規約を確認したうえで設定してください。ここでは通信経路を安定させるための一般的な設定と、失敗したときの切り分け方法を紹介します。

Gemini CLIとClash Vergeの役割を分けて考える

最初に理解しておきたいのは、Gemini CLIとClash Vergeは別の層にあるソフトウェアだということです。Gemini CLIはターミナル上で動作するクライアントで、入力したプロンプトをGoogleのサービスへ送信し、応答を受け取ります。認証情報の保存、APIリクエスト、ストリーミング応答の処理などは、Gemini CLIとその実行環境が担当します。

一方、Clash Vergeはプロキシコアを起動し、ローカルのHTTPまたはSOCKSポートでアプリの通信を受け付けます。受け取った接続は、設定ファイルのDNS、ルール、プロキシグループに従って、直接接続または選択したノードへ送られます。Clash Vergeの画面でノードを選択しても、Gemini CLIが自動的にそのポートを使うとは限りません。ターミナル側がシステムプロキシを参照しない場合は、環境変数を明示的に設定する必要があります。

CLI

Gemini CLI

ターミナルからAIモデルへリクエストを送るクライアントです。認証方式と利用するアカウント、API設定を個別に確認します。

LOCAL PROXY

Clash Verge

ローカル待受ポートで通信を受け、ルールとプロキシグループに従って接続先への経路を選択します。

ROUTING

ルール設定

認証、API、関連するサービスの通信をどのポリシーで処理するかを決めます。

日本から使う前に確認する条件

Gemini CLIの利用方法は、ログイン型の認証を使う場合と、APIキーなどの開発者向け認証を使う場合で異なります。実際に表示される初回セットアップ画面や、インストールしたバージョンの説明に従ってください。認証画面が表示される方式では、ターミナルからブラウザーを起動し、ブラウザーで許可した後にCLIへ戻る流れが一般的です。ブラウザーだけプロキシを使い、ターミナルが直接接続していると、認証完了後のコールバックやトークン取得で失敗することがあります。

APIキー方式では、キーの有効性だけでなく、対象プロジェクト、課金状態、利用可能なモデル、リクエスト上限も確認が必要です。HTTPの401や403が返る場合、Clashのノードを変更しても解決しないことがあります。反対に、認証情報は正しいのに接続が長時間止まる、名前解決に失敗する、TLS接続が確立しない場合は、ネットワーク経路やDNSを調べる価値があります。

症状 先に確認する場所 考えられる原因
認証ページが開かない ブラウザーとClashの接続履歴 ブラウザーが別経路、DNS失敗、プロキシ未接続
認証後にCLIへ戻れない ターミナルの環境変数とコールバック CLIだけ直接接続、ローカルコールバックの干渉
API応答が401・403 アカウント、キー、プロジェクト設定 認証情報または利用権限の問題
タイムアウトする Clashログ、ルール、ノード状態 ルール誤判定、ノード不安定、TLSやDNSの問題

Clash Vergeの基本設定を確認する

Clash Vergeを起動したら、まず現在有効なプロファイルと実行中のコアを確認します。設定を読み込んだだけでは、プロファイルが実際に使用中とは限りません。画面上でアクティブなプロファイル、コアの状態、システムプロキシのスイッチ、現在のプロキシグループを確認してください。Clash Vergeの構成や表示名はバージョンによって異なるため、固定されたメニュー名だけを探すのではなく、プロファイル、設定、接続、ログに相当する画面を確認します。

ターミナルから使う場合は、HTTPプロキシまたはmixed-portの番号を確認します。よく使われる番号が存在していても、必ずしも自分の環境で同じとは限りません。サブスクリプションやプロファイルの更新によってポートが変更されることもあります。概念を確認するための簡略化した例は次のとおりです。

mixed-port: 7890
allow-lan: false
mode: rule

rules:
  - MATCH,PROXY

この例の mixed-port は、HTTPとSOCKSの両方を受け付けるローカルポートです。allow-lan: false は同じ端末からの利用を前提とした安全寄りの設定で、別の端末から接続させる必要がない限り有効にしておく必要はありません。実際のプロファイルに同じ項目があるとは限らないため、値はClash Vergeの有効設定を基準にしてください。

ポートが待ち受けているかは、WindowsならPowerShell、macOSやLinuxなら lsof や ss で確認できます。

Get-NetTCPConnection -LocalPort 7890 -State Listen

lsof -nP -iTCP:7890 -sTCP:LISTEN

ss -lntp | grep 7890

結果が表示されない場合は、Gemini CLIの設定を変更する前にClash Vergeへ戻ります。コアが停止している、ポート番号が違う、別のアプリがポートを使用している、設定の解析に失敗しているといった可能性があります。ポートが確認できたら、一般的なHTTPSサイトへのリクエストでプロキシ経路をテストします。

curl -I -x http://127.0.0.1:7890 https://example.com

このテストが成功すれば、少なくともターミナルからClashのローカルポートまでの接続と、Clashから外部サイトまでの接続は動作しています。ここで失敗する場合は、Gemini CLI固有の問題として扱わず、まずポート、ノード、ルール、DNSを調べてください。

Gemini CLIにプロキシを設定する手順

ここからは、Clash Vergeのローカルポートをターミナルの環境変数へ設定する実作業です。設定はまず一時的に行い、通信できることを確認してからShellの設定ファイルへ保存します。いきなり永続設定にすると、後で別のプロキシアドレスが残り、原因を見つけにくくなります。

  1. Clash Vergeでプロファイルを有効にする。コアが起動しており、利用するプロキシグループに接続先が選択されていることを確認します。
  2. ローカルポートを確認する。HTTP、SOCKS、mixed-portの実際の番号を調べます。以下では例として7890を使用します。
  3. ターミナルで一時設定する。Shellに応じた環境変数を設定し、同じセッションでGemini CLIを実行します。
  4. 接続履歴を確認する。認証やAPI通信に関係する接続がClashの接続一覧に表示され、意図したポリシーグループへ渡っているかを確認します。
  5. 動作後に永続化する。毎回必要な場合だけ、Shellの設定ファイルへ追加します。

macOSとLinuxの設定例

BashやZshでは、次のように小文字の変数を設定できます。ツールによって参照する変数名が異なるため、互換性を重視する場合は大文字も同じ値にします。

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

gemini

SOCKSポートを使う場合は、クライアントがSOCKS形式の環境変数に対応しているか確認してください。対応していないツールへ無理に socks5:// を渡すと、URLをHTTPプロキシとして解釈して失敗することがあります。Clashのmixed-portをHTTPプロキシとして使う方法は、対応ソフトが多く、最初の切り分けに向いています。

設定を解除するには、同じターミナルで次を実行します。

unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY ALL_PROXY all_proxy

Windowsの設定例

PowerShellでは、現在のセッションだけに環境変数を設定できます。

$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:http_proxy = "http://127.0.0.1:7890"
$env:https_proxy = "http://127.0.0.1:7890"

gemini

新しいターミナルを開いたときにも同じ設定を使う場合は、PowerShellのプロファイルやWindowsの環境変数へ追加できます。ただし、会社のVPN、開発用ツール、パッケージマネージャーが別のプロキシを設定している場合があります。HTTP_PROXY と HTTPS_PROXY の値が異なる、古いポートを指している、認証付きプロキシのURLが残っているといった状態を避けてください。

認証とブラウザーの経路をそろえる

Gemini CLIの認証で問題が起きる場合、ターミナルだけでなく、認証に使うブラウザーも確認します。CLIがブラウザーを開いて認証を依頼する方式では、ブラウザー側の通信がClash Vergeを経由しているか、Clashの接続履歴で確認してください。ブラウザー拡張機能、別のVPN、OSのシステムプロキシ、ブラウザー独自のプロキシ設定が同時に動いていると、CLIとブラウザーの経路が分離します。

システムプロキシを有効にしても、すべてのアプリがその設定を読むわけではありません。Chromium系ブラウザーはOS設定を参照することがありますが、起動オプションや拡張機能によって挙動が変わります。Firefoxなどは独自のプロキシ設定を持つため、Clash Verge側の接続履歴に認証関連のドメインが現れない場合は、ブラウザーの接続設定を確認してください。

認証後にターミナルへ戻れない場合は、次の順番で確認すると切り分けやすくなります。

ルールとDNSを見直す

Gemini CLIの通信がClashへ入っているのに失敗する場合は、ルールの順序を確認します。Clashのルールは通常、上から順に照合され、最初に一致したルールが採用されます。関連ドメインを DIRECT へ送るルールが先にあると、プロキシグループを選択してもそのルールが優先されます。逆に、広すぎるプロキシルールを上位へ置くと、ローカルの認証コールバックまで不要にプロキシへ送ることがあります。

ルールを変更する前に、Clash Vergeの接続一覧で実際のドメインと適用ルールを確認してください。Gemini CLIが使う接続先は、CLIのバージョン、認証方式、利用するAPI、Googleのサービス構成によって変わる可能性があります。記事や設定例に書かれたドメインをそのまま一括登録するより、ログに表示された接続を対象にする方が安全です。

DNSも重要です。ドメイン名をローカルDNSで解決し、得られたIPだけをプロキシへ送る構成では、名前解決の経路や地域別応答によって結果が変わる場合があります。Clash VergeやMihomoでFake IP、Redir-host、通常のDNS転送などを設定している場合、現在のモードとルール処理の関係を確認してください。DNS設定を大きく変更する前に、設定ファイルをバックアップし、変更は一項目ずつ行います。

mode: rule

dns:
  enable: true
  enhanced-mode: fake-ip
  listen: 127.0.0.1:1053

上の例は構造を示すだけの簡略例です。利用中のMihomoコアが対応している項目、Clash Vergeが生成する設定、使用するネットワーク環境を確認せず、そのまま貼り付けないでください。DNS変更後にすべてのサイトが不安定になった場合は、変更前の設定へ戻し、通常のHTTPSテスト、名前解決テスト、Clashログを分けて確認します。

エラー別の対処と安全な運用

connection refused は、指定したローカルポートでプロキシが待ち受けていない可能性が高いエラーです。Clash Vergeのコア停止、ポート番号の間違い、別プロセスとの競合を確認します。timeout は、ノード、DNS、ファイアウォール、ルール、上流サービスまで複数の原因が考えられます。まず同じポートで curl を実行し、Gemini CLIだけの問題かどうかを分けてください。

401 や 403 は、プロキシが正常でも発生します。APIキーの誤り、期限切れ、プロジェクト設定、モデル利用権限、アカウントの認証状態を確認します。429 の場合は短時間のリクエスト上限や利用量の制限が関係する可能性があるため、ノードを何度も切り替えるより、利用状況とリクエスト頻度を確認する方が適切です。

運用時は、常にグローバルプロキシへ切り替えるのではなく、まずターミナルの環境変数で対象セッションだけを制御する方法が安全です。必要な通信だけをルールで分け、ローカルアドレスや社内サービスは意図せず外部プロキシへ送らないようにします。TUNモードを使う場合は、より広い範囲の通信を取り込むため、システムプロキシとの二重適用、DNSの循環、開発用コンテナや仮想マシンへの影響も確認してください。

最終的には、Clash Vergeの接続履歴にリクエストが現れること、意図したポリシーグループが選ばれること、ターミナルから同じローカルポートへ接続できること、そしてGoogle側の認証・API条件を満たしていることの4点がそろって初めて、安定したGemini CLI環境になります。どこか一つだけを変更し続けるのではなく、経路、認証、ルール、利用条件を分けて確認してください。

Clashをダウンロード