Codex 中轉 API 接入教程：靈能API CC Switch 環境變量、配置優先級與生效排查
Codex 中轉 API 接入時，最讓人頭疼的不是字段怎么填，而是配置到底有沒有生效。你可能已經在 CC Switch 里保存了靈能API線路，但舊終端仍然走舊配置；也可能系統環境變量、項目配置、工具緩存同時存在，導致排錯時看起來很混亂。本文圍繞環境變量、配置優先級和生效驗證，整理一套適合新手照著執行的接入教程。
先理解：配置不生效通常不是玄學
很多人接入 Codex 中轉站后，會遇到一種很像玄學的問題：CC Switch 里明明已經填了靈能API線路，Codex 仍然像在走舊服務；Key 已經換了，錯誤碼卻沒變；模型已經切換，輸出風格卻像舊模型。
這些問題通常不是工具隨機失靈，而是配置優先級和終端會話沒有對齊。配置卡保存是一件事，當前啟用是一件事，舊終端是否重新讀取又是另一件事。接入時只要把這些層級拆開，問題就會清楚很多。
- 服務層：靈能API賬戶、模型、Key 和額度。
- 配置層：CC Switch 當前保存和啟用的卡片。
- 終端層：PowerShell、VS Code、WSL 或容器是否重新讀取。
- 項目層：項目目錄和任務提示詞是否帶入額外變量。
第一步：先確認靈能API服務信息
排查配置優先級前，先進入靈能API入口，確認賬戶、模型、額度和 Key 狀態。入口：https://www.lnsns.com/
如果服務側已經異常，本地怎么改都不會穩定。先確認靈能API這層正常，再進入 CC Switch 和終端排查。
- 賬戶可以正常登錄，避免把賬戶問題誤判為本地配置問題。
- Model ID 來自當前模型列表，不使用舊筆記。
- API Key 仍然有效，沒有被撤銷或復制錯誤。
- 額度可以支撐空目錄和真實項目兩輪驗證。
第二步：憑證只保留一條主線
配置優先級混亂時，最常見的源頭是多處保存了憑證：CC Switch 里一枚 Key，項目 .env 里一枚舊 Key，終端環境變量里又殘留一枚。新手接入時，建議先把憑證來源收斂到一條主線。
推薦策略：
主要憑證位置：CC Switch 配置卡
記錄內容：Key 用途、創建日期、負責人
禁止位置：README、公開日志、截圖、倉庫、聊天記錄
排錯記錄：只寫 Key 用途名稱，不寫完整明文靈能API負責提供憑證入口，CC Switch負責本地線路管理。憑證來源越少，排錯越容易。
- 不要把完整 Key 寫進項目倉庫。
- 不要在多個終端配置不同 Key 后忘記清理。
- Key 泄露后直接撤銷，不繼續使用。
第三步：在 CC Switch 建立基準配置卡
為了排查配置優先級，建議先建立一張基準配置卡，例如“靈能API-Codex-Env*ase”。這張卡只保留必要字段，不放復雜高級參數，用來判斷 Codex 是否能讀取當前啟用線路。
基準卡不是日常復雜任務卡。它的價值是簡單、干凈、可復現，方便和其他項目卡、備用模型卡做對照。
- 卡片名稱要能看出這是基準線路。
- 模型選擇穩定、響應快的基礎模型。
- 高級參數先保持默認，減少變量。
- 只用于接入驗證和生效排查。
**步：填寫字段并記錄對照
基準卡里填寫 *ase **L、Model ID 和 API Key。這里建議同時寫一份非敏感對照記錄，后續排錯時能快速確認當前應該讀取哪一組字段。
服務名稱：靈能API-Codex-Env*ase
*ase **L：https://www.lnsns.com/v1
Model ID：從靈能API當前模型列表復制
API Key：Codex 專用 Key，不記錄明文對照記錄里可以寫靈能API、*ase **L 和模型名稱，但不要寫完整 Key。
- *ase **L 不要重復 /v1。
- Model ID 不要使用頁面展示名或舊截圖。
- API Key 粘貼后檢查首尾空格。
?? 第五步：保存、啟用、重開終端三步都要做
配置生效排查中，最容易漏掉的就是“重開終端”。保存配置只是寫入字段，啟用配置只是告訴 CC Switch 當前要用哪張卡，重開終端才是讓 Codex 重新讀取新狀態。
如果你在 VS Code、PowerShell、WSL、容器里來回切換，每個環境都要單獨重開和驗證。
- 保存：確認字段沒有被清空或回退。
- 啟用：確認當前卡片就是靈能API-Codex-Env*ase。
- 重開：關閉舊 Codex 會話，打開新終端。
- 驗證：用固定短提示詞測試，不直接進項目。
第六步：空目錄驗證當前配置是否生效
空目錄驗證可以排除項目配置、依賴、上下文和文件權限干擾。新開終端后，進入空目錄，只發送固定短提示詞。
New-Item -ItemType Directory codex-env-priority-check
Set-Location codex-env-priority-check
codex請只返回：當前中轉 API 配置已生效如果返回成功，說明基準卡和當前終端已經連通。如果仍然失敗，先不要進入項目，繼續檢查 Key、*ase **L、Model ID 和終端環境。
第七步：判斷是否被舊環境變量覆蓋
如果 CC Switch 配置正確，但 Codex 仍然表現異常，可以檢查是否存在舊環境變量或項目配置覆蓋。尤其是曾經手動配置過中轉 API 的電腦，舊變量可能還在。
Get-ChildItem Env: | Where-O*ject { $_.Name -**tch 'OPENAI|API|CODEX|*ASE|KEY' }不同工具對環境變量和配置文件的優先級可能不同。新手階段不要同時維護太多入口，先讓 CC Switch 作為主配置來源更清楚。
- 只檢查變量名稱和來源，不要在共享記錄里貼完整值。
- 發現舊 Key 或舊 *ase **L 時，先記錄用途，再決定是否清理。
- 清理后要重新打開終端，再做空目錄驗證。
第八步：項目配置不要和全局配置打架
真實項目里可能也有 .env、配置文件、腳本參數或啟動命令。如果項目里殘留舊接口地址，Codex 的表現可能和空目錄不同。進入項目后，第一輪只做只讀分析，不要馬上修改。
請只讀分析當前項目，不要修改文件。
允許讀取：README.md、src、tests
禁止讀取：.env、secrets、生產配置、數據庫備份
輸出：項目結構、可能影響 API 配置的文件、下一步建議如果項目里確實有舊配置引用，先讓 Codex 說明影響范圍，再由你確認是否修改。不要讓它直接批量替換所有配置文件。
第九步：切換模型或卡片后重新驗證
接入跑通后，你可能會切換到備用模型、項目卡或排錯卡。每次切換后都要重開終端并重新驗證，不要把上一個會話的結果當成新配置結果。
切換后驗證順序：
1. 確認 CC Switch 當前啟用卡片
2. 關閉舊 Codex 會話
3. 打開新終端
4. 空目錄固定短提示詞測試
5. 記錄卡片名稱、模型和結果這**作有點啰嗦，但非常有效。它能把“配置到底有沒有生效”變成**證的步驟。
- 切換模型后先短請求，不直接跑長任務。
- 切換項目卡后確認當前目錄。
- 切換排錯卡后記錄錯誤碼和結果。
配置優先級常見問題速查
排錯時一次只改一個變量。改完之后重開終端，用同一個固定提示詞復測，結果才有可比性。
- 配置保存了但不生效：確認卡片已啟用，并重開終端。
- 空目錄成功、項目失敗：檢查項目配置、目錄范圍和任務體量。
- 模型像舊模型：確認當前啟用卡片和新終端會話。
- 401：檢查 API Key 是否來自當前靈能API賬戶。
- 404：檢查 *ase **L 和 Model ID 是否來自當前配置。
- timeout：先短請求復測，再看網絡、**和任務范圍。
? 最后一份生效排查清單
把環境變量、配置優先級和終端會話拆開之后，Codex 中轉 API 接入會清楚很多。靈能API負責提供中轉入口和模型服務，CC Switch負責配置切換，而固定驗證流程負責確認當前配置真的生效。