網路代理伺服器

每個代理 CLI 一個代理伺服器,
設定一次,作用於它的所有代理

公司希望 Claude Code 經由公司的代理伺服器訪問網路,而你個人的 Codex 走家裡的網路。在 shell 裡 export HTTPS_PROXY,會讓所有 CLI 走同一條路。AgentsRoom 讓每個提供商都有自己的出口。

在「設定 > AI 服務商」中選擇一個提供商,展開「高階設定」,填寫代理伺服器地址並點選「測試」:在啟動任何內容之前,AgentsRoom 就會顯示出口 IP。之後,該提供商的每個代理啟動時都會帶上代理伺服器變數,AgentsRoom 自己對該提供商的配額查詢也走同一條路。

每個提供商一個出口
  • Claude Code公司代理伺服器proxy.corp.example:3128出口 IP203.0.113.10
  • Codex家庭代理伺服器home.example.net:8080出口 IP198.51.100.24
  • GitHub Copilot CLI直連出口 IP192.0.2.7

每個提供商經由自己的代理伺服器訪問網路,或者直連,「測試」會顯示提供商將看到的地址。

大多數代理 CLI 本來就會使用代理伺服器:它們在啟動時讀取標準變數 HTTPS_PROXY、HTTP_PROXY 和 NO_PROXY。問題在於這些變數放在哪裡。把它們 export 到 shell 設定檔裡,你執行的每個 CLI 都會走同一個出口,於是你沒法同時讓 Claude Code 留在公司網路上、讓 Codex 走家裡的網路。

AgentsRoom 把這個設定下移一層,放到提供商上。「設定 > AI 服務商」中的每個提供商分頁,在「高階設定」下都有一個「代理伺服器」欄位。該提供商的每個代理啟動時,終端裡都會帶上代理伺服器變數,無論它在哪個專案裡執行,其他提供商則不受影響。

它也覆蓋 AgentsRoom 自己向提供商發起的呼叫,例如讀取你的 Claude 或 Codex 用量。這些呼叫經過同一個代理伺服器,所以帳號只會看到一個地址,而不是一邊看到代理的地址,另一邊看到你電腦的地址。

「代理伺服器」欄位能做什麼

每個提供商一個欄位,在該提供商的每個代理啟動時生效。

每個提供商一個代理伺服器

Claude Code、Codex、GitHub Copilot CLI 以及其他代理 CLI,各有自己的「代理伺服器」欄位。留空的話,該提供商就直連。

HTTP、HTTPS 或 SOCKS

接受 http://、https://、socks5:// 和 socks5h:// 地址。Claude Code 不支援 SOCKS,所以請給 Claude 代理使用 http:// 代理伺服器。

「測試」顯示出口 IP

在啟動任何內容之前,「測試」會分別直接和經由代理伺服器查詢你的公網地址,並連同延遲一起顯示兩者。如果兩者相同,說明該代理伺服器沒有改變你的 IP,面板會直接告訴你。

例外,localhost 始終直連

列出必須繞過代理伺服器的主機,例如內網或軟體包儲存庫。localhost、127.0.0.1 和 ::1 始終排除在外,所以鉤子和本地 MCP 伺服器照常工作。

配額查詢走同一條路

AgentsRoom 自己對該提供商的呼叫,例如用量儀表,也經過代理伺服器。如果代理伺服器宕機,它們會像網路故障一樣失敗:絕不會退回到直連。

沒有明文密碼

這個設定會隨你的帳號同步到你的其他電腦,所以不能直接以明文填寫密碼。請把它儲存在金鑰管理器中,然後寫 http://user:{{secret:NAME}}@host:port。

AgentsRoom 的 Settings,AI providers 頁面,選中 Codex 分頁:環境變數下方,Advanced settings 中的 Proxy 區域填有一個 http:// 代理伺服器地址,以及 Exceptions 欄位和 Test 按鈕
Codex 分頁的「代理伺服器」欄位,位於「高階設定」下。之後啟動的每個 Codex 代理都經由這個地址訪問網路,其他提供商保持各自的路線,「測試」會在啟動任何內容之前顯示出口 IP。

如何設定

五步,每個提供商設定一次。

  1. 1

    開啟提供商的分頁

    進入「設定 > AI 服務商」,選擇提供商(例如 Codex),然後展開「高階設定」。「代理伺服器」欄位位於環境變數下方。在設定搜尋框中輸入「代理伺服器」也能直接跳到這裡。

  2. 2

    填寫代理伺服器地址

    填寫地址,例如 http://proxy.example.com:3128,並在「例外」中填寫必須直連的主機。標題旁邊的開關可以關閉代理伺服器而不丟失設定,在辦公室連不上家裡的代理伺服器時很方便。

  3. 3

    點選「測試」

    AgentsRoom 會顯示經由代理伺服器的出口 IP、延遲,以及不使用代理伺服器時你的地址。密碼被拒絕、代理伺服器無法連線、代理伺服器沒有響應,都會直接說明。

  4. 4

    啟動代理

    代理伺服器在代理啟動時生效:該提供商的每個新代理都會獲得 HTTPS_PROXY、HTTP_PROXY、ALL_PROXY 和 NO_PROXY,大寫和小寫形式都有,因為 curl 等一些工具唯讀取小寫形式。已經在執行的代理會保持原來的路線,直到你重新啟動它。

  5. 5

    代理執行的一切都跟著走

    代理在其終端中啟動的 git、npm 或 curl 都經過同一個代理伺服器。如果其中某個必須保持直連,就把對應主機加到「例外」中。

Claude Code 和 Codex 自己已經能做什麼

Claude Code 讀取 HTTPS_PROXY、HTTP_PROXY 和 NO_PROXY,包括小寫形式,並接受寫在代理伺服器 URL 中的使用者名稱和密碼。它的文件明確說明不支援 SOCKS 代理伺服器。文件建議把這些變數設定在 ~/.claude/settings.json 的 env 塊中,而不是 shell 裡,這是唯一能可靠傳到其後台代理的配置,/status 會顯示它識別到的代理伺服器。在會檢查 TLS 的公司代理伺服器後面,它信任作業系統的證書和 NODE_EXTRA_CA_CERTS。(Claude Code 文件,Enterprise network configuration,2026年10月21日查閱。)

Codex CLI 從其環境中讀取 HTTPS_PROXY、ALL_PROXY 和 NO_PROXY,並從 CODEX_CA_CERTIFICATE 或 SSL_CERT_FILE 獲取自定義根證書。在 codex-cli 0.163.0 中,跟隨 macOS 系統代理設定或 PAC 檔案是一項開發中的功能,預設關閉(codex features enable respect_system_proxy)。其 /experimental 選單中的 Network proxy 項是另一回事:它限制沙箱中的命令能訪問哪些地方,並不決定 OpenAI 看到的地址。

所以,如果只是一台電腦上的一個 CLI,這些變數就夠了,而寫在 ~/.claude/settings.json 中的代理伺服器本來就只作用於 Claude Code。它們給不了你的是:一個管理所有 CLI 的地方,啟動前對出口 IP 的檢查,配額讀取也走同一條路,以及一個不含密碼、能跟著你同步到其他電腦的設定。這正是 AgentsRoom 補上的部分。

限制

  • 代理伺服器在代理啟動時生效。已經在執行的代理會保持原來的路線,直到你重新啟動它。
  • 忽略標準代理伺服器變數的 CLI,其自身流量會直連。AgentsRoom 不會強制它,但對該提供商的配額查詢仍然經過代理伺服器。
  • Claude Code 不支援 SOCKS 代理伺服器。Claude 請使用 http:// 或 https:// 代理伺服器。
  • 不會悄悄退回直連:代理伺服器宕機時,該提供商的代理無法連線到提供商,其用量儀表會顯示網路錯誤。
  • 密碼對應的機密儲存在每台電腦的機密庫中,而機密不會同步:在第二台電腦上,請儲存一個同名的機密。
  • 只有該提供商的代理以及 AgentsRoom 對該提供商的呼叫會使用代理伺服器。內建瀏覽器、你的開發伺服器以及你在其他終端中啟動的命令,保持各自的網路路徑。
  • 環境變數塊(提供商、資料夾、專案或代理)中顯式寫出的 HTTPS_PROXY 行,在代理的終端中優先於此設定。

常見問題

怎樣為 Claude Code 設定代理伺服器?

Claude Code 從你的 shell 或 ~/.claude/settings.json 的 env 塊中讀取標準變數 HTTPS_PROXY、HTTP_PROXY 和 NO_PROXY,並且不支援 SOCKS。在 AgentsRoom 中,開啟「設定 > AI 服務商」,選擇 Claude,展開「高階設定」,在「代理伺服器」中填寫一個 http:// 代理伺服器地址:之後啟動的每個 Claude Code 代理都會獲得這些變數,其他 CLI 保持各自的路線。

怎樣讓 Codex CLI 使用代理伺服器?

Codex CLI 從其環境中讀取 HTTPS_PROXY、ALL_PROXY 和 NO_PROXY,並從 CODEX_CA_CERTIFICATE 或 SSL_CERT_FILE 讀取自定義根證書。在 codex-cli 0.163.0 中,跟隨作業系統的代理設定仍是一項開發中的功能,預設關閉。在 AgentsRoom 中,Codex 分頁的「代理伺服器」欄位會為每個 Codex 代理設定這些變數,Codex 的用量讀取也經過同一個代理伺服器。

Claude Code 和 Codex 能同時使用不同的代理伺服器嗎?

可以。每個提供商分頁都有自己的「代理伺服器」欄位,所以在同一個專案裡、同一時刻,Claude 代理可以經由公司代理伺服器訪問網路,而 Codex 代理走你家裡的網路。沒有設定代理伺服器的提供商直連。

怎樣檢視提供商看到的是哪個 IP 地址?

點選代理伺服器地址旁邊的「測試」。AgentsRoom 會向一個公共端點查詢兩次你的地址,一次直連,一次經由代理伺服器,並連同延遲一起顯示兩者。如果兩者相同,說明該代理伺服器沒有改變你的地址,面板會提醒你。

能使用需要使用者名稱和密碼的代理伺服器嗎?

可以,而且不用以明文寫出密碼。代理伺服器設定會隨你的帳號同步到你的其他電腦,所以明文密碼會被拒絕。請把密碼儲存在金鑰管理器中,然後在代理伺服器地址中引用這個機密:它會在代理啟動時在你的電腦上解析。如果密碼包含 @、: 或 /,請以 URL 編碼形式儲存。

代理伺服器會作用於 npm、git 以及代理執行的命令嗎?

會。這些變數設定在代理的終端中,所以代理在那裡啟動的一切(git、npm、curl、測試執行器)也都使用代理伺服器。把必須保持直連的主機填進「例外」;localhost、127.0.0.1 和 ::1 始終排除在外。

代理伺服器宕機會怎樣?

有意設計為不會退回直連:你選擇這個出口,就是為了讓提供商永遠看不到你的另一個地址。該提供商的代理無法連線到提供商,其用量儀表會顯示網路錯誤,直到代理伺服器恢復或你把它關掉。

每台電腦都要重新設定一遍嗎?

地址和例外不用:它們隨你的帳號儲存,在你登入的每台電腦上都會恢復。密碼要:機密儲存在每台電腦的機密庫中,所以請在第二台電腦上儲存一個同名的機密。從手機啟動的代理執行在桌面電腦上,使用桌面電腦的代理伺服器。

你可能還喜歡

讓每個代理 CLI 都有自己的出口

下載 AgentsRoom,開啟「設定 > AI 服務商」,為每個提供商設定一個代理伺服器。所有套餐均可使用。

免費下載 AgentsRoom

配套應用:隨時隨地監控你的 Agent

使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。

獲取擴充功能
Chrome Web Store

把 Bug 和需求直接傳送到您的公開待辦清單。

多專案管理
多供應商
多代理執行
即時狀態
檔案差異與提交
行動應用
即時預覽
代理團隊
瀏覽器自動化
Backlog 驅動開發
提示詞庫
技能庫
檢視所有功能