検索される症状:Gemini CLI だけ総合タイムアウトに見えるとき

2026 年時点でも、IDE 統合より先にターミナルのエージェント/CLIへ寄せるワークフローが厚くなっており、名前に Gemini が載る開発者向けコンポーネントも増え続けています。現場での相談は「ブラウザや別アプリは安定しているのに、シェルから叩いた Gemini CLI だけモデル一覧は出るが推論だけ切れる」「初回のみ npm の取得だけが固まって全体コマンドが落ちる」「OAuth の画面は通ったのに curl 相当がコア側でだけ失敗する」といった段階的な詰まりを伴いがちです。

ここでの誤解は、体感は一つの処理に見えることと、ネットワーク上は並列フェッチされた別ホストへ伸びたコネクション集合であることのギャップです。Google AI が担う短命な往復と、開発者ワークフローに強く依存する npm と GitHub CDN、さらにはアカウント系の名前が同居すると、単一ノードまたは単一規則のままでも「ログのどれか一匹が遅いだけ」が総合タイムアウトへ見える現象になります。このため Gemini CLI と Clash の組み合わせ議論でも、名前のリスト暗記よりも自分の環境ログで並んだ FQDNを一次情報へ据える順序が合います。

本稿は製品ごとの実行ファイルの細部より、Google AI API 分流とインフラ系ドメインの切り離しという設計指針に絞ります。ウェブ側の Gemini 安定化は別稿のChrome の Gemini Skills 向け稿と棲み分けし、両方を読んでも視点が衝突しないようにします。

ブラウザの Gemini とターミナル CLI とで何が違うか

Chrome 側は OS の証明書ストアやアプリ単位プロキシ、同期まわりの名前が強く効きます。一方でターミナル側は Go や Node 由来のランタイムが環境変数を無視しやすかったり、自己更新チェックが単発の別ホストへ飛んだりすると、画面上の結果とログの並びが説明できなくなります。Gemini CLI プロキシの話になると、この「シェルの差」を先に置いておかないと、頑張って書いた広い規則がそもそも CLI に届いていないだけ、という結果に時間を溶かしやすくなります。

macOS のターミナル環境変数稿と同様、HTTPS_PROXY/ALL_PROXY/大小文字の両方/NO_PROXY の優先順位を一覧にしておくと、Clash に着く前に片付く例が増えます。Linux で systemd に載せている場合や WSL と Windows が二重にある場合でも、評価点が二つあるだけでログの読み間違えが増える点は共通です。

三つの論理バケツ:Google AI・npm・GitHub CDN

運用フェーズでの心理ラベルとして、実ノード名称は当面同じでも良いので、次のような三分割から始めると議論が速くなります。

  • Google AI と短期セッション:generativelanguage.googleapis.com をはじめ、生成系 API と密接な googleapis/google AI サービス側の名前。体感は短命な往復の集合ですが、この塊だけレート上限やキュー運用があると応答体感が決まります。
  • レジストリと tarball CDN:registry.npmjs.org やログに転がる tarball ホスト。npm がリダイレクトで別 CDN を指すとき、apex だけ合わせても説明できないため、転送一覧をログ側で増やしていく思考が効きます。詳しくはnpm/tarball 分流稿で手順そのものが整っています。
  • GitHub とオブジェクト配信:github.com、objects.githubusercontent.com、必要に応じて codeload.github.com や release-assets.githubusercontent.com まで。単体更新や鍵チェックだけが外向きにあるケースがあるため、開発者ワークフローとは別グループへ分けてログを並べられます。GitHub CDN Clash のような語で検索する読者にも、この塊だけを単独で触れる設計があると親切です。

ほかにも Google アカウント系や同意画面に伴う名前が増えます。ここでのテクニックは、まとめる対象そのものより自分の環境ログで増えていく順に DOMAIN 行へ確定代入することです。DOMAIN-KEYWORD,google のような広い条件はサービス線を跨ぐ誤爆を招きやすいので避けます。

なぜ三出口にするとタイムアウトが読みやすくなるか

Gemini CLI Clash と調べている読者でも、結果としてほしいのは速さの競争より説明できる安定性であることが多いです。低遅延が欲しい塊と、帯域の太さや安定キュー運用が欲しい塗り分けが同じ実ノード名で共有されていると、片側だけキュー滞留が起きます。並列フェッチがある CLI ほど、そこでの待ち時間が総合処理のウォッチドッグに引っかかったように見えるのです。

その意味で論理グループだけ先に増やしても問題ありません。GOOGLE_AI・DEV_REGISTRY・GITHUB_CDN のように並べて最初はすべて同じ物理ノードにぶら下げ、タイムアウト再現セットを二度走らせ、ログへ落ちた名前をバケツから少しだけ動かしていく順が安全です。この段階はClash 分流入門稿の「狭い特例を広いリストよりも手前」の原則と完全に線がつながります。

ログから逆算するときの粒度

ターミナルで体感したいのは、UI のスピナー単位より並列フェッチ単位の成否です。タイムスタンプを基準に、失敗報告が出ている行のほか二秒ぶんだけ前後へ視線を動かしてください。複数ブラウザを閉じた状態で単体コマンドを再現させるほど、この逆算も早くなります。

最初にヒットしているルール行が直感と違えば、その時点ですでに上流で吸い込まれているので、上流のリストと自作規則の順序競合へ戻ってください。この読み込み順は購読更新で静かに崩れるため、リストを更新したタイミングだけ改めて再確認するとよいです。購読のモジュール化はRule Providers 稿と相性があります。

OpenAI 側の類似ワークフローはCodex CLI 向け稿に寄せられるため、両方読むと「モデル側短期セッション」と「開発者インフラ塊」を言語へ写し替えるのが楽になります。ドメイン名は一致しない前提で思考してください。

YAML の骨格例(ログでの置換が前提)

環境によりノード名と購読内容が変わるため、ここは読みもの用スケッチに留めます。コメントだけ英語に統一しました。

# Sketch — replace endpoints after confirming them in Mihomo/Core logs
proxy-groups:
  - name: GOOGLE_AI
    type: select
    proxies: [LATENCY_FIRST, FALLBACK_AUTO]

  - name: DEV_REGISTRY
    type: select
    proxies: [BW_STABLE, LATENCY_FIRST, DIRECT]

  - name: GITHUB_CDN
    type: select
    proxies: [BW_STABLE, LATENCY_FIRST]

rules:
  - DOMAIN,generativelanguage.googleapis.com,GOOGLE_AI
  # - DOMAIN,googleapis.com,GOOGLE_AI  # widen only after log proof
  - DOMAIN-SUFFIX,registry.npmjs.org,DEV_REGISTRY
  - DOMAIN-SUFFIX,github.com,GITHUB_CDN
  - DOMAIN-SUFFIX,objects.githubusercontent.com,GITHUB_CDN

DOMAIN-SUFFIX,googleapis.com は広いので、アカウント側や広告配信側など別用途と干渉しがちです。サービス側のラベル転換だけで増え続ける時代なので広い一行はゆっくり育てる運用でも十分です。また DOMAIN と DOMAIN-SUFFIX の優先評価に注意してください。apex のサフィックスだけを足してしまうと、アプリ側が完全一致のホスト名で叩いているケースだけ取りこぼす典型が起きます。

DNS と fake-ip:ルール以前の潜り込み経路

Google AI API 分流を書いても、名前解決が別キャッシュまたは別経路へ滑ると結果がフラつきます。DNS とコアログ稿で述べた通り、dig と画面の両方へ同じ質問へ投げ直すのが手堅く、Secure DNS とルータ転送だけ切り離して短時間比較するのも効きます。たまりやすいのはブラウザは成功しているのに CLI がダメというパターンで、並列名前解決だけがズレて TLS の再試行に見える状況です。

ルール評価順と GEOIP との距離感

国内向けリストや広い直行が自分で書いた Google AI 特例よりも手前にあると、そのまま増やして無意味なリストができるので注意です。GEOIP,CN,DIRECT のような行を上流から眺めなおし、アプリ開発者ホストだけは少しだけ手前へ移す順で改善が出るときがあります。リストは一度に大量へ寄せ過ぎない方が、この後ログで追い込みできます。

QUIC と TUN、システムプロキシの切り替え実験

HTTP/3 と QUIC が混じるとき、見かけだけ HTTP/2 と同様に処理してしまうと、症状がフラつきます。QUIC 切り分け記事とセットで頭に置いておくと、CLI のHTTPスタックだけが別プロトコルを使うときの二分が楽です。また TUN とシステムプロキシのどちらで症状が変わるかだけでも、環境変数無視問題を切れたりできません。

チェックリスト:現場での短時間切り分け

  1. 失敗操作を短文で二度再現させ、並列ウィンドウを閉じた状態だけを証拠セットにしてください。
  2. コア側リアルタイムログでタイムスタンプ単位へ寄せながら、失敗行のほか並列にある成功行も列挙してバケツ振りしてください。
  3. 最初マッチだけをスクリーンショットに残し、自分が追い込みたい GOOGLE_AI 行よりも思いのほか上流で吸い込まれていないかを確かめてください。
  4. npm だけ問題なら .npmrc の実効ミラーとログの転送チェーンだけを単体で追い、その後にインフラ用バケツのノード差し替え実験へ進んでください。
  5. GitHub が怪しいときは Releases オブジェクトのみ失敗しないかだけを単体チェックすると、CDN 名前の増減に敏感な運用になります。

サービス規約と職場ポリシー

モデル提供者の利用規約、職場のセキュリティ方針、データ所在地の要件は読者側の確認範囲です。正当な権限のある環境で到達性を改善する説明のみを対象としており、制限への迂回も助長しません。
外部ノードへ Google AI を載せると、そのノード事業者のログ保管にも触れるため、開発効率だけでなくリスク評価とセットで運用してください。

よくある質問

Chrome 向けリストを丸ごと流用すると抜けるか

一部は共通しますが CLI 固有のアップストリームにより不足が続きやすいです。二次情報リストはヒントだけにしてください。

apex だけ合わせれば十分という判断は妥当か

まれに妥当ですが、ログで別サフィックスだけが増え続ける時代なので、並列リストを増やしていく運用へ寄せる安全域が広いです。

ミラー npm を強制すべき環境があるか

企業内レジストリや国内ミラーへ向ける設計があるなら論理グループを分離してしまった方が、Google AI と独立して説明しやすいです。

競合観点、Clash の強み、ダウンロードへ

広く売られている単純な VPN ブラウザ拡張やワンクリック製品には、開発者ワークフロー単位での複数インフラ塊への分流が弱く、並列フェッチ環境での説明にもフィールドが狭いタイプがあります。ノード一覧はシンプルな反面、自分の環境ログを起点に増やしていくときの自由度が足りません。

Clash/Mihomo 系ではポリシーグループとルール評価言語により、名前が増えるたびにも対応順を自分で握り直せます。Gemini CLI と Clash はドメイン育成フェーズとも相性が良く、「どの出口を動かすとだけ症状が進むか」を短文で議論できる体制ができるのが強みです。

クライアント入手元を揃えながら、本文順に微調整したいときは本站のクライアントダウンロードページで現行ビルドを確認できます。

→ Clash を無料ダウンロードし Gemini CLI と Google AI・npm をログで読み解ける出口設計へ

ダウンロードページへ進む