先釐清症狀:為什麼「瀏覽器正常,終端機卻一直逾時」?

如果你在 VS Code/Cursor/JetBrains 外掛或純終端機裡使用 Claude Code(市面常見的 claude CLI 工作流程),最典型的挫折往往不是完全斷線,而是拉工具、mcp、bootstrap 套件與對話請求混在一起時,某一條路徑變慢就把整個體驗拖成轉圈圈。瀏覽器開 Claude 網頁可能還順,但回到命令列就只收到逾時;這通常代表不是所有流量都經過你以為的那一條代理鏈路。

Anthropic API 這類小封包、延遲敏感連線,與npm registry 取 metadata、再到 tarball 所經過的 CDN 主機名稱,本是兩種流量性格;如果再疊上從 GitHub CDN 拉的 release、原始碼壓縮包、或是 raw.githubusercontent.com/objects.githubusercontent.com,任何一個桶若被規則誤判為直連或被 DNS 指到不理想的上游,整段 CLI 體驗都會像是「Anthropic 壞掉了」——但其實是並行請求中有子請求掉队。

更麻煩的是:終端程式常常不吃 macOS/Windows 的系統代理。圖形介面用戶端顯示已連上 Clash,並不保證 node、npm、與 Claude Code 的子行程都會自動帶上 HTTPS_PROXY。這也是為何要把「環境變數與進入核心的方式」放在與規則同等的優先級。若你正要處理純終端環境變數,可先對照本站macOS 終端機代理與 Shell 環境變數一文,再回到本文做網域級分流。

把流量桶分開:Anthropic、registry、GitHub 不是同一條業務

要寫出可維護的代理分流,建議先接受一件實務事實:Claude Code 在背景可能同時觸及多類主機,而不是單一 anthropic.com 能概括。下面用四個「桶」思考,之後再對應到策略組與規則。

第一桶是推理與 API 控制面:常見包含 api.anthropic.com 這類端點(實際主機名稱請以你當下版本的連線日誌為準)。這裡封包小、連線品質敏感,最怕與「大檔下載」綁在同一個會頻繁切換節點的 url-test 組,導致長連線被打斷而表現成逾時。

第二桶是npm registry 與 tarball 下載鏈:除了 registry.npmjs.org 查版本,實際 tgz 往往落在另一組 CDN 主機上;若你使用國內鏡像或企業私有倉,還會再多一層命名空間。這條路徑與 API 不同之處在於頻寬與 TCP 視窗行為,可能更適合穩定但未必延遲最低的出口。站內Node.js/npm/pnpm 與 tarball CDN 分流專文已把 JavaScript 套件鏈寫得很細;本文則把同一套方法論接到「Claude Code 同時打 Anthropic」的場景,避免你只優化 registry 卻讓 API 仍走錯路。

第三桶是GitHub 與相關靜態網域:工具下載、擴充原始檔、CI 腳本或子模組常命中 github.com、codeload.github.com、objects.githubusercontent.com 等。把它們與 npm 混成同一桶不是不行,但在除錯時會失去「一眼看出是 Git 物件還是 registry tarball」的能力;對開發工具鏈而言,分桶通常更省時間。

第四桶是帳號、文件與次要追蹤網域(若你的 CLI 會開啟裝置授權或重新導向網頁):這類流量對規則寬度的要求不同於純 API。站內Claude 網頁版 Anthropic 分流以瀏覽器體驗為主;本文CLI 與 IDE 優先,但若你發現 OAuth 或小視窗載入異常,仍應回看該文的網域家族整理與對照。

策略組怎麼命名:ANTR-API、NPM-GH、ARTIFACT

建議準備至少三個語意清楚的策略組(名稱自訂即可),例如 ANTR-API(Anthropic/Claude Code 對話請求)、NPM-REGISTRY(含你觀察到的 tarball 主機)、GH-CDN(GitHub 與發佈相關靜態)。重點是在日誌裡讀得懂,而不是把所有東西都叫 PROXY。

Anthropic API 專用組可放你一顆延遲穩定的手動選擇節點;npm registry 與 GitHub CDN 則可以放另一組偏頻寬或對分段下載較友善的線路。這樣當懷疑「代理反而拖慢套件安裝」時,你只切換 NPM-REGISTRY 對照即可,無需推翻整張規則表。

下列 YAML 僅示意結構;欄位與語法請以你所用的 Mihomo/Clash 版本為準,規則內註解一律使用英文,方便複製到其他範本。

proxy-groups:
  - name: ANTR-API
    type: select
    proxies:
      - NODE-LATENCY-STABLE
      - DIRECT
  - name: NPM-REGISTRY
    type: select
    proxies:
      - NODE-BULK
      - DIRECT
  - name: GH-CDN
    type: select
    proxies:
      - NODE-BULK
      - DIRECT

rules:
  # Place BEFORE broad GEOIP / catch-all Rule Providers where possible.
  # Replace domains with hosts you actually see in logs.
  - DOMAIN,api.anthropic.com,ANTR-API
  - DOMAIN-SUFFIX,npmjs.org,NPM-REGISTRY
  - DOMAIN-SUFFIX,npm.pkg.github.com,NPM-REGISTRY
  - DOMAIN-SUFFIX,github.com,GH-CDN
  - DOMAIN-SUFFIX,githubusercontent.com,GH-CDN

範例中的後綴規則可能仍然過寬;實務上應先看日誌再收斂,必要時改用 DOMAIN 精準匹配或分拆 rule-provider。若想維護可更新的片段檔,可延伸閱讀Rule Providers 教學。

規則順序:為什麼寫了 Anthropic API 分流卻像沒生效?

Clash/Mihomo 規則由上而下命中即停。若你把超大第三方規則集載入得很前面,而其中含有過寬的直連段落,就很容易把應該走 ANTR-API 的請求提前收成 DIRECT,後面即使再寫 api.anthropic.com 也讀不到。

實務上建議順序:本機/區網/明確放行 → 你已用日誌確認過的 Claude Code/Anthropic/npm/GitHub 規則 → 其餘一般上網與 GEOIP 兜底。這與許多教程把「國內直連」放很前面的作法看似衝突,但對開發者工具鏈而言,寧可讓已知開發域名先被精確接住,再交給大段規則集,才不會呈現真假隨機的逾時。

若你使用 IDE 並行擴充市集與 Git 操作,也可把情境與Cursor/GitHub 分流對照:那篇偏 IDE 市集;本文偏終端套件與供應商 API,並行使用時可把規則分檔維護,避免單檔千字規則難除錯。

DNS 與 fake-ip:誰在解析、誰在連線

第二個常見戰場是 DNS。徵兆包括:同一台機器瀏覽器正常,終端程式卻間歇連不上;或是某些子指令永遠失敗。Anthropic API 與npm registry若在解析階段就拿到你不預期的位址類型(例如某公司內網劫持、或被導向與規則假設不符的紀錄),TCP 連線階段就會完全符合「逾時」外觀。

請把排查濃縮成一句:先確認誰在回答 DNS,再確認誰在發起連線。使用 fake-ip 時,務必理解部分程式若自行走系統/DoH 解析,會與核心假設錯位。可依序參考本站使用說明與文件以及連線看似正常但無法上網的日誌排查,把 DNS 模式與規則放回同一張圖。

另外請留意過於強硬的廣告或追蹤攔截:有些驗證或分析子網域被拒絕時,CLI 只會報泛用逾時。先看日誌是否 REJECT,再決定是否放行。

UDP、HTTP/3 與 TLS:別把全部都怪在 Claude Code

當問題表現為「握手很久」而非立即拒絕,請同步檢查 UDP 路徑與節點能力。某些環境對 QUIC 不完整支援時,會讓部份資源卡住而其它正常。可先對照QUIC/HTTP3排查文中的實驗流程,再回到本場景對照是哪一種主機名稱異常。

驗證流程:讓問題可重現、可對照日志

請盡量單因子改動;下列步驟可依序做一次就記錄結果。

  1. 確認流量真的進核心:依環境選 TUN、系統代理,或為終端設定 ALL_PROXY/HTTPS_PROXY;並排除第二套 VPN 搶路由。
  2. 重現問題當下開連線日誌:過濾 anthropic、npm、github、objects 等字串,以實際主機為準。
  3. 檢查策略組命中:Anthropic API 是否落在 ANTR-API?npm registry 與 tarball 是否落在預期的 NPM-REGISTRY?GitHub CDN 請求是否在 GH-CDN?
  4. 分桶 A/B:暫時只改 API 組、套件組維持不變,觀察逾時是否消失;再輪流只改 NPM 或只改 GH。
  5. 對照環境變數:若懷疑子行程沒跟上代理,回到 Shell 載入順序與 IDE 繼承變數檢查。

若你希望把另一家供應商的 CLI 對照來看,OpenAI Codex CLI 分流描述了相近的終端拆分邏輯;兩邊並讀能快速建立「終端開發代理」共通心智模型。

與站內其他 Anthropic/npm 專題的關係

網頁版 Claude/Anthropic 分流著重於瀏覽器體驗與多個 Claude 前端網域;本文則以 Claude Code/claude CLI在終端機同時拉扯 Anthropic API、套件與 Git 物件的情境為軸。純 npm專題則更深耕 registry 鏈每一跳。三者並非重複,而是同一方法論在不同「主要痛點」上的切片。

合規與安全

請遵循所在地法令、雇主資訊安全政策與 Anthropic、GitHub、npm 等供應商條款。代理與分流僅協助你做網路路徑可觀測與可控,而非繞過合規管制。請只信任來源明確的訂閱與規則集,並定期更新用戶端。想了解開源授權可至官方存放庫;安裝套件與程式仍建議優先使用本站整理的入口對照版本,而非在發佈頁眾檔名中盲選。

總結

Claude Code在終端的逾時,往往是 Anthropic API、npm registry 與 GitHub CDN 並發時其一掉鏈的結果,再疊上加終端不吃系統代理或 DNS 鏈路錯位。把它們拆成可命名的策略組、把好用的精確規則放在大段 GEOIP/第三方集合之前,並用連線日誌驗證,通常比全屋換節點更有效。對需要細粒度調度的開發者來說,Clash/Mihomo 在規則表達與觀測上仍相對友善,能把「終端很慢」收成「哪一跳主機、哪一桶策略出了問題」。若你希望長期省力,請維護可讀的日誌習慣與可分檔規則片段。

相比僅仰賴單一出入口,將工具鏈各類請求分道而行,往往能同時保住對話的低延遲與套件下載的穩定度。

→ 立即免費下載 Clash,開啟流暢上網新體驗