Codex CLI 讓開發者可以直接在終端機中閱讀專案、修改檔案、產生程式碼與執行指令。對台灣、香港以及其他需要透過代理連線的使用者來說,真正影響使用體驗的往往不是安裝指令,而是終端機程式是否使用了正確的代理位址、Clash Verge 是否正在執行,以及目前節點能否穩定連線至登入與模型服務。

Clash Verge 的系統代理開關,不能保證所有命令列工具都會自動跟隨。瀏覽器通常會讀取作業系統代理,Codex CLI、Git、npm 或其他開發工具則可能依賴 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 等環境變數。因此,設定時應把問題拆成三段:Clash Verge 是否成功啟動核心、終端機是否能連到本機代理連接埠,以及 Codex CLI 是否能透過該連線完成登入與 API 請求。

Codex CLI 搭配 Clash Verge:台港用戶連線設定教學

先準備 Clash Verge 與本機代理

開始之前,請先確認已安裝仍在維護中的 Clash Verge 或 Clash Verge Rev,並確認其內部使用的核心類型與版本。兩者的介面名稱可能略有不同,但基本流程大致相同:匯入設定或訂閱、啟用一個設定檔、選擇代理策略,再開啟系統代理。若畫面中同時存在多個設定檔,必須確認目前標示為啟用或運行中的項目,因為匯入訂閱不等於核心已經使用該設定。

在 Clash Verge 的設定頁面中,先查看本機代理連接埠。常見值包括 HTTP 或 mixed-port 的 7890,但實際數字可能因版本、設定檔或其他程式佔用而不同。若設定頁面顯示的是 127.0.0.1:7890,代表本機程式可以使用這個位址;若顯示其他連接埠,後續所有環境變數與測試指令都必須同步修改。

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

這段 YAML 只用於理解欄位,不建議直接覆蓋訂閱內容。mixed-port 通常可以同時接收 HTTP 與 SOCKS5 請求,適合桌面工具共用;socks-port 則提供 SOCKS5 代理。allow-lan: false 只允許本機使用,對個人電腦較安全。若需要讓同一區域網路中的其他裝置連線,才考慮開啟區域網路存取,並同步檢查防火牆、監聽位址和存取安全性。

接著在 Clash Verge 中開啟系統代理。Windows 通常會將代理設定寫入系統網路選項,macOS 則會修改目前網路服務的代理設定。開啟後,可以先用瀏覽器造訪一般 HTTPS 網站,再到 Clash Verge 的 Connections 或連線頁面查看是否出現請求。若瀏覽器流量已經出現在連線記錄中,代表圖形介面與核心基本正常,但這仍不能證明 Codex CLI 已經使用同一條路徑。

匯入訂閱並選擇合適節點

在 Clash Verge 的 Profiles、設定檔或訂閱管理頁面中加入服務商提供的訂閱網址。不同服務商可能提供 Clash、Mihomo 或其他格式的訂閱,應選擇與 Clash Verge 核心相容的格式。如果同一服務商提供多個連結,優先使用明確標示為 Clash Meta、Mihomo 或 Clash 設定的版本;不要只把瀏覽器下載到的 HTML 錯誤頁面當作 YAML 匯入。

  1. 保存原始訂閱網址。訂閱 URL 可能包含帳戶識別或存取參數,應放在私人密碼管理工具或受控檔案中,不要貼到公開討論區。
  2. 加入並更新設定檔。匯入後執行更新,查看節點清單、策略群組與規則是否成功載入。
  3. 啟用目前設定。切換到剛更新的設定檔,確認核心狀態為執行中,而不是只有檔案存在。
  4. 選擇穩定節點。先使用延遲較低且連線穩定的節點,避免一開始頻繁切換自動選擇、負載均衡與故障轉移策略。
  5. 確認分流模式。一般情況可先使用 Rule 模式,讓網域依規則選擇策略;排查時不要同時改動模式、DNS 與 TUN。

對 Codex CLI 來說,節點的「延遲數字」不是唯一指標。終端機操作通常包含登入頁面、API 請求、長時間串流回應以及可能的程式碼傳輸。某個節點在簡單延遲測試中速度很快,卻可能在長連線、TLS 握手或串流回應時中斷。因此建議使用同一節點連續執行幾次測試,觀察是否出現逾時、連線重設或回應中斷。

為 Codex CLI 設定終端機代理

最容易驗證的方式,是在啟動 Codex CLI 的同一個終端機工作階段中設定代理環境變數。對使用 HTTP 或 mixed-port 的情況,變數值通常寫成 http://127.0.0.1:7890。即使目標網址是 HTTPS,代理變數也不一定要寫成 https://;這裡的 https_proxy 是「存取 HTTPS 目標時使用哪個代理」的變數名稱,並不代表本機代理服務本身採用 HTTPS。

macOS 與 Linux

在 Bash、Zsh 或其他相容 Shell 中,可以先設定目前工作階段的代理。請將 7890 替換成 Clash Verge 顯示的實際 mixed-port 或 HTTP port:

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

codex

部分支援 SOCKS 的工具也可以使用 ALL_PROXY:

export all_proxy=socks5h://127.0.0.1:7891
export ALL_PROXY=socks5h://127.0.0.1:7891

socks5h 中的 h 表示由代理端解析目標網域,有助於避免本機 DNS 先行解析造成的問題。不過並非所有程式都完整支援 SOCKS 或所有代理變數;如果 Codex CLI 對 SOCKS 表現不穩定,應先改回 Clash Verge 的 HTTP 或 mixed-port 測試。

若希望每次開啟終端機都自動套用,可將 export 指令放入 ~/.zshrc 或 ~/.bashrc,但不建議在不需要代理時永久啟用。更穩妥的做法是建立專案專用的啟動指令,或在需要時手動執行,避免本機服務停止後其他開發工具全部出現連線錯誤。完成修改後,使用 source ~/.zshrc 或重新開啟終端機使設定生效。

Windows CMD 與 PowerShell

CMD 中使用 set 只會影響目前的視窗:

set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890
set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890

codex

PowerShell 則使用目前程序的 Env 物件:

$Env:http_proxy = "http://127.0.0.1:7890"
$Env:https_proxy = "http://127.0.0.1:7890"
$Env:HTTP_PROXY = "http://127.0.0.1:7890"
$Env:HTTPS_PROXY = "http://127.0.0.1:7890"

codex

如果曾經設定過舊連接埠或其他代理服務,請先檢查並清除衝突變數。PowerShell 可以使用以下指令查看目前值:

Get-ChildItem Env:*proxy*
echo $Env:HTTPS_PROXY

Windows 使用者也可以在 Clash Verge 開啟系統代理後,使用明確指定代理的 curl.exe 測試,不要立即把問題歸因於 Codex CLI:

curl.exe -I -x http://127.0.0.1:7890 https://example.com

動手檢查 Codex CLI 的完整連線路徑

完成設定後,建議按照以下順序操作。每一步只驗證一個層次,這樣即使失敗,也能快速縮小範圍。測試時請避免在指令列、截圖或公開日誌中暴露登入憑證、API 金鑰、訂閱 URL 和專案中的機密環境變數。

  1. 確認核心正在執行。回到 Clash Verge 主畫面,確認目前設定檔已啟用,系統代理或本機代理服務處於開啟狀態。
  2. 確認本機連接埠。記下實際 HTTP、SOCKS 或 mixed-port,不要沿用網路文章中的預設值。
  3. 直接測試 HTTP 代理。使用 curl 或 curl.exe 指定本機代理,查看是否能取得 HTTPS 目標的回應。
  4. 檢查 Clash 連線記錄。執行測試期間,應在 Connections 中看到對應網域,並確認命中的策略不是意外的 DIRECT 或拒絕規則。
  5. 設定環境變數。在同一個終端機視窗匯出代理變數,再用不帶 -x 的 curl 測試,驗證程式是否能讀取環境設定。
  6. 啟動 Codex CLI。先在不含敏感資料的測試專案中執行登入或基本請求,確認命令列輸出與 Clash 連線記錄同時出現。
  7. 最後再啟用 TUN。如果一般系統代理已能正常使用,才單獨測試 TUN。TUN 會改變更大範圍的網路流量,應避免與環境變數代理同時反覆切換。

可以使用下面的檢查表記錄結果:

檢查項目 預期結果 失敗時優先查看
Clash Verge 核心 狀態為執行中,無設定解析錯誤 核心日誌、YAML 縮排、核心版本
本機代理連接埠 127.0.0.1 的指定連接埠正在監聽 連接埠占用、服務是否啟動、設定是否被覆寫
curl 明確代理 能取得目標網站的 HTTP 回應 節點狀態、規則命中、TLS 與 DNS
Codex CLI 能完成登入或發出基本請求 環境變數、帳戶設定、CLI 版本與錯誤訊息

若 curl 明確指定代理可以成功,但 Codex CLI 失敗,問題多半在環境變數未傳入、程式不讀取該變數、終端機啟動方式不同,或 CLI 自己使用了獨立的網路設定。若 Codex CLI 啟動後 Clash 完全沒有新連線,表示請求可能沒有經過這個 Clash Verge 執行個體。若連線記錄出現請求但最終逾時,則應檢查節點、規則、DNS 或長連線穩定性。

常見錯誤與排查方式

出現 connection refused

這通常表示終端機已經嘗試連到某個本機位址,但該連接埠沒有程序監聽。請先確認 Clash Verge 沒有被完全退出,再核對環境變數中的連接埠是否與用戶端畫面一致。若更換設定檔後連接埠被覆寫,也要以目前生效設定為準。Windows 可用 netstat -ano | findstr 7890,macOS 或 Linux 可用 lsof -nP -iTCP:7890 -sTCP:LISTEN 查看監聽狀態。

逾時或連線重設

這表示本機代理可能已收到請求,但代理到目標服務之間不穩定。查看 Clash Verge 的連線記錄,確認實際使用的策略組與節點,然後換用另一個穩定節點測試。若所有節點都逾時,檢查系統時間、DNS、網路防火牆與目前網路環境;若只有某一節點失敗,則不必先修改 Codex CLI 設定。

DNS 或 TLS 錯誤

終端機工具可能沒有使用 Clash 的 DNS 路徑,尤其在只設定系統代理而未啟用 TUN 時,本機解析仍可能先行完成。可先使用 socks5h 測試由代理解析,或在 Clash Verge 中檢查 DNS 模式與相關日誌。TLS 錯誤則可能與系統時間不正確、網路攔截、代理節點品質或程式的憑證環境有關,不建議為了繞過錯誤而關閉憑證驗證。

瀏覽器能登入但 CLI 不能

瀏覽器登入成功,只能證明瀏覽器自己的代理、Cookie 與圖形化驗證流程可用。Codex CLI 可能使用不同的 API 網域、不同的認證快取目錄或不同的網路函式庫。請在 CLI 執行期間觀察 Clash 連線記錄,並保留完整但已遮蔽敏感資料的錯誤訊息。不要把瀏覽器 Cookie、存取權杖或 API 金鑰複製到公開貼文,也不要直接將整個使用者設定目錄上傳。

常見問題

開啟 Clash Verge 的系統代理後,Codex CLI 就一定會跟著使用嗎?

不一定。命令列工具可能忽略系統代理,改讀取環境變數,或使用自身的網路設定。建議在啟動 Codex CLI 的同一個終端機中設定 HTTP_PROXY 與 HTTPS_PROXY,再從 Clash Verge 的連線記錄確認請求是否真正進入核心。

HTTP 代理與 SOCKS5 代理應該選哪一個?

首次設定可優先使用 Clash Verge 顯示的 HTTP 或 mixed-port,因為許多命令列工具對 HTTP 代理的支援較直接。若程式明確支援 SOCKS5,再嘗試 socks5h,並確認使用的是 SOCKS 連接埠,而不是控制介面連接埠。

是否需要同時開啟 TUN 與終端機代理變數?

一般不需要同時使用。先以系統代理加環境變數完成 Codex CLI 測試,確認基本路徑正常後,再單獨評估 TUN。兩種方式同時啟用會增加路由層次,發生 DNS、迴圈代理或規則判斷問題時更難定位。

更換節點後仍然無法連線,應該先重裝 Codex CLI 嗎?

不建議先重裝。應依序檢查本機連接埠、代理環境變數、Clash 連線記錄、規則命中、DNS 與錯誤訊息。只有在確認代理路徑正常、CLI 版本或本機安裝檔確實損壞時,才考慮重新安裝,並先備份必要的設定。

下載Clash