先看懂：界面配置和本地配置不是兩套東西
CC Switch 的價值，是把 Codex 中轉 API 的關鍵字段可視化管理起來。你在界面里填寫的服務名稱、*ase **L、Model ID 和 API Key，本質上都是為了讓本地 Codex 請求指向正確的接口。
因此，接入時不要把界面和配置文件割裂開看。界面用于創建、切換和維護線路；字段規則用于判斷請求是否正確；終端重啟用于讓新配置真正被 Codex 讀取。三者連起來，接入流程才完整。
- 界面層：CC Switch 負責保存和啟用配置卡。
- 字段層：*ase **L、Model ID、API Key 決定請求是否成功。
- 終端層：新會話讀取當前啟用線路。
- 驗證層：最小提示詞確認鏈路是否可用。
第一步：從靈能API準備三類服務信息
接入前先打開靈能API入口，準備三類信息：接口地址、模型 ID、API Key。不要直接復制舊教程里的字段，也不要用別人截圖里的示例值。入口：https://www.lnsns.com/
如果你之前已經接通過一次，也建議重新確認靈能API頁面。模型、額度、接口說明都有可能更新，舊筆記只能作為參考。
- 接口地址：確認當前推薦的 *ase **L。
- 模型 ID：從當前模型列表復制。
- API Key：從自己的賬戶創建。
- 賬戶狀態：確認額度和權限可以完成測試。
第二步：API Key 只負責鑒權，不負責修復地址錯誤
很多新手遇到報錯就反復換 Key，但 Key 只負責鑒權。*ase **L 錯、Model ID 錯、終端沒重開，都不是換 Key 能解決的。正確做法是先判斷錯誤類型，再決定改哪個字段。
401：優先檢查 API Key
404：優先檢查 *ase **L 和 Model ID
timeout：優先檢查網絡、終端會話和任務體量
429：優先檢查用量、頻率和并發把 Key 的職責說清楚，能避免很多無效操作。靈能API提供憑證和模型入口，CC Switch負責把這些信息寫進本地線路。
- Key 要使用 Codex 專用憑證。
- 排錯記錄不要保存完整 Key。
- Key 泄露后直接撤銷，不繼續使用。
第三步：在 CC Switch 建立配置卡
打開 CC Switch，新建一張配置卡。卡片名稱建議寫成“靈能API-Codex-Config”，讓它明顯區別于排錯卡、備用模型卡或項目專用卡。
第一次接入時，不建議同時創建多張相似配置。先讓一張卡跑通，再擴展備用模型、項目卡和排錯卡。
- 名稱：靈能API-Codex-Config。
- 用途：學習字段對照和首次接入。
- 模型：先選擇穩定模型，方便驗證。
- 備注：記錄創建日期和適用場景。
**步：把字段和含義逐項對上
接入中最重要的不是記住某個截圖位置，而是理解每個字段的含義。服務名稱方便識別，*ase **L 決定請求入口，Model ID 決定模型，API Key 決定身份。
服務名稱：靈能API-Codex-Config
*ase **L：https://www.lnsns.com/v1
Model ID：從靈能API當前模型列表復制
API Key：自己的 Codex 專用 Key字段填完后先保存，不要急著跑真實項目。接下來要確認配置卡已啟用，并讓新終端讀取它。
- 服務名稱寫錯不會導致請求失敗，但會導致排錯混亂。
- *ase **L 寫錯最容易觸發 404 或連接失敗。
- Model ID 寫錯容易觸發 model not found。
- API Key 寫錯通常觸發 401。
?? 第五步：保存啟用后再看終端是否生效
保存配置不等于生效，啟用配置也不等于舊終端已經讀取。推薦流程是：保存配置卡，確認啟用，關閉舊終端，打開新終端，再啟動 Codex 做最小測試。
codex --version
codex如果你剛剛切換過模型或配置卡，重開終端尤其重要。很多“配置明明改了卻不生效”的問題，都卡在這一步。
- 版本命令先確認本地工具可用。
- 新終端啟動 Codex，避免舊會話干擾。
- 不要在多個終端窗口里混合測試。
第六步：用固定提示詞驗證字段是否正確
首次驗證只需要一個短提示詞，不需要讀取項目文件，也不需要讓 Codex 執行命令。目標是確認靈能API線路、CC Switch 字段和終端狀態已經連通。
New-Item -ItemType Directory codex-config-check
Set-Location codex-config-check
codex請只返回：配置字段驗證通過如果能返回固定文本，說明基礎字段基本正確。如果失敗，就根據錯誤碼回到對應字段排查，不要一次性重填全部內容。
第七步：配置文件思維怎么幫助排錯
即使你主要使用 CC Switch，也要具備配置文件思維：每張卡最終都可以理解成一組字段組合。排錯時不要只看界面有沒有保存，而要問：當前 Codex 到底讀取的是哪組字段？
排錯記錄建議：
當前卡片：靈能API-Codex-Config
*ase **L：https://www.lnsns.com/v1
模型：當前 Model ID
錯誤碼：404
操作：已重開終端，已使用固定提示詞復測這樣寫排錯記錄，比一句“不能用”更有效。你可以清楚看到問題可能屬于地址、模型、Key、終端還是任務本身。
- 記錄卡片名稱，避免誤查舊卡。
- 記錄 *ase **L 和模型，但不記錄完整 Key。
- 記錄是否重開終端，方便判斷生效問題。
第八步：真實項目只讀驗證字段鏈路
空目錄驗證通過后，可以進入真實項目，但第一輪仍然建議只讀。讓 Codex 讀取指定目錄并輸出計劃，用來確認配置鏈路在真實項目中也穩定。
請只讀分析當前項目，不要修改文件。
允許讀取：README.md、src、tests
禁止讀取：.env、密鑰文件、生產配置
輸出：項目結構、建議檢查文件、下一步計劃只讀階段成功后，再允許小范圍修改。這樣可以把接口接入問題和項目任務問題分開，避免排錯時混在一起。
常見字段錯誤速查
字段排錯的原則很簡單：一次只改一個字段，改完重開終端，用同一個固定提示詞復測。這樣才能知道是哪一步真正解決了問題。
- *ase **L 多寫 /v1：檢查是否變成 /v1/v1。
- *ase **L 寫完整路徑：不要把 chat/completions 當基礎地址。
- 模型 ID 寫展示名：從靈能API模型列表復制接口 ID。
- Key 粘貼帶空格：重新復制并檢查首尾。
- 配置卡未啟用：確認 CC Switch 當前啟用狀態。
- 終端未重開：關閉舊會話，用新終端測試。
? 最后一份字段對照接入清單
理解字段對照之后，Codex 中轉 API 接入會從“照著截圖填”變成“知道每個字段為什么存在”。靈能API提供服務入口，CC Switch管理本地配置，而字段對照和生效驗證負責讓整條鏈路清楚可控。
- 靈能API入口、賬戶、模型和額度已確認。
- API Key 已單獨為 Codex 準備并安全保存。
- CC Switch 配置卡已創建，名稱和用途清楚。
- *ase **L、Model ID、API Key 含義已對照清楚。
- 配置卡已保存、啟用，并重新打開終端。
- 空目錄固定提示詞驗證通過。
- 排錯記錄不包含完整 Key。
- 真實項目先做只讀驗證，再執行修改。