排錯前先定規則：不要邊猜邊改

遇到 Codex 中轉 API 報錯時，最忌諱的是連續修改多個字段：一會兒換 Key，一會兒換模型，一會兒改 *ase **L，一會兒又重啟終端。這樣即使最后恢復了，也不知道真正修復的是哪一步。

更穩的做法是先保存現場，再做單變量排查。所謂保存現場，不是把完整 API Key 和隱私內容復制出來，而是記錄當前啟用的配置卡名稱、模型 ID、*ase **L、錯誤碼、發生時間、操作步驟和最小提示詞。

• 一次只修改一個變量，例如只換模型或只換 Key。
• 每次修改后重新打開終端，避免舊會話影響判斷。
• 所有日志都要脫敏，不保留完整 Key。
• 先用空目錄測試，再回到真實項目。

第一步：確認服務入口和賬戶狀態

排錯的第一步不是打開本地配置文件，而是確認靈能API服務入口和賬戶狀態。很多 403、429、模型不可用問題，本地反復改配置沒有意義，根因可能是額度、權限、模型狀態或賬戶側設置。官網入口：https://www.lnsns.com/

如果賬戶側已經有明顯異常，先處理賬戶問題。確認靈能API側狀態正常后，再進入 CC Switch 和 Codex 本地環境。

• 賬戶是否可以正常登錄。
• 當前模型列表是否包含正在使用的模型 ID。
• 額度或用量是否已經觸發限制。
• 是否剛剛重置過 Key，但本地仍在使用舊值。

第二步：鎖定當前啟用的 CC Switch 卡片

排錯時要先確認 Codex 實際走的是哪張配置卡。很多人界面里新增了靈能API配置，但終端仍然讀取舊線路，或者同時存在多張名字相近的卡片，導致問題看起來很玄。

建議把卡片命名寫得直白，例如“靈能API-Codex-主線路”“靈能API-Codex-排錯卡”。名稱越清楚，后續截圖和日志越容易對上。

• 卡片名稱是否和當前排查目標一致。
• 卡片是否真的被啟用，而不是只保存未切換。
• 是否存在舊卡片、測試卡片、臨時卡片混淆。
• 切換后是否重新打開了 Codex 終端。

401：優先檢查 Key，而不是模型

401 通常表示鑒權失敗。此時不要優先換模型，也不要懷疑提示詞內容，先檢查 API Key 是否完整、是否撤銷、是否復制錯賬戶、是否首尾帶了空格或換行。

401 排查順序：
1. Key 是否來自當前靈能API賬戶
2. Key 是否仍然有效
3. 粘貼時是否多了空格或換行
4. CC Switch 當前啟用卡是否使用了這枚 Key
5. 重開終端后是否仍然失敗

如果新舊 Key 同時存在，建議臨時創建一枚排錯專用 Key，只用于這次驗證。驗證完成后，把舊 Key 標記為廢棄或直接停用，避免后面繼續混用。

403：重點看額度、權限和模型訪問范圍

403 不一定是地址寫錯，更常見的是權限、額度或模型訪問范圍問題。例如賬戶當前額度不足、模型沒有開通、策略不允許訪問某類接口，都可能出現類似結果。

如果 403 只在某一個模型上出現，優先換成已確認可用的基礎模型測試；如果所有模型都 403，再回到賬戶權限和 Key 狀態排查。

• 確認賬戶額度和用量是否正常。
• 確認該模型是否在當前賬戶可用列表中。
• 確認請求接口類型和模型能力是否匹配。
• 確認沒有把團隊、個人或測試賬戶的 Key 混在一起。

404：多半是路徑或模型 ID 不匹配

404 在中轉 API 排錯里很常見，但它不一定表示網站打不開。更常見的情況是 *ase **L 層級寫錯、重復 /v1、把完整接口路徑填進了基礎地址，或者模型 ID 寫成了頁面展示名。

常見錯誤：
*ase **L 寫成：https://www.lnsns.com/v1/v1
*ase **L 寫成：https://www.lnsns.com/v1/chat/completions
模型寫成：頁面展示名稱
模型寫成：少了版本號或連字符

處理 404 時，不要一次性重置全部配置。先只核對 *ase **L，再只核對 Model ID。靈能API頁面中的展示名稱、模型說明和接口可用 ID 可能不是同一個概念，最終應以控制臺或模型列表里可復制的接口字段為準。

?? timeout：先縮短請求，再檢查網絡

timeout 經常被誤判為服務不可用，但長上下文、過大的項目目錄、****、終端舊會話、模型排隊都可能導致超時。排查 timeout 的第一步，是把請求縮到最小。

最小請求：
請返回“連接測試通過”，不要解釋。

如果你正在讓 Codex 分析整個倉庫，先把任務縮成單文件或單目錄。中轉 API 可用，不代表任何體量的上下文都應該一次塞進去。

• 最小請求成功：說明基礎線路可用，問題可能在任務過大。
• 最小請求仍超時：繼續排查網絡、**、模型狀態和服務入口。
• 只有項目內超時：檢查讀取文件數量、上下文長度和排除目錄。

429：不是壞了，是頻率或額度觸頂

429 一般和請求頻率、并發、額度或限流有關。此時繼續瘋狂重試只會讓問題更明顯。正確做法是降低請求頻率，暫停長任務，檢查賬戶用量，再決定是否換模型或拆分任務。

對于經常寫長文檔、批量改代碼或跑自動化的人，429 不是偶然現象，而是用量管理問題。把任務拆小、把模型分層使用，通常比單純換 Key 更有效。

• 停止連續重試，等待一段時間再測試。
• 把長任務拆成多個小步驟，減少單次輸入。
• 降低并發，不要多個終端同時跑大任務。
• 在靈能API側查看近期用量和限制情況。

用復現模板把問題講清楚

當你需要自己回顧問題，或把問題發給團隊成員協助定位時，最有價值的不是一大段情緒描述，而是一份可復現模板。模板越短，越容易判斷問題在哪一層。

問題時間：2026-08-08 10:20
配置卡：靈能API-Codex-主線路
*ase **L：https://www.lnsns.com/v1
模型：當前模型 ID
錯誤碼：404
最小提示詞：請返回“連接測試通過”
已排查：重開終端、核對 Key、核對模型
敏感信息：API Key 已脫敏

這份模板里故意不放完整 API Key，也不放項目隱私內容。只要 *ase **L、模型、錯誤碼和最小提示詞足夠穩定，多數問題都能被快速歸類。

排錯后要做收尾，不要留下臨時配置

問題修好后，很多人會忘記清理排錯階段創建的臨時 Key、測試卡片和日志文件。短期看沒影響，長期會帶來混亂：不知道哪枚 Key 在用，不知道哪張卡是正式配置，也不知道哪份日志含有敏感片段。

排錯結束不是“能用了”就完事，而是要把能復用的經驗沉淀下來。下次靈能API、CC Switch 或 Codex 任意一層出現異常，就能更快定位。

• 刪除或停用排錯專用 Key。
• 保留一張正式配置卡，臨時卡片改名或刪除。
• 清理日志里的敏感字段。
• 把最終有效配置寫成簡短記錄。

? 最后一張速查表

把錯誤碼、配置卡、最小請求和日志模板固定下來，Codex 中轉 API 的排錯就會從“憑感覺試”變成“按層級查”。靈能API提供入口和模型服務，CC Switch 負責本地切換，而排錯流程負責讓每一次異常都有明確落點。

• 401：優先查 API Key 是否有效、完整、屬于當前賬戶。
• 403：優先查額度、權限、模型訪問范圍。
• 404：優先查 *ase **L 層級和 Model ID。
• 429：暫停重試，降低頻率，檢查用量。
• timeout：先用最小請求復測，再查網絡和任務體量。
• 走舊線路：切換 CC Switch 卡片后重開終端。
• 排錯記錄：保留錯誤碼和配置摘要，不保留完整 Key。