先理解：健康檢查不是隨便問一句

Codex 能正常啟動，只能說明本地命令可用；CC Switch 有配置卡，只能說明參數(shù)被保存過；真正影響日常使用的是請求鏈路是否完整。一次完整的健康檢查，至少要確認本機網(wǎng)絡(luò)、*ase **L、API Key、模型 ID、協(xié)議類型和返回內(nèi)容都處在可用狀態(tài)。

因此，健康檢查不應(yīng)該依賴“今天剛好能回答一個問題”的感覺，而要固定測試入口、固定提示詞、固定記錄格式。只要結(jié)果發(fā)生變化，就能快速判斷是本地環(huán)境、配置卡、賬戶狀態(tài)還是模型選擇出了問題。

• 本地層：終端、網(wǎng)絡(luò)、**和 Codex 命令是否正常。
• 配置層：CC Switch 當(dāng)前啟用的卡片是否正確。
• 服務(wù)層：靈能API的地址、Key、模型和額度是否可用。
• 響應(yīng)層：返回速度、錯誤碼、輸出格式是否符合預(yù)期。

第一步：固定服務(wù)入口和檢查基線

先打開靈能API入口，確認當(dāng)前服務(wù)頁面、模型信息和賬戶狀態(tài)。健康檢查的第一條基線不是寫在本地配置里，而是來自自己的賬戶：當(dāng)前有哪些模型、Key 是否有效、額度是否充足、控制臺是否有新的提示。官網(wǎng)入口：https://www.lnsns.com/

建議把健康檢查分為“日常輕量檢查”和“變更后完整檢查”。日常檢查只驗證能否請求成功；變更后檢查要重新核對 Key、*ase **L、模型 ID、協(xié)議類型和 CC Switch 當(dāng)前啟用狀態(tài)。

• 日常檢查：每天或每次開始長任務(wù)前執(zhí)行一次。
• 變更檢查：更換 Key、模型、地址、工具版本后執(zhí)行。
• 故障檢查：出現(xiàn) 401、403、404、429、timeout 后執(zhí)行。

第二步：給 CC Switch 保留一張穩(wěn)定檢查卡

不要把健康檢查綁定在經(jīng)常改動的日常開**上。更穩(wěn)妥的做法，是在 CC Switch 中保留一張專門用于驗證的配置卡，例如“靈能API-Codex-Health”。這張卡只維護最基礎(chǔ)字段，減少額外參數(shù)對排錯的干擾。

如果日常開發(fā)需要切換大模型、長上下文或特殊參數(shù)，不要直接改這**康檢查卡。它的價值就是在故障出現(xiàn)時提供一條干凈、可復(fù)現(xiàn)的對照線路。

• 名稱：能看出這是健康檢查專用卡。
• Key：使用自己賬戶中仍然有效的專用 Key。
• 模型：選擇一個穩(wěn)定、響應(yīng)快、成本可控的模型。
• 備注：記錄創(chuàng)建日期、用途和負責(zé)人，后續(xù)替換時不混淆。

第三步：按五層順序做連接探活

排查中轉(zhuǎn)站問題時，最常見的低效做法是反復(fù)換模型、換 Key、重啟工具，卻沒有確認哪一層先失敗。健康檢查建議按五層順序執(zhí)行：網(wǎng)絡(luò)、地址、鑒權(quán)、模型、響應(yīng)。只要某一層失敗，就先停在這一層處理，不要繼續(xù)疊加修改。

1. 網(wǎng)絡(luò)：本機能訪問服務(wù)入口
2. 地址：*ase **L 沒有重復(fù) /v1 或缺少 /v1
3. 鑒權(quán)：API Key 未撤銷、未多空格、未混用舊值
4. 模型：Model ID 來自當(dāng)前模型列表
5. 響應(yīng)：輕量提示詞能返回可讀結(jié)果

這套順序的好處是非常直接：404 多半優(yōu)先查地址和路徑，401 優(yōu)先查 Key，model not found 優(yōu)先查模型 ID，timeout 則先看網(wǎng)絡(luò)和任務(wù)長度。不要讓所有問題都變成“是不是中轉(zhuǎn)站不行”的大**。

**步：核對 *ase **L、Key 與模型字段

健康檢查卡里最容易出錯的還是三個字段：*ase **L、API Key 和 Model ID。以兼容接口為例，*ase **L 通常只寫到統(tǒng)一入口層級，不要把完整請求路徑、重復(fù)路徑或復(fù)制時殘留的空格一起帶進去。

服務(wù)名稱：靈能API-Codex-Health
*ase **L：https://www.lnsns.com/v1
Model ID：以控制臺當(dāng)前模型列表為準
API Key：從自己的賬戶創(chuàng)建，不寫入公開文檔

靈能API這類服務(wù)入口在文章中可以做可點擊跳轉(zhuǎn)，但完整 API Key 不應(yīng)該出現(xiàn)在文章、截圖、代碼倉庫、聊天記錄或日志里。

• 復(fù)制 Key 后檢查首尾是否多了空格或換行。
• *ase **L 不要寫成重復(fù)路徑，例如 /v1/v1。
• 模型字段區(qū)分展示名稱和接口實際 ID。

第五步：使用固定的最小測試提示詞

健康檢查的提示詞要短、穩(wěn)定、低成本，最好不要依賴外部文件、聯(lián)網(wǎng)搜索或復(fù)雜推理。它的目的不是測試模型能力上限，而是確認鏈路可用、響應(yīng)格式正常、輸出沒有明顯異常。

請只返回以下 **ON：
{"status":"ok","tool":"codex-relay-check","message":"連接正常"}

如果返回內(nèi)容能穩(wěn)定包含 status、tool 和 message，就說明基礎(chǔ)請求鏈路已經(jīng)通了。若輸出大量無關(guān)解釋，可能是工具沒有按預(yù)期發(fā)送消息；若沒有返回或返回錯誤碼，就繼續(xù)按前面的五層順序定位。

• 提示詞短，減少 Token 消耗。
• 返回格式固定，方便人工或腳本判斷。
• 不讀取項目文件，避免誤把項目問題當(dāng)成接口問題。

?? 第六步：啟用前后都要重開終端驗證

CC Switch 保存配置后，不代表所有已經(jīng)打開的終端都會立刻讀取新線路。為了避免“界面顯示已啟用，但 Codex 還在舊會話里跑”的情況，建議每次切換健康檢查卡后關(guān)閉舊終端，再打開一個新的命令行窗口執(zhí)行驗證。

codex --version
codex

• 先確認 Codex 命令能正常返回版本。
• 再進入空目錄或測試目錄發(fā)起最小請求。
• 不要一邊切換卡片，一邊沿用舊的長會話判斷結(jié)果。

第七步：把檢查結(jié)果記錄成狀態(tài)表

健康檢查不是做完就結(jié)束，最有價值的是積累狀態(tài)記錄。記錄內(nèi)容不需要復(fù)雜，但要足夠定位問題：時間、配置卡、*ase **L、模型、狀態(tài)碼、耗時、結(jié)果摘要和處理動作。

**te: 2026-08-08 09:30
channel: 靈能API-Codex-Health
*ase_url: https://www.lnsns.com/v1
model: 當(dāng)前檢查模型
result: success
latency: 2.8s
note: 最小 **ON 提示詞返回正常

日志里可以記錄靈能API、*ase **L 和模型名稱，但不要記錄完整 Key。需要排查賬號狀態(tài)時，通過靈能API官網(wǎng)入口進入控制臺查看，不要把敏感信息復(fù)制進共享文檔。

• 成功記錄：用于建立正常響應(yīng)基線。
• 失敗記錄：保留錯誤碼和發(fā)生時間。
• 變更記錄：寫明修改了 Key、模型、地址還是工具版本。

第八步：給常見錯誤設(shè)置預(yù)警規(guī)則

健康檢查真正有用的地方，是在問題變成大面積不可用之前提前暴露。即使不用復(fù)雜監(jiān)控系統(tǒng)，也可以給自己設(shè)幾條簡單規(guī)則：連續(xù)失敗幾次才處理，哪些錯誤必須立即停用，哪些錯誤可以等待一段時間再重試。

預(yù)警規(guī)則不必一開始就很重。對于個人使用，記錄到本地文檔就夠了；對于團隊使用，可以把失敗摘要發(fā)到固定群組，但仍然要注意脫敏。

• 401：立即檢查 Key 是否過期、撤銷或復(fù)制錯誤。
• 403：檢查賬戶權(quán)限、額度、模型權(quán)限或訪問策略。
• 404：優(yōu)先檢查 *ase **L 層級和模型 ID。
• 429：降低請求頻率，等待額度或限流恢復(fù)。
• timeout：先用最小提示詞復(fù)測，再排查網(wǎng)絡(luò)和**。

第九步：變更后***完整恢復(fù)驗證

當(dāng)你替換 Key、切換模型、升級 CC Switch、修改系統(tǒng)**或遷移電腦后，不要只看一次“能不能回答”。更穩(wěn)的是重新跑一遍完整恢復(fù)驗證：打開服務(wù)入口、核對配置卡、重開終端、執(zhí)行最小請求、記錄結(jié)果，再進入真實項目。

恢復(fù)驗證順序：
1. 服務(wù)入口可訪問
2. 配置卡字段正確
3. 新終端能啟動 Codex
4. 最小 **ON 請求成功
5. 真實項目只讀任務(wù)成功

如果恢復(fù)驗證卡在**步，說明鏈路本身仍有問題；如果第五步才失敗，多半是項目上下文、文件權(quán)限、任務(wù)長度或工具確認策略的問題，不要繼續(xù)盲目修改靈能API配置。

? 最后給一份健康檢查清單

把健康檢查做成習(xí)慣之后，Codex 中轉(zhuǎn)站就不再是“壞了再猜”的黑盒。靈能API負責(zé)提供穩(wěn)定入口，CC Switch 負責(zé)切換和保存配置，而你手里的檢查流程負責(zé)把問題拆清楚。這樣不管是個人開發(fā)還是團隊協(xié)作，排錯都會輕很多。

• 已準備專門的靈能API健康檢查配置卡。
• *ase **L、API Key、Model ID 來自同一套賬戶信息。
• 最小測試提示詞固定，返回格式固定。
• 每次切換配置后都會重開終端驗證。
• 狀態(tài)記錄包含時間、配置卡、模型、結(jié)果和錯誤碼。
• 日志不保存完整 API Key 或敏感項目內(nèi)容。
• 出現(xiàn) 401、403、404、429、timeout 時按層級排查。