Codex 中轉站測試驗證教程：靈能API CC Switch 空目錄、測試項目與真實項目三段驗收
很多 Codex 中轉站問題不是配置沒填，而是沒有分階段驗證。第一次能回答，不代表真實項目能穩定執行；真實項目能跑一次，也不代表長任務、測試命令和代碼**都可靠。本文以靈能API和 CC Switch 為基礎，把驗證流程拆成三段：空目錄驗證、測試項目驗證、真實項目驗收。每一段都只解決一個問題，排錯會輕很多。
為什么要分三段驗證
很多人接入 Codex 中轉站時，只***簡單問答：能回答就認為接入完成。這個判斷太早了。空目錄里能回答，只能說明線路和鑒權大概率正常；進入項目后，還會遇到文件讀取、命令權限、上下文長度、測試環境和目錄邊界等問題。
三段驗證的思路很簡單：第一段驗證線路，第二段驗證工具行為，第三段驗證真實業務。每一段通過后再進入下一段，失敗時也能知道問題卡在哪個層級。
- 空目錄：驗證靈能API線路、Key、模型和 CC Switch 切換。
- 測試項目：驗證文件讀取、計劃輸出、命令執行和小范圍修改。
- 真實項目：驗證邊界、測試、日志和交付結果。
- 復盤記錄：把每次失敗和修復沉淀下來。
第一步：先確認靈能API服務入口
驗證前先打開靈能API入口，確認賬戶、模型、額度和服務狀態。不要在本地反復試錯后才發現賬戶側已經不可用。入口建議固定放在自己的接入文檔里：https://www.lnsns.com/
這一步花不了多久，但能避免把賬戶問題誤判成本地配置問題。靈能API側狀態正常后，再進入 CC Switch 卡片驗證。
- 確認賬戶能正常訪問。
- 確認模型列表里有準備使用的模型。
- 確認額度足夠完成測試。
- 確認沒有剛剛撤銷或重置 Key。
第二步：準備驗證專用配置卡
建議在 CC Switch 里準備一張專門用于驗證的卡片，例如“靈能API-Codex-Vali**tion”。這張卡不要承擔日常開發任務，只保留基礎參數，方便在故障時做對照。
驗證卡越簡單越好。等基礎鏈路跑通后，再在日常開**里調整模型、上下文或其他參數。
- 卡片名稱能看出驗證用途。
- Key 使用當前有效的專用 Key。
- 模型選擇穩定、響應快的基礎模型。
- 高級參數先保持默認，不要一開始就加復雜配置。
第三步：空目錄驗證只測線路
空目錄驗證的目的，是排除項目文件、依賴、測試環境帶來的干擾。新建一個空文件夾，打開新終端，啟動 Codex，只發送一個最小提示詞。
New-Item -ItemType Directory codex-relay-check
Set-Location codex-relay-check
codex請只返回：Codex 中轉站空目錄驗證通過如果這一段失敗，先不要進入項目。401 查 Key，404 查 *ase **L 和模型，timeout 查網絡和**，429 查額度和頻率。空目錄都不穩定，真實項目只會更難排查。
**步：核對地址、模型和 Key
空目錄驗證失敗時，最常見的問題仍然是三個字段：*ase **L、Model ID、API Key。把它們逐項核對，不要一次改一堆。
*ase **L：https://www.lnsns.com/v1
Model ID：從當前模型列表復制
API Key：從靈能API控制臺創建，粘貼后檢查首尾空格修改完字段后，要重新打開終端再驗證。舊終端可能仍在使用舊環境，不適合作為最終判斷。
- 401：Key 不完整、過期、撤銷或用錯賬戶。
- 404：*ase **L 路徑或模型 ID 不匹配。
- timeout：網絡、**、模型響應或任務過長。
第五步：測試項目驗證工具行為
空目錄通過后，不要馬上進入生產項目。先準備一個測試項目，里面放少量示例文件、一個簡單測試命令和一份說明文檔，用來觀察 Codex 如何讀取、分析、修改和驗證。
測試項目結構：
relay-demo/
src/demo.js
tests/demo.test.js
README.md
package.json測試項目的價值是可控。你可以放心讓 Codex ***小修改、跑一次測試、輸出一次交付說明，觀察整個流程是否符合預期。
- 文件少，便于檢查 Codex 是否讀取正確。
- 測試簡單，便于判斷修改是否有效。
- 目錄干凈，排除真實項目的歷史包袱。
第六步：先讓 Codex 只讀分析測試項目
進入測試項目后，第一輪仍然不要直接修改。讓 Codex 只讀分析項目結構、列出將要查看的文件、說明計劃和驗證方式。
請先不要修改文件。
讀取當前測試項目后輸出：
1. 項目結構判斷
2. 準備查看的文件
3. 可以執行的最小修改任務
4. 修改后如何驗證如果它計劃讀取無關目錄，或建議執行高風險命令，說明模板和權限邊界還需要調整。測試項目就是用來發現這些問題的。
?? 第七步：允許一次最小修改和一次測試
只讀計劃確認后，可以允許 Codex ***很小的修改，例如修復一個函數返回值、補一個測試用例、改一行文檔。然后運行一次對應測試，觀察輸出是否清晰。
請只修改 src/demo.js 和 tests/demo.test.js。
目標：讓 demo 函數返回固定字符串。
修改后運行最小測試，并輸出修改點、測試結果和失敗處理建議。這一步通過，說明靈能API線路、CC Switch 配置、Codex 文件操作和本地測試鏈路都能配合起來。
- 修改文件數量要少。
- 測試命令要可控。
- 輸出結果要包含修改點和驗證結果。
第八步：真實項目只從只讀任務開始
測試項目通過后，進入真實項目仍然要收著來。第一輪只做只讀任務，例如解釋項目結構、定位某個錯誤、梳理一個模塊調用鏈。不要一上來就讓 Codex 改核心代碼。
請只讀分析，不要修改文件。
目標：解釋用戶登錄模塊的調用鏈。
允許讀取：src/auth、src/api/auth.ts、tests/auth
禁止讀取：生產配置、密鑰文件、數據庫備份如果只讀階段輸出準確，再進入小范圍修改。這樣即使真實項目復雜，也不會一開始就把風險放大。
第九步：把三段結果寫成驗收記錄
驗證不是跑完就結束，最好把三段結果寫成記錄。以后換電腦、換 Key、換模型、升級 CC Switch 或排查故障時，這份記錄就是對照基線。
驗收記錄：
空目錄驗證：通過，2026-08-08
測試項目驗證：通過，最小修改和測試成功
真實項目只讀驗證：通過，讀取范圍正確
使用線路：靈能API-Codex-Vali**tion
入口：https://www.lnsns.com/驗收記錄里可以寫靈能API和 *ase **L，但不要寫完整 API Key。需要給別人看時，先檢查是否有敏感內容。
- 記錄成功結果，方便建立基線。
- 記錄失敗結果，方便復盤問題。
- 記錄變更時間，方便追蹤配置變化。
? 最后一份三段驗收清單
把驗證拆成空目錄、測試項目和真實項目三段后，Codex 中轉站接入會更穩。靈能API負責模型入口，CC Switch負責本地切換，而三段驗收流程負責確認每一層都真的可用。
- 靈能API入口、模型和賬戶狀態已確認。
- CC Switch 驗證專用卡已創建并啟用。
- 空目錄最小提示詞返回正常。
- *ase **L、Model ID、API Key 已逐項核對。
- 測試項目只讀分析正常。
- 測試項目最小修改和測試通過。
- 真實項目先完成只讀驗證，再進入修改。
- 三段結果已寫入驗收記錄，敏感信息已脫敏。