為何 Google Agents CLI／google-agents-cli 安裝特別容易卡住
google-agents-cli（常被稱為 Agents CLI 或 Google Agents CLI）用一條或多條公開指令把技能包、範本工程與發佈鏈路拉起來，但對底層來說這幾乎永遠會帶出混合型下載：PyPI 發佈輪、GitHub tar／Release 物件、npm registry／scope 來源，以及視雲端組態而定的 GCP 相關 HTTPS 端點。任何一種主機若在策略上被誤判為 DIRECT（直連），就可能在弱出口下表現成「整個安裝卡住」；對排錯者來說只看到重試，卻缺少主機粒度證據。與單一 SaaS API（只打幾個已知網域）不同，發佈鏈路更依賴 CDN 與儲存後端，這些名字不能靠靜態臆測長期完整，必須以你自己的 Clash 紀錄為準補規則。
另有一個常見錯覺：「瀏覽器能載入說明書＝終端已可安裝」。實務上瀏覽器常走系統 HTTP／HTTPS 代理設定；Python 與 Node 取用堆疊預設並不沿用該路徑，除非你匯出對應環境變數、工具內建代理欄位或由 TUN 在路由表層級接管對外視圖。因此本文把排查拆成三件事：流量是否進入 Clash（含直連異常）、發佈倉與 CDN 主機規則是否對應連線紀錄（以日誌補強，而不是背誦他人靜態清單）、以及 DNS／Fake‑IP 視圖與規則匹配是否對齊；以下各節依此順序展開。
若你同時在跑其他模型供應商 CLI，終端逾時的通用套路也可參考 Claude Code CLI 與 TUN／DNS；差別在於本篇補上 npm／uv registry 與 PyPI／GitHub 物件兩條更貼近開發工具鏈下載路的觀測軸。
1先復現，再用連線紀錄補主機清單
依官方文件準備 Python 3.11+、uv、Node 等前提後，直接執行你正在卡的那條指令；若文件建議 uvx google-agents-cli setup，就保持相同參數方便對照。並行在 Clash／Mihomo 圖形介面開啟連線清單，留意以下片語是否在逾時前後出現：files.pythonhosted.org、pypi.org、pypi.io、registry.npmjs.org、objects.githubusercontent.com、github.com。記下完整 Host／SNI 與該列顯示的策略組；若看到主機反覆落在 DIRECT，先把「地理／公司出口」與「預期走代理節點」兩者對照，而不是急著懷疑工具。
你也應把「安裝成功但非常慢」與「硬逾時」分開：前者可能是節點頻寬或快取；後者常伴隨 TLS 或路由黑洞。若同一時段瀏覽器下載測速正常，仍不代表終端路徑相同——請回頭檢查 shell 是否匯出 HTTPS_PROXY、Clash 是否僅系統代理而遺漏子行程。
2系統代理、環境變數與 TUN：先固定「誰在出外網」
當你確認多段主機都該走代理，卻仍看到 DIRECT，優先考慮兩條路之一：在當前 shell 匯出標準代理環境變數（常見 HTTPS_PROXY、HTTP_PROXY、必要時 ALL_PROXY，並補 NO_PROXY 排除內網），或啟用 Clash TUN 讓未主動支援代理的行程仍落入核心決策。TUN 與公司 VPN、防火牆、macOS 權限互動容易踩雷，建議先讀 Clash Verge Rev TUN 模式教學 再長開；另一策略是「只在安裝子 shell 暫時 export 代理」，完成後關閉，降低全域副作用。
實務建議：先用規則＋連線紀錄校準主機走向，再決定是否長開 TUN；並避免與另一套全隧道 VPN 爭搶預設路由。
若你在 WSL2 內執行 uv／pip，而 Windows 宿主已跑 Clash，請單獨檢查 WSL 的 DNS 與代理轉發是否對齊；可從 WSL2、Git、npm 與 Windows Clash 取得起手指南，再把相同觀測方法套到 PyPI。
3npm／npx：registry、憑證與策略組
Node 工具鏈對企業 HTTPS 檢查特別敏感：中介憑證未匯入信任庫時，錯誤訊息可能僅顯示泛用 TLS 失敗。排錯順序建議為：先確認 Clash 紀錄中 registry 主機的策略組，再檢查 .npmrc 是否鎖了鏡像卻仍需要跨境品質、或 proxy 埠與 Clash 不一致。除非完全理解風險，否則不要以此掩蓋問題為優先去關閉 strict‑ssl 類選項；多數情況是路徑或憑證鏈而非單純「npm 壞了」。
下列 YAML 僅示範規則骨架：請把 PROXY 換成你檔內真實策略組名，並依連線紀錄增刪主機；註解維持英文以符合設定檔慣例。MATCH 最後一跳請依日常習慣選擇代理或直連，並與除錯假設一致。
# Example only — replace PROXY; extend hostnames from your logs
rules:
- DOMAIN-SUFFIX,pypi.io,PROXY
- DOMAIN-SUFFIX,pythonhosted.org,PROXY
- DOMAIN-SUFFIX,npmjs.org,PROXY
- DOMAIN-SUFFIX,npm.community,PROXY
- DOMAIN-KEYWORD,github,PROXY
# If your ruleset exposes GEOSITE providers (Meta / Mihomo):
# - GEOSITE,google,PROXY
- MATCH,DIRECT4uv／pip：環境變數、PyPI 與發佈倉命名
uv 與標準 pip 類工具通常會遵循 HTTPS_PROXY 等常見環境變數，但仍可能受 Python 本身的憑證綁定影響。若規則已將 files.pythonhosted.org 送到代理策略組而 TLS 仍失敗，先把企業環境的中介憑證因素排除，再回到節點路徑。不要在尚未確認路徑前就把全域逾時調得極大：那只會放大「其實沒進代理」的等待成本。若發佈倉對某鏡像區域異常慢，評估是否要使用可信任的國內／公司鏡像並同步調整規則讓鏡像主機仍能走穩定的出口。
Python 發佈生態對「單套件永遠固定在同一個 CDN 標頭」並不為真；若以硬編記憶對照 subdomain，仍可能在新版本切換 CDN 後漏網。請把每次安裝日誌當增量資訊回填規則表或 rule-providers，而不是複製來路不明的超大清單卻無法驗證命中。
5DNS、Fake‑IP 與規則順序
TUN 並非取代 DNS tuning：當你看到「偶爾很慢、換個時間又正常」，多半與fallback DNS 競態、fake-ip-filter 漏項目或GEOIP／較早規則搶匹配有關。建議對照 Meta／Mihomo DNS 防洩漏指南，再把 PyPI／npm／GitHub 相關名稱與規則解析對齊。路由器透明代理＋桌面 Clash 並存時，也要避免雙層劫持卻搞不清楚優先順序。
提醒：HTTPS 解密或企業安全閘道會根本改寫終端取用端的信任模型；請先依公司資訊政策處理，不要僅以降低安全校驗當解法。
與站內 Claude／OpenRouter 類文章如何分工
若問題焦點是呼叫某模型 API 逾時而非拉套件，本篇僅側重發佈倉視角；可改讀 OpenRouter／TUN 對照 aggregator API。若你已處理 Hugging Face 大檔，亦可借用 HF Hub Clash 文對「大型二進位下載」的規則粒度心智模型。
6驗收入口：對照紀錄做最小對測
- 確認 TUN 或環境變數已生效後，對日誌中尚未安心的主機執行
curl -v類對照請求。 - 重跑官方文件建議的同組指令（維持相同環境）；期間對照紀錄中任一瞬間是否出現異常高的 DIRECT。
- 若命中正確但仍慢，換相容 UDP／QUIC 需求較佳的節點並重試。
- GCP／Agent Platform 控制台或推論端點若另行逾時屬身分與區域資源議題；請並行查官方狀態頁／配額，本文不延展至該側。
常見問題（摘要）
瀏覽器可看文件，為何 uv／npm 還卡住？路徑不同；請用環境或 TUN 統一路徑。.npmrc 代理為何無效？協定／埠／規則誤植或 TLS 問題。TUN 何時優先？複合行程難設定時。
開源與本站下載
Clash／Mihomo 與開源前端客戶端授權可於對應倉庫查閱；日常安裝建議優先使用 本站下載區 搭配 設定說明總覽 釐清模式差異並降低不明打包風險。google/agents-cli upstream 協議請以官方發佈頁為準，本文不提供替代發佈站。
結語
Google Agents CLI 安裝逾時往往不是單一端點，而是 PyPI／npm／GitHub CDN 與取用端對外視圖的疊加問題：先把 Clash紀錄對齊，再調整環境／TUN，最後談換節點，可避免「盲換節點卻仍以直連卡住」的假循環。TUN 能降低漏網，但並不取代縝密的 DNS 區段設定；請把發佈倉命名當會隨 CDN 漂移的對象來維護。
相較僅強調桌面捷徑的代理工具，Clash 搭配 Meta／Mihomo紀錄主機級命中，較適合 toolchain 複雜的工程師場景：npx 與 Python 發佈倉對外並行請求時，你能具體看到哪個 hostname 離開預期策略組並立即修規則。
若你希望把本篇流程落成日常桌面環境，歡迎先免費下載 Clash，對照紀錄補齊 google-agents-cli 安裝期間的外部主機並同步檢查 uv／npm 代理設定；這樣做通常能區分規則／DNS 視圖問題與單純鏈路品質。