GitHub Copilot 無法使用?Clash 連線逾時這樣處理

先判斷是登入失敗還是補全連線逾時

GitHub Copilot 無法使用時,畫面上的錯誤訊息不一定能直接指出原因。登入失敗通常發生在 GitHub 帳戶授權、瀏覽器回呼或驗證請求階段;補全卡住則多半發生在 VS Code 擴充功能向 Copilot 服務建立長連線時。若錯誤內容包含 ETIMEDOUT、ECONNRESET、socket hang up、proxy error 或長時間沒有回應,應優先檢查 Clash 的代理路徑,而不是立即重新安裝 VS Code。

先記下問題出現的具體位置:是 GitHub 登入頁面無法開啟、授權完成後回不到 VS Code、Copilot 圖示顯示未登入,還是編輯器已顯示帳戶名稱但補全一直轉圈。這些狀態涉及不同網域與不同請求,瀏覽器能開啟一般 GitHub 頁面,也不能證明 Copilot API 已經可以連線。

測試時應先關閉其他代理擴充功能、VPN 或第二個 Clash 用戶端,只保留一條明確的網路路徑。Clash Verge Rev、Mihomo 或其他圖形化客戶端都可以使用相同的排查思路,但選單名稱可能不同。先確認目前真正執行的核心、系統代理連接埠,以及 VS Code 是否讀取作業系統代理。

確認 Clash 代理模式與本機連接埠

GitHub Copilot 使用的是 HTTPS 請求與長時間維持的連線,通常需要讓 VS Code 將流量交給 HTTP 或 mixed-port。只開啟 Clash 的 TUN,不代表所有應用程式都一定會依照預期被接管;反過來,僅開啟系統代理也不代表 VS Code 的獨立設定沒有覆蓋系統值。

在 Clash 用戶端中先確認模式為 Rule,不要在排查期間使用不熟悉的全域或直連模式。記下目前生效的監聽連接埠,例如 7890。常見的簡化設定如下,實際數值必須以用戶端目前顯示的設定為準:

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

接著確認系統代理已開啟,且 HTTP、HTTPS 代理都指向同一個本機連接埠。Windows 可以在命令提示字元執行 netstat -ano | findstr 7890;macOS 或 Linux 可以執行 lsof -nP -iTCP:7890 -sTCP:LISTEN。沒有監聽結果時,先處理核心未啟動、連接埠被占用或設定載入失敗,不要在 VS Code 中反覆登出登入。

可以用 curl 測試本機代理是否真的能建立 HTTPS 請求:

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

這兩個命令成功,只能證明本機到 Clash 以及 Clash 到指定網域的基本路徑可用。Copilot 服務還會使用其他端點,因此下一步仍要觀察 VS Code 實際發出的網域。如果 curl 顯示 Connection refused,通常是連接埠錯誤或 Clash 未監聽;如果長時間逾時,則應檢查策略組、節點品質與規則命中結果。

檢查 VS Code 是否使用正確代理

VS Code 通常可以使用系統代理,但其網路行為也會受到自身設定、啟動參數與擴充功能實作影響。開啟設定後搜尋 http.proxy,確認是否存在舊的代理位址。若這裡填寫了已停止使用的連接埠,例如 127.0.0.1:7891,即使 Clash 系統代理指向 7890,Copilot 仍可能連到錯誤的本機端口。

一般情況下,可以暫時清除 http.proxy,讓 VS Code 使用作業系統代理;若系統代理在目前平台上不穩定,也可以明確填入 Clash 的 HTTP 或 mixed-port。代理值通常應寫成以下形式:

http://127.0.0.1:7890

http.proxySupport 也值得檢查。若設定被改為停用,部分 VS Code 網路功能與擴充功能可能不會使用代理。排查期間可先恢復為預設或自動狀態,再重新載入視窗。若環境需要嚴格驗證 TLS,還要確認 http.proxyStrictSSL 沒有因為公司代理憑證或錯誤的自簽憑證而造成握手失敗;不建議為了繞過錯誤而長期關閉憑證驗證。

修改設定後使用命令面板執行「Developer: Reload Window」,再重新觸發一次登入或補全。不要只重新啟動擴充功能,因為 VS Code 進程啟動時可能已經讀取了代理相關環境。如果 VS Code 是由桌面捷徑、終端機或遠端工作階段啟動,不同啟動方式也可能得到不同的環境變數。

查看擴充功能與開發人員記錄

開啟「View: Output」後,在輸出頻道中選擇 GitHub Copilot 或相關的 Copilot Chat 頻道,重新執行一次操作。記錄中的網域、錯誤代碼和失敗時間可以與 Clash Connections 對照。若輸出顯示代理連線失敗,但 Clash 沒有請求,代表 VS Code 尚未把請求交給目前這個 Clash 實例;若 Clash 顯示已命中節點,則應查看節點回應與 TLS 錯誤。

為 GitHub 與 Copilot 網域檢查規則命中

Copilot 不只存取一個 GitHub 網域。登入、帳戶驗證、API 請求、補全服務與擴充功能更新可能使用不同的主機名稱,實際端點會隨 VS Code 版本、Copilot 擴充功能版本與服務端調整。排查時不要只新增一條「GitHub 直連」規則,也不要把所有相關網域永久寫死成某一個節點。

在 Clash 連線記錄中,依序觀察登入或補全時出現的主機名稱,以及它們最後命中的規則和策略組。常見的基礎網域包括 github.com、api.github.com,Copilot 服務還可能使用 githubusercontent.com 或其他專用服務端點。這些名稱只能作為排查線索,不能視為每個帳戶和每個版本都固定不變的完整清單。

若規則將 GitHub 請求誤判為 DIRECT,而目前網路環境無法直接連線,就會出現登入逾時或補全無回應。若所有 GitHub 請求都被送往一個延遲很高、頻繁重置或不支援長連線的節點,也會產生類似症狀。規則通常由上到下比對,因此自訂規則必須放在寬泛的 GEOIP、MATCH 或其他兜底規則之前。

rules:
  - DOMAIN-SUFFIX,github.com,COPILOT
  - DOMAIN-SUFFIX,githubusercontent.com,COPILOT
  - DOMAIN,api.github.com,COPILOT
  - MATCH,DIRECT

以上只是說明規則排列方式的範例,COPILOT 必須替換成設定中已存在的策略組名稱。不要直接複製不存在的策略組,也不要在沒有確認域名用途的情況下把所有請求都送往代理。加入規則後,先重新載入設定,再從連線記錄確認實際命中結果。

排查 DNS、TLS 與 Fake IP 造成的逾時

如果 Clash 連線記錄中出現了目標網域,但請求在建立連線前就失敗,DNS 是重要檢查項目。錯誤的本機 DNS、被攔截的加密 DNS、無法連線的上游伺服器,都可能讓 GitHub 或 Copilot 網域解析到不可用的位址。先在終端機檢查解析結果,再與 Clash 的 DNS 日誌對照:

nslookup github.com
nslookup api.github.com
curl -v -x http://127.0.0.1:7890 https://api.github.com

若使用 Mihomo 的 Fake IP 模式,應確認 Fake IP 過濾清單沒有誤把需要代理解析的網域排除,也要確認 TUN、DNS 劫持與系統 DNS 沒有同時被多個工具接管。排查期間可以暫時使用較簡單的 DNS 配置,先驗證一般代理是否成功,再恢復進階的分流策略。不要在不了解整份設定的情況下刪除全部 DNS 區段,因為這可能使其他網域的規則判斷一併失效。

TLS 錯誤則可能與系統時間、代理中間人憑證、企業安全軟體或錯誤的 HTTPS 代理協定有關。Clash 的本機 HTTP 代理通常仍以 http://127.0.0.1:7890 形式提供,不能因為目標是 HTTPS 就擅自把本機代理值改成 https://127.0.0.1:7890。如果日誌出現憑證名稱不符、未知簽發者或握手被重置,應先確認是否存在公司網路的 TLS 檢查,再決定是否需要安裝受信任的企業憑證。

更換節點並重新建立 Copilot 工作階段

規則正確不代表目前節點適合 Copilot。補全請求對穩定性、持續連線和回應延遲較敏感,節點即使可以載入一般網頁,也可能在較長的請求中被重置。先在 Clash 中選擇延遲較低、封包遺失較少的節點,避免在排查期間使用自動切換頻繁的策略組,否則每次測試的出口都不同,難以比較結果。

更換節點後,不要立即判定問題已經解決。先關閉 VS Code 的 Copilot 登入工作階段,再重新載入視窗,必要時完全退出並重新啟動 VS Code。登入回呼失敗時,檢查系統預設瀏覽器是否也經過同一個 Clash 代理;瀏覽器若使用另一個擴充功能或 VPN,授權流程可能回到錯誤的網路路徑。

  1. 固定一個節點。在策略組中手動選擇單一節點,暫停自動選擇或故障轉移。
  2. 重新載入 VS Code。執行重新載入視窗,確認代理設定已被新工作階段讀取。
  3. 重新登入帳戶。從帳戶選單登出 GitHub,再使用瀏覽器完成一次授權。
  4. 觀察兩份記錄。同時查看 Copilot 輸出頻道與 Clash Connections,確認請求進入正確策略組。
  5. 測試補全和聊天。先在小型程式碼檔案中測試補全,再測試 Chat,避免一次啟用多個因素。

如果重新登入成功但補全仍然逾時,問題通常不在帳戶授權本身,而在 Copilot 服務端點的規則、節點長連線能力、DNS 或 VS Code 擴充功能代理相容性。此時應保留錯誤時間、核心日誌、命中規則與節點名稱,方便進一步比較。

依序完成最後驗證並避免設定反覆失效

修復後建議按照固定順序驗證,而不是同時修改多個設定。第一步確認 Clash 核心正在運作且本機連接埠可監聽;第二步用 curl 通過同一個代理測試 GitHub API;第三步確認 VS Code 的 http.proxy 沒有指向舊連接埠;第四步從連線記錄確認相關網域命中預期策略;最後才重新登入並測試 Copilot 補全。

  • Clash 狀態:核心已啟動,系統代理或 TUN 只有一個工具負責接管。
  • 連接埠:VS Code、終端機與系統代理沒有混用不同的本機端口。
  • 規則順序:GitHub 相關規則位於兜底規則前,策略組名稱確實存在。
  • DNS:目標網域可以解析,Fake IP、DNS 劫持與其他 VPN 沒有互相衝突。
  • 節點品質:節點能穩定維持 HTTPS 請求,不只是短暫開啟首頁。
  • VS Code:代理設定、憑證驗證和 Copilot 輸出記錄沒有殘留舊值。

若問題只在公司、校園或特定 Wi-Fi 出現,還要考慮防火牆、TLS 檢查、DNS 政策與網路出口限制;若所有網路環境都失敗,則應比較不同節點、不同核心版本與另一台裝置的結果。完成排查後,刪除暫時加入的測試規則,恢復必要的憑證驗證,並保留一份可回復的 YAML 設定,避免一次性的修復變成長期暴露或錯誤分流。

下載Clash