Gemini CLIにログインしようとしたり、VS CodeでGemini Code Assist拡張を使用しようとしたときに、FAILED_PRECONDITION: User location is not supportedのようなエラーが表示された場合、それはあなたのアカウントやコードの問題ではありません。Google AI StudioとGemini APIは国ごとに不均等に展開されており、一部の地域はサポート対象から除外されています。これを解決するには、許可された国からのIPアドレスを持つプロキシを設定する必要があります。以下では、ターミナル、VS Code、および環境変数レベルでの正しい設定方法を説明します。
Gemini CLIとGemini Code Assistとは
Gemini CLIは、Googleが提供するコンソールツールで、ターミナルから直接Geminiモデルと対話することを可能にします:コードを書く、コマンドを生成する、プロジェクトファイルを分析する、作業環境を離れずにエージェントタスクを実行することができます。これは、使用する認証方法に応じて、generativelanguage.googleapis.comのドメインまたはVertex AIを介してAPIにアクセスします。認証にはGoogle AI StudioのキーまたはGoogle Cloudアカウントを使用します。
Gemini Code Assistは、VS Code(およびJetBrains IDE)用の拡張機能で、コードエディタ内にモデルとのチャット、ヒント、自動補完を組み込んでいます。基本的には同じAPIですが、コマンドラインではなくIDEから拡張機能を介して呼び出されます。両方のツールは同じバックエンドを使用しているため、地域ブロックの問題は両方のケースで同様に現れます。拡張機能はセッションを確立できないか、モデルへの最初のリクエストでエラーを返します。
重要な点:両方のツールは、生成APIだけでなく、Googleの認証サービス(OAuth、Identity Toolkit)にもネットワークリクエストを行います。プロキシが1つのエンドポイントのみに設定されている場合、認証は成功するが生成は失敗する、またはその逆になる可能性があります。したがって、プロキシはシステム環境変数レベルで設定する必要があります。
なぜGeminiがあなたの地域で利用できないのか
Googleは新しいAI製品を段階的に展開することが伝統的です。最初はアメリカと一部のヨーロッパ、その後は他の国々に展開されます。Geminiの場合、これはAPIレベルでの地理的制限として表れます。サーバーは、受信リクエストのIPアドレス(時にはGoogleアカウントの請求先住所も)を確認し、許可されたロケーションのリストと比較します。国がリストにない場合、リクエストはpreconditionエラーで中断されるか、明確な説明なしにタイムアウトします。
これは一般的な意味でのブロックではありません。あなたの国のプロバイダーは何も制限していません。これはGoogle側の地理的フィルターに関するものです。したがって、共有IPのVPNはしばしば効果がありません。これらのアドレスは多くの人々によって広く使用されており、Googleはそれらを疑わしいとマークし、CAPTCHAを要求するか、IPの範囲が正式にその国に登録されていない場合は地理的に制限します。サポートされている地域からの通常の家庭用またはモバイルIPのように見えるアドレスが必要です。つまり、これはレジデンシャルおよびモバイルプロキシが解決する問題と同じです。
Gemini APIで使用するプロキシの選び方
Gemini CLIのような開発ツールにとって、プロキシの重要なパラメータは、セッションの安定性(長い応答の生成中に接続が切れないように)、速度、およびGoogleのアンチフロードシステムに対してIPがどれだけ「クリーン」に見えるかです。以下は3種類の比較です:
| プロキシの種類 | 速度 | 地理的ブロックのリスク | 使用するタイミング |
|---|---|---|---|
| データセンタープロキシ | 高い | 中高 | 迅速なテスト、APIへの一時的なリクエスト |
| レジデンシャルプロキシ | 中高 | 低い | Gemini CLIとCode Assistの毎日の作業 |
| モバイルプロキシ | 中 | 最小 | レジデンシャルIPが地理的フィルターで制限される場合 |
実際には、開発者の日常的な作業には、特定の国にバインドされたレジデンシャルプロキシが最も便利で、10〜30分のスティッキーセッションが望ましいです。これにより、OAuth認証が中断されず、ターミナルセッションがコード生成の途中で切断されることがありません。データセンタープロキシは安価で高速ですが、Googleはすでに一部の範囲を知っており、そのようなIPからのログイン時に追加のアカウント確認を要求することがあります。モバイルプロキシは予備として保持しておく価値があります。レジデンシャルアドレスが何らかの理由で疑わしいリストに載ってしまった場合、通常、キャリアのモバイルネットワークは問題なく地理的確認を通過します。
ターミナルでのプロキシ設定:Linux、macOS、Windows
Gemini CLIは、Node.jsで書かれているほとんどのコンソールユーティリティと同様に、標準の環境変数HTTP_PROXYとHTTPS_PROXYを尊重します。これにより、アプリケーションの設定を変更することなく、CLIのすべてのトラフィックをプロキシ経由でルーティングできます。
macOSおよびLinux(bash/zsh)では、現在のセッションに次のように追加します:
export HTTP_PROXY="http://login:password@proxy_host:port"
export HTTPS_PROXY="http://login:password@proxy_host:port"
export NO_PROXY="localhost,127.0.0.1"
gemini --version
プロキシを常に適用するには、現在のターミナルセッションだけでなく、~/.zshrcまたは~/.bashrcにこれらの行を追加し、source ~/.zshrcコマンドでターミナルを再起動します。
WindowsのPowerShellでは、変数は次のように設定されます:
$env:HTTP_PROXY = "http://login:password@proxy_host:port"
$env:HTTPS_PROXY = "http://login:password@proxy_host:port"
gemini --version
PowerShellを再起動後も変数を保持したい場合は、[System.Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://login:password@proxy_host:port", "User")を使用します。これにより、変数がWindowsのユーザープロファイルに書き込まれます。
プロキシがURL内のログインなしで別の認証を必要とする場合(例:IPホワイトリストによる)、接続文字列からログインとパスワードを削除し、プロキシプロバイダーのパネルでサーバーまたは作業マシンのIPをホワイトリストに追加してください。
Code AssistのためのVS Codeでのプロキシ設定
VS Codeには独自のプロキシ設定があり、対応するオプションが有効になっていない限り、システムの環境変数から自動的に継承されません。settings.jsonを開き(Ctrl+Shift+P → "Preferences: Open User Settings (JSON)")、次のように追加します:
{
"http.proxy": "http://login:password@proxy_host:port",
"http.proxyStrictSSL": false,
"http.proxySupport": "override"
}
http.proxySupport: "override"パラメータは重要です。これがないと、VS Codeはシステムプロキシを使用し続けるか、特定の拡張機能の設定を無視する可能性があります。設定を修正した後は、VS Codeを完全に再起動してください(ウィンドウを再読み込みするだけではなく)。Gemini Code Assist拡張は、アプリケーションの起動時に一度だけネットワーククライアントを初期化します。
拡張機能がプロキシを認識しない場合は、http.proxyAuthorization設定を確認してください。稀に、企業版のVS Codeがセキュリティ上の理由からプロキシのURLにログインとパスワードを送信することをブロックし、その場合は、クレデンシャルをbase64でProxy-Authorizationヘッダーを介して送信する必要があります。
もう一つのポイントは、企業のVPNクライアントやトラフィックを傍受するアンチウイルスなどの拡張機能を一時的に無効にすることです(SSL検査)。これらはしばしば証明書を即座に置き換え、Googleの証明書チェーンを厳密に確認するGemini Code AssistがTLSエラーで接続を切断することがあります。このエラーは、プロキシ自体の問題と混同されやすいです。
Gemini CLI自体でのプロキシ設定
環境変数に加えて、Gemini CLIではプロジェクトの設定ファイルやユーザーのグローバル設定を介してプロキシを指定することもできます。これは、異なるプロジェクトに異なるプロキシを使用したい場合に便利です。設定は通常、~/.gemini/settings.jsonまたはプロジェクトディレクトリ内の.envファイルに保存されます:
# プロジェクトのルートにある.env
GEMINI_API_KEY=あなたのキー
HTTPS_PROXY=http://login:password@proxy_host:port
HTTP_PROXY=http://login:password@proxy_host:port
Google Cloudアカウント(Vertex AI)を介して認証する場合は、プロキシがgcloudユーティリティでも使用されるようにする必要があります。これはOAuthフローを通過します。これには、プロキシを別途設定する必要があります:
gcloud config set proxy/type http
gcloud config set proxy/address proxy_host
gcloud config set proxy/port port
gcloud config set proxy/username login
gcloud config set proxy/password password
その後、gcloud auth loginが実際の(プロキシされていない)IPでブラウザを開いてログイン確認を行う場合、注意が必要です。OAuthページはシステムのブラウザで直接開かれ、ブラウザが同じプロキシに設定されていない場合、最終的な認証セッションは実際のIPにバインドされたトークンを取得する可能性があります。完全な整合性を保つために、ログイン確認を行うブラウザでもプロキシを設定することをお勧めします。たとえば、プロキシ拡張機能やネットワーク設定を使用して認証中に設定します。
接続確認:curlとPython
Gemini CLIが動作しない理由を調べる前に、プロキシがGoogle APIへのトラフィックを通過させているかどうかを確認してください。最も簡単な方法は、curlを介して直接リクエストを行うことです:
curl -x http://login:password@proxy_host:port \
"https://generativelanguage.googleapis.com/v1beta/models?key=あなたの_API_KEY"
もしレスポンスとしてモデルのリスト(gemini-1.5-flash、gemini-1.5-proなど)が含まれるJSONが返ってくる場合、プロキシは正常に機能しており、地域はサポートされています。403やFAILED_PRECONDITIONが表示される場合は、地理的フィルターのレベルでの問題があり、プロキシの国を変更する必要があります。
より詳細な診断には、セッションのプロキシを明示的に指定したPythonを使用するのが便利です:
import requests
proxies = {
"http": "http://login:password@proxy_host:port",
"https": "http://login:password@proxy_host:port",
}
url = "https://generativelanguage.googleapis.com/v1beta/models"
params = {"key": "あなたの_API_KEY"}
response = requests.get(url, params=params, proxies=proxies, timeout=15)
print(response.status_code)
print(response.text[:500])
このスクリプトは、CLIまたはIDEでの完全なセッションを開始する前の迅速な確認として便利です。数秒で、ネットワーク、キー、またはIPの地域に問題があるかどうかを示します。
よくあるエラーとその解決策
"User location is not supported"エラーは、プロキシを接続した後でも通常、プロキシサーバーのIPがサポートされていない国にあるか、GoogleがそれをデータセンターのIPとして識別し、追加の確認を適用したことを意味します。解決策は、米国またはGeminiの完全なサポートを受けている他の国からのレジデンシャルまたはモバイルIPに切り替えることです。
長い応答の生成中のタイムアウトは、プロキシの不安定なセッションに関連していることが多いです。IPがリクエストの途中で変わり、接続が切断されます。通常のリクエストを超える時間(通常は10〜15分の余裕があれば、ボリュームのあるコード生成にも十分です)を超えるスティッキーセッションが必要です。
SSL/TLSハンドシェイク失敗エラーは、ほぼ常にアンチウイルス、企業ファイアウォール、またはVS CodeでのproxyStrictSSLの不適切な設定によるトラフィックの傍受を示します。マシンにSSL検査ソフトウェアがインストールされていないか確認し、診断のために一時的に無効にしてください。
CLIは動作するが、VS Codeの拡張が動作しない(またはその逆)という場合は、環境変数がVS Codeプロセスに渡されていないことを意味します。これは、LinuxやmacOSで、VS Codeが環境変数がエクスポートされたターミナルではなく、システムメニューのアイコンから起動された場合によく発生します。その場合、環境変数は上記のようにsettings.jsonを介して設定する必要があります。
APIキーの地域に対するIPのバインディングとセキュリティ
よく忘れられる別のポイントは、APIキーまたはGoogle Cloudプロジェクトが特定の請求地域にバインドされて作成された場合、プロキシのIPを変更すると期待されるロケーションと実際のロケーションが一致しなくなる可能性があり、GoogleがSMSまたはメールを介して再確認を要求することがあるということです。こうした確認の頻度を減らすためには、同じ国からの固定IPのプロキシを使用するように努めてください。これは、Googleの保護システムにとって、単にその国に住んでいるユーザーの通常の行動として見えるため、疑わしい活動とは見なされません。
複数のプロジェクトやキーを同時に扱っている場合、Dolphin AntyやAdsPowerのようなアンチデテクトブラウザを使用してプロファイルを隔離する場合は、各プロファイルに固定された地理的位置のプロキシをバインドしてください。これにより、1つのプロジェクトが他のプロジェクトの混合IPから疑いを引き起こすリスクが減ります。
また、Gemini用の無料または共有プロキシを他の高負荷のタスクと同時に使用することは避けるべきです。1つのIPからの多数の並行セッションは、Googleレベルでのレート制限や一時的なブロックのリスクを高め、これは地域の問題と同様に見えますが、原因はまったく異なります。
結論
Gemini CLIとGemini Code Assistの地域制限は、ネットワークレベルで解決されます。プロキシは、システムの環境変数、VS Codeの設定、およびGoogle Cloudを使用する場合はgcloudの設定に同時に記述する必要があります。そうすることで、すべての3つのエントリポイント(CLI、IDE拡張、OAuth認証)が同じIPを介して同期して動作します。完全に作業を開始する前に、単純なcurlリクエストで接続を確認してください。これにより、問題が実際にはコードではなくプロキシの国にある場合に、診断にかかる時間を節約できます。
Gemini CLIを安定して日常的に使用するには、固定された地理的位置と長期間のスティッキーセッションを持つレジデンシャルプロキシが最適です。これらは通常の家庭用IPのように見え、Googleによる追加の確認を引き起こすことはほとんどありません。もしレジデンシャルアドレスが地理的フィルターに引っかかる場合は、モバイルプロキシを試してみる価値があります。また、長いセッションなしでAPIを迅速にテストするには、データセンタープロキシが十分です。