Claude Code 網路要求：與 Codex 的域名、埠和代理設定對照
Claude Code 的網路要求是：出站 HTTPS（443 埠）訪問 Anthropic 的 API 域名和登入域名，不需要入站埠，也不需要 UDP。Codex 類似，出站 HTTPS 到 OpenAI 的 API 或 ChatGPT 登入域名即可，唯一要留意的是瀏覽器登入時會在本機起一個回撥埠。實際出問題的多半是代理型別、TLS 攔截和長連線超時。
本文只寫兩家官方文件裡能查到的內容。兩個工具更新很快，域名清單以官方文件當前版本為準：Claude Code 看 Anthropic 文件裡的“Network configuration / Corporate proxy”頁面，Codex 看 OpenAI 的 Codex 文件和 GitHub 倉庫裡的配置說明。
兩個工具分別要訪問哪些域名？
Claude Code
按用途分三類：
| 用途 | 域名 | 說明 |
|---|---|---|
| 模型呼叫 | api.anthropic.com | 所有對話和工具呼叫都走這裡，必須放行 |
| 賬號登入 | claude.ai | 用 Claude 訂閱賬號登入時需要 |
| 賬號登入 | platform.claude.com（原 Console 域名） | 用 API 賬號（Console）登入時需要 |
| 非必要流量 | 遙測與錯誤上報 | 可以用環境變數關閉，見下文 |
| 安裝與更新 | npm 源或原生安裝器的下載地址 | 只在安裝、升級時需要 |
如果你透過 Amazon Bedrock、Google Vertex AI 或自定義的 ANTHROPIC_BASE_URL 使用 Claude Code，模型呼叫就不再走 api.anthropic.com，放行清單要換成對應的雲服務端點或你自己的閘道器地址。
Codex
| 用途 | 域名 / 地址 | 說明 |
|---|---|---|
| 模型呼叫（API Key） | api.openai.com | 用 API Key 登入時的預設地址 |
| 模型呼叫與登入（ChatGPT 賬號） | chatgpt.com、auth.openai.com | 用 ChatGPT 賬號登入時需要 |
| 登入回撥 | localhost:1455 | 瀏覽器登入完成後回撥本機，不出網 |
| 安裝與更新 | npm 源、Homebrew 或 GitHub Releases | 只在安裝、升級時需要 |
localhost:1455 是很多人在遠端伺服器上卡住的地方：在 SSH 機器上執行登入，瀏覽器開在本地電腦，回撥打不回伺服器。官方文件給的辦法是做一次 SSH 埠轉發（ssh -L 1455:localhost:1455 user@host），或者在本機登入後把憑據檔案拷過去，或者直接用 API Key。
埠和協議有什麼要求？
兩者都只需要出站 TCP 443。補充幾點：
- 不需要入站埠。Codex 的 1455 只監聽本機迴環地址。
- 響應是長時間的流式 HTTPS。一次 agent 任務可能持續幾分鐘，期間連線一直開著。代理或防火牆如果有較短的空閒超時、或者會緩衝整個響應再轉發，就會出現“卡住不動然後斷開”。
- IPv6：如果系統優先走 IPv6，而代理只接管了 IPv4，請求可能繞過代理。這種情況見雙棧網路下 IPv4 與 IPv6 出口不一致的排查。
走代理時怎麼配置？
Claude Code
Claude Code 讀取標準的代理環境變數：
export HTTPS_PROXY=http://proxy.example.com:8080
export HTTP_PROXY=http://proxy.example.com:8080
export NO_PROXY="localhost,127.0.0.1,.internal.example.com"
幾個需要注意的點（均來自 Anthropic 官方文件）：
- 官方文件註明不支援 SOCKS 代理。如果你本地只有 SOCKS5 埠，需要換成代理軟體提供的 HTTP 埠。
- 公司做了 TLS 攔截（中間人證書）時，用
NODE_EXTRA_CA_CERTS=/path/to/ca.pem指定企業根證書。 - 需要客戶端證書（mTLS）時，用
CLAUDE_CODE_CLIENT_CERT和CLAUDE_CODE_CLIENT_KEY。 - 想減少需要放行的域名，可以設定
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1，它會關掉遙測、錯誤上報等非必要請求；也可以分別用DISABLE_TELEMETRY、DISABLE_ERROR_REPORTING單獨關。 - 這些變數也可以寫進
settings.json的env欄位，團隊統一下發比讓每個人改 shell 配置更穩。
Codex
Codex CLI 同樣讀取 HTTPS_PROXY / HTTP_PROXY / NO_PROXY。企業根證書的配置方式在不同版本間有過調整，先查官方倉庫當前文件裡關於自定義 CA 的說明，再決定用哪個環境變數。
Codex 有一點和 Claude Code 不同：Codex 自身的網路，和它在沙箱裡執行命令時的網路，是兩回事。在預設的 workspace-write 沙箱模式下，agent 執行的命令（例如 npm install、pip install、curl）預設沒有網路。如果確實需要，在 ~/.codex/config.toml 裡開啟：
[sandbox_workspace_write]
network_access = true
所以“Codex 能正常回復，但裝依賴時報網路錯誤”，多數時候不是代理壞了，而是沙箱策略。Claude Code 的沙箱模式也有類似的出站域名限制，排查時先確認報錯來自工具本身還是來自它執行的命令。
企業防火牆放行清單怎麼寫？
給網路管理員提需求時，按“必需 / 按需 / 可關閉”分開寫，比一股腦列一串域名更容易透過審批。下面是一個可以直接改的模板：
用途：開發人員使用 Claude Code / Codex 命令列工具
協議：出站 TCP 443（HTTPS），無入站需求
要求：允許長連線流式響應，空閒超時建議不短於 10 分鐘
[必需 - Claude Code]
api.anthropic.com
[按需 - Claude Code 登入，二選一]
claude.ai （訂閱賬號）
platform.claude.com （API 賬號）
[必需 - Codex，按登入方式二選一]
api.openai.com （API Key）
chatgpt.com, auth.openai.com （ChatGPT 賬號）
[按需 - 安裝和升級]
內部 npm 映象，或 registry.npmjs.org
[可關閉]
Claude Code 遙測與錯誤上報：設定 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
“空閒超時不短於 10 分鐘”是一個保守建議值，不是官方要求；具體以你們實際任務的時長來定。
如果公司走統一的 AI 閘道器（自建或第三方），清單就只剩閘道器那一個域名。怎麼把兩個工具指向自定義地址，可以看Claude Code 自定義 API 與 Codex 介面地址配置。例如 AGI Plan 是同時相容 Anthropic 和 OpenAI 兩種介面格式的聚合閘道器（AGI Plan 是 cdnping 的商業合作方），站方明確說明自己不是官方授權渠道，選型前請自行評估。
怎麼驗證網路是通的？
在要跑 Claude Code 或 Codex 的那臺機器上執行，保持和工具相同的環境變數：
# 1. 看代理變數是否生效
env | grep -i proxy
# 2. 測 Anthropic API 的連通性（未帶金鑰，返回 401/405 之類的 HTTP 狀態碼說明網路已通）
curl -sS -o /dev/null -w "%{http_code} connect=%{time_connect}s tls=%{time_appconnect}s\n" \
https://api.anthropic.com/v1/messages
# 3. 測 OpenAI API
curl -sS -o /dev/null -w "%{http_code} connect=%{time_connect}s tls=%{time_appconnect}s\n" \
https://api.openai.com/v1/models
# 4. 看證書是誰簽發的（被 TLS 攔截時這裡會顯示公司 CA）
curl -sv https://api.anthropic.com 2>&1 | grep -i "issuer"
判斷方法：
| 現象 | 大機率原因 |
|---|---|
| 返回 HTTP 狀態碼（401、403、404、405） | 網路層已通，問題在金鑰或賬號 |
Could not resolve host | DNS 被攔或代理沒接管 DNS |
Connection timed out / 卡在 connect | 防火牆未放行 443，或代理沒生效 |
SSL certificate problem | 公司 TLS 攔截，需要配置企業根證書 |
| curl 正常但工具報錯 | 工具沒讀到同樣的環境變數，或用了 SOCKS 代理 |
| 回覆中途斷開 | 代理或防火牆的空閒超時太短 |
瀏覽器這邊，可以用 cdnping 的線上測速看到兩家 API 的首次連線（含 DNS 和 TLS 握手）和往返延遲，用 IP 與環境檢測確認當前出口 IP、是否走了分流、有沒有 DNS 洩漏。更完整的步驟見開發者網路自檢清單；如果已經確認是 Claude Code 連線報錯，按四層網路檢查清單往下查。
網路沒問題，但還是連不上？
先排除服務端故障。cdnping 從 Cloudflare 邊緣每 5 分鐘探測各官方 API 入口，你可以在 Claude API 狀態和 OpenAI API 狀態頁面看到，也可以在 Claude Code 掛了嗎和 Codex 掛了嗎看其他使用者的報告。
給一個參考：cdnping 在 2026 年 10 月 17 日開始採集，在首批約 85 分鐘的探測視窗裡（Cloudflare 丹佛 DEN 節點），api.anthropic.com 中位數 73 ms、p95 84 ms，api.openai.com 中位數 96 ms、p95 194 ms，兩者都沒有失敗。這隻說明服務端入口在美國節點看來是可達的，不代表你本地到它們的路徑，樣本也還很短。
另外，根據 cdnping 同步的官方狀態頁記錄，2026 年 9 月 17 日以來 Anthropic 狀態頁有 6 次 major 級別事件，OpenAI 狀態頁有 4 次 major、19 次 minor，其中 10 月 14 日（UTC）有一條“Degraded performance in Codex and ChatGPT Work”，持續約 167 分鐘。遇到問題先看狀態頁，可以少走彎路。狀態頁的事件等級怎麼理解，可以看怎麼看 OpenAI 和 Claude 狀態頁。
最後一種情況和網路無關：Anthropic 和 OpenAI 都只在其支援的國家和地區提供服務，賬號或請求來自不受支援的地區時會被拒絕，這類報錯通常是 403 並帶有地區相關提示。原因和官方政策見Claude 提示所在地區不受支援。請遵守服務條款和當地法規，選擇合規的接入方式。
