先判斷：這是配置問題，還是網絡路徑問題

很多 timeout 會被誤判成 API Key 錯誤，但兩者完全不是一類問題。Key 錯通常會返回身份相關錯誤，路徑錯通常會返回接口或模型相關錯誤，而網絡問題更像是請求發不出去、解析慢、連接被**吃掉，或者不同終端結果完全不一樣。

所以排查第一步不是重置所有配置，而是先把問題分層：靈能API服務側是否正常，CC Switch當前卡片是否正確，終端網絡是否能訪問，項目里有沒有額外**或環境變量。層級清楚以后，排查才不會繞圈。

• 如果瀏覽器能打開，但終端失敗，優先查終端**和環境變量。
• 如果本機能用，WSL不能用，優先查子系統 DNS 和**傳遞。
• 如果空目錄能用，項目不能用，優先查項目腳本和依賴**。
• 如果所有環境都 timeout，再查網絡出口、防火墻和服務側狀態。

第一步：先打開靈能API確認服務側可訪問

在終端里排查之前，先用瀏覽器打開靈能API官網 https://www.lnsns.com/，確認頁面能正常加載、賬號能正常進入、模型和額度可見。瀏覽器訪問成功不能證明終端一定成功，但它能先排除賬號和服務入口明顯不可用的問題。

這一步的目的很簡單：先證明靈能API服務側有基礎可用條件。只要服務側沒問題，后面就可以專心查本地網絡路徑和配置讀取。

• 頁面打不開：先處理本機網絡、DNS 或公司網絡限制。
• 頁面能打開但賬號異常：先處理賬號或權限，不要改 CC Switch。
• 模型列表不可見：先確認當前賬號權限和套餐狀態。
• 額度不足：短請求也可能失敗，先補齊測試條件。

第二步：確認 CC Switch 當前啟用卡片

網絡排查之前，必須確認 CC Switch 當前啟用的就是靈能API相關配置卡。很多人以為自己在測新線路，實際終端仍然讀取舊卡片或舊環境變量，導致結果完全沒有參考價值。

如果你在一天內多次切換配置卡，建議每次都***空目錄短請求。不要把上一個會話的成功結果當成當前配置的成功結果。

• 卡片名稱要能看出用途，比如“靈能API-Codex-Network-Check”。
• 先使用穩定模型做網絡排查，不要同時測試多個模型。
• **、高級參數、超時設置先保持簡單，避免變量過多。
• 保存并啟用后，關閉舊 Codex 會話，重新打開終端。

? 第三步：核對 *ase **L 和模型字段，避免偽網絡故障

有些看起來像網絡問題的失敗，其實是 *ase **L 或 Model ID 寫錯導致的。比如路徑少了一段、重復拼接 /v1、模型名使用了展示名而不是真實調用名。這類問題不該歸到 DNS 或**上。

字段核對：
*ase **L：https://www.lnsns.com/v1
Model ID：從靈能API當前模型列表復制
API Key：當前賬號有效 Key
配置卡：靈能API-Codex-Network-Check
終端：重新打開的新會話

把字段錯誤排除掉，網絡排查才有意義。否則你可能花半天改**，最后發現只是模型名復制錯了。

• 401 優先查 Key，不要當成網絡超時。
• 404 優先查路徑和 Model ID，不要當成 DNS 故障。
• timeout 才重點進入網絡出口、**和防火墻排查。

**步：檢查當前終端的**環境變量

Windows、WSL、SSH、容器都可能有自己的**變量。瀏覽器能訪問靈能API，不代表 PowerShell、WSL 或容器里的 Codex 也能走同一條網絡路徑。先看當前終端到底帶了哪些**設置。

Get-ChildItem Env: | Where-O*ject { $_.Name -**tch '****|****S|PROXY|NO_PROXY|OPENAI|API|CODEX' }

env | grep -Ei 'http|https|proxy|no_proxy|openai|api|codex'

檢查時不要把完整 Key 或敏感變量值截圖給別人。你只需要確認變量名、來源和是否存在舊配置。

• 如果終端沒有**，而網絡必須走**，請補齊終端**設置。
• 如果終端有舊**，可能會把請求轉到錯誤出口。
• 如果 NO_PROXY 配置過寬，可能繞開本該使用的**。

第五步：用空目錄短請求確認連接是否穩定

**變量檢查完以后，先用空目錄做短請求。空目錄能排除項目腳本、依賴安裝、測試命令和大上下文影響，專門驗證 Codex 是否能通過靈能API中轉站完成一次基礎調用。

New-Item -ItemType Directory codex-network-check
Set-Location codex-network-check
codex

請只回復：Codex 中轉站網絡連接正常。

這個短請求建議連續測兩到三次，每次間隔幾十秒。一次成功不能說明完全穩定，連續成功才更適合作為真實項目驗證的前置條件。

• 短請求穩定成功：基礎網絡路徑可用。
• 短請求偶發 timeout：重點觀察 DNS、**和網絡出口穩定性。
• 短請求一直失敗：先不要進項目，繼續查終端網絡。

第六步：區分瀏覽器**和終端**

很多網絡問題來自一個誤區：瀏覽器能打開網頁，就認為終端也能訪問接口。實際上瀏覽器可能使用系統**、瀏覽器插件或企業**，而終端進程可能完全沒有走同一條路徑。

如果靈能API網頁能打開，但 Codex 請求 timeout，就要把瀏覽器和終端拆開看。不要只盯著網頁狀態判斷接口鏈路。

• 瀏覽器**：主要影響網頁訪問，不一定影響 PowerShell。
• 系統**：可能影響部分命令行工具，但不保證所有工具都讀取。
• 終端環境變量**：通常更直接影響命令行請求。
• 容器**：容器內部需要單獨配置，不能默認繼承宿主機。

第七步：WSL、SSH、容器要分別驗證 DNS

同一臺電腦上，Windows、WSL、Docker 容器和遠程 SSH 服務器可能使用不同 DNS。Windows 能解析，不代表 WSL 能解析；宿主機能訪問，不代表容器能訪問。遇到 timeout 或連接失敗時，DNS 是很值得檢查的一層。

nslookup www.lnsns.com
curl -I https://www.lnsns.com/

Resolve-DnsName www.lnsns.com
Invoke-We*Request -Uri 'https://www.lnsns.com/' -Method Head

DNS 排查不需要暴露任何 Key，非常適合作為網絡層第一輪檢查。先確認域名能解析，再去看接口調用，思路會清楚很多。

• DNS 解析失敗：檢查本機 DNS、公司網絡策略或子系統網絡。
• 能解析但連接失敗：繼續檢查**、防火墻或 TLS 攔截。
• 只有容器失敗：給容器單獨配置 DNS 或**。

第八步：公司網絡和安全軟件的攔截要單獨看

在公司網絡、遠程辦公網絡或裝了安全軟件的機器上，接口請求可能被**、證書檢查、終端安全策略或防火墻規則攔截。表現可能是 timeout，也可能是 TLS 報錯、連接被重置或偶發失敗。

如果確實是企業網絡策略導致，可以把靈能API相關訪問交給網絡***確認白名單，而不是在每個開發成員電腦上各自亂改。

• 同一配置在家庭網絡可用、公司網絡不可用，優先查公司網絡策略。
• 同一網絡下瀏覽器可用、終端不可用，優先查終端**和證書。
• 同一終端早晚表現不同，記錄時間點和錯誤碼，觀察是否有限流或網絡波動。
• 不要為了排查隨意關閉全部安全軟件，先看日志和白名單策略。

第九步：真實項目里的網絡配置也要檢查

空目錄能成功，項目里卻失敗，說明基礎鏈路大概率沒問題，問題更可能來自項目級配置。項目里的 .env、啟動腳本、測試腳本、包管理器配置，都可能寫了舊**、舊 *ase **L 或舊模型名。

進入項目后的只讀提示詞：
請只讀分析當前項目，不要修改文件。
請找出可能影響 API 中轉站、**、DNS、*ase **L、Model ID 的配置文件。
請不要讀取 .env、secrets、私鑰和生產配置內容，只輸出文件路徑和排查建議。

真實項目排查一定要克制。不要讓 Codex 一上來就批量改配置，先讓它只讀定位可能影響網絡路徑的文件。

• 先找路徑和文件名，不直接讀取敏感值。
• 先確認項目有沒有覆蓋全局**。
• 先確認包管理器、測試腳本、容器腳本是否有額**絡配置。

第十步：把網絡排查結果做成對照表

網絡問題最怕口頭描述，比如“我這里不行”“好像是**問題”“昨天還能用”。建議把不同環境的測試結果寫成對照表，這樣一眼能看出問題集中在哪一層。

網絡排查記錄：
環境：Windows PowerShell / WSL / SSH / Docker
配置卡：靈能API-Codex-Network-Check
瀏覽器訪問：https://www.lnsns.com/ 成功 / 失敗
DNS 解析：成功 / 失敗
短請求：成功 / 失敗 / 偶發 timeout
錯誤：401 / 404 / timeout / TLS / connection reset
處理動作：重開終端 / 調整** / 檢查 DNS / 切換網絡

這張表會讓排查變得非常直觀，也方便團隊成員把問題交接給網絡***或項目負責人。

• 如果只有一個環境失敗，優先查那個環境的**和 DNS。
• 如果所有環境失敗，優先查服務側和網絡出口。
• 如果只有項目失敗，優先查項目級配置。

第十一步：配置變更后必須做回歸復測

**、DNS、*ase **L、Model ID、Key、配置卡，只要改過其中任何一項，都要重新做回歸復測。不要因為某一步剛剛成功，就認為后面所有配置仍然有效。

回歸復測是為了避免“改好了但不知道為什么好”。長期使用靈能API和 CC Switch時，這個習慣會讓配置遷移、模型切換和網絡排查都更穩。

• 先關閉舊 Codex 會話。
• 重新打開終端，確認當前環境變量。
• 空目錄短請求連續測試兩輪。
• 進入真實項目只讀檢查一輪。
• 記錄最終配置卡、模型、網絡環境和結果。

? 最后一份網絡排查檢查清單

Codex 中轉站接入遇到連接超時，不要第一時間懷疑所有東西都壞了。按服務側、配置側、終端**、DNS、網絡策略、項目配置逐層排查，靈能API和 CC Switch 的接入鏈路會變得很清楚，后續換網絡、換設備、換項目也更容易復用。

• 已打開靈能API官網并確認賬號、模型、額度、Key 狀態。
• 已確認 CC Switch 當前啟用的是靈能API網絡排查卡。
• 已核對 *ase **L、Model ID、API Key，排除偽網絡故障。
• 已檢查 PowerShell、WSL、SSH 或容器里的**變量。
• 已用空目錄短請求驗證基礎連接。
• 已區分瀏覽器**、系統**、終端**和容器**。
• 已分別檢查 DNS、公司網絡策略和安全軟件攔截。
• 已進入真實項目做只讀網絡配置定位。
• 已保存網絡排查對照表，并完成回歸復測。