Codex 中轉站接入教程：靈能API CC Switch 從舊線路遷移到新線路
很多人不是第一次接入 Codex 中轉站，而是已經有一條舊線路在用，后來想切換到更穩定、更清晰的新線路。遷移時如果直接覆蓋配置，很容易出現舊 Key 殘留、*ase **L 混用、模型 ID 不匹配、終端仍走舊會話等問題。本文以靈能API和 CC Switch 為例，整理一套從舊線路備份、新配置建立、最小請求驗證到真實項目回歸的遷移接入流程。
遷移前先別覆蓋舊配置
從舊中轉線路遷移到新線路時，最容易犯的錯就是直接覆蓋原配置。看起來省事，實際會讓排錯變得很麻煩：你不知道舊 Key 是否還在生效，不知道舊 *ase **L 是否被某個終端緩存，也不知道模型 ID 是來自舊服務還是新服務。
更穩的做法是先備份舊配置摘要，再建立新的靈能API配置卡。舊線路保留為回滾參考，新線路單獨驗證。等新線路在空目錄、測試項目和真實項目里都通過后，再決定是否停用舊線路。
- 舊配置先備份，不直接覆蓋。
- 新線路單獨建卡，不和舊卡混在一起。
- 遷移驗證分階段完成。
- 成功后再清理舊 Key 和舊卡片。
第一步：打開靈能API確認新線路信息
遷移的第一步，是進入靈能API服務入口，確認新線路所需的信息：賬戶狀態、模型列表、額度、*ase **L 和 API Key 創建入口。入口：https://www.lnsns.com/
不要把舊線路的模型名稱直接搬到新線路里。不同服務的展示名稱、接口 ID、版本后綴可能不完全一致，最終應以靈能API當前模型列表為準。
- 確認賬戶能正常登錄。
- 確認當前模型列表里有要用于 Codex 的模型。
- 確認額度足夠完成遷移測試。
- 準備創建 Codex 專用 API Key。
第二步：記錄舊線路的非敏感摘要
遷移前可以記錄舊線路信息，但不要復制完整 API Key。舊線路摘要的價值是方便對照和回滾，不是把敏感憑證再存一份。
舊線路摘要：
舊卡片名稱：Codex-Old-Relay
舊 *ase **L：只記錄域名和路徑，不記錄 Key
舊模型：舊線路默認模型
用途：日常開發或測試
狀態：遷移前是否可用
備注：不要保存完整 API Key如果舊線路本來就已經失敗，也要記錄錯誤碼。這樣新線路驗證失敗時，才不會誤以為所有問題都是遷移造成的。
- 記錄卡片名稱，方便區分舊線路。
- 記錄舊模型和用途，方便判斷遷移后是否等價。
- 記錄是否可用，方便排查遷移前后的差異。
第三步：為新線路創建 Codex 專用 Key
新線路不建議復用舊 Key，也不要把其他工具的 Key 拿來混用。遷移時最好創建一枚明確用于 Codex 的新 Key，命名里寫清用途和日期。
Key 命名建議：
Codex-Lingneng-Main-202608
Codex-Migration-****-202608
Codex-ProjectA-NewRelay
記錄：用途、創建日期、負責人
禁止：完整 Key 明文進入截圖、文章、日志如果遷移是因為舊 Key 泄露，則不要等待驗證完成，應該盡快撤銷舊 Key，并用新 Key 完成接入。
- 新 Key 創建后立即保存到安全位置。
- 復制到 CC Switch 前檢查首尾空格。
- 遷移成功后再決定舊 Key 是否撤銷。
**步：在 CC Switch 新建遷移配置卡
打開 CC Switch，新建一張獨立配置卡，不要直接改舊卡。建議命名為“靈能API-Codex-Migration”或“靈能API-Codex-Main-New”。這樣遷移階段可以清楚地區分新舊線路。
遷移卡的目標是建立一條干凈的新基線。等新線路通過驗證后，再根據舊卡需求補充項目參數或備用模型。
- 卡片名稱要包含靈能API和遷移用途。
- 用途備注寫清新線路驗證。
- 模型先選擇穩定模型，降低排錯難度。
- 不要一開始就復制舊卡所有高級參數。
第五步：填寫新線路核心字段
遷移卡里最關鍵的仍然是 *ase **L、Model ID 和 API Key。三個字段必須來自同一套靈能API賬戶信息，不要把舊線路的地址、舊模型和新 Key 混在一起。
服務名稱：靈能API-Codex-Migration
*ase **L：https://www.lnsns.com/v1
Model ID：從靈能API當前模型列表復制
API Key：新創建的 Codex 專用 Key字段填完后保存配置卡，并確認當前啟用的是新遷移卡，而不是舊線路卡。
- *ase **L 不要重復 /v1。
- 不要把完整接口路徑當成基礎地址。
- Model ID 不要沿用舊服務里的展示名稱。
- API Key 粘貼后檢查首尾空格。
?? 第六步：啟用新卡后重開終端
CC Switch 切換到新遷移卡后，要關閉舊 Codex 會話和舊終端。舊會話可能仍然讀取舊線路，繼續在里面測試會造成誤判。
codex --version
codex如果你同時打開多個項目窗口，遷移測試階段建議全部關閉，只保留一個新終端，減少線路混淆。
- 先確認 Codex 命令能正常啟動。
- 再進入空目錄做最小測試。
- 不要在舊終端里判斷新線路是否生效。
第七步：空目錄驗證新線路
新線路第一次驗證不要放在真實項目里。新建空目錄，只發送固定短提示詞。這樣可以排除項目文件、依賴、測試命令和長上下文干擾。
New-Item -ItemType Directory codex-migration-check
Set-Location codex-migration-check
codex請只返回：新 Codex 中轉線路驗證通過如果返回成功，說明新靈能API線路、CC Switch 卡片和新終端會話已經基本連通。如果失敗，就按錯誤碼定位，不要馬上修改真實項目。
第八步：真實項目先做只讀回歸
空目錄通過后，進入真實項目仍然先做只讀回歸。讓 Codex 讀取有限目錄并輸出項目結構、關鍵文件和下一步計劃，確認新線路在真實項目上下文中也穩定。
請只讀分析當前項目，不要修改文件。
允許讀取：README.md、src、tests
禁止讀取：.env、密鑰文件、生產配置、數據庫備份
輸出：項目結構、關鍵文件、下一步建議只讀回歸通過后，再做一個低風險小修改，例如更新 README 或補充單個測試。不要剛遷移完成就執行大規模重構。
第九步：遷移失敗時按錯誤碼處理
遷移排錯時一次只改一個變量。先修 Key，再查地址，再查模型，最后看項目任務體量。這樣才能知道到底是哪一步解決了問題。
- 401：檢查新 Key 是否完整、是否屬于當前靈能API賬戶、是否首尾帶空格。
- 403：檢查賬戶額度、模型權限和訪問策略。
- 404：檢查 *ase **L 是否重復 /v1，模型 ID 是否來自新線路。
- 429：暫停重試，降低頻率，檢查近期用量。
- timeout：先用空目錄短提示詞復測，再檢查網絡和**。
- 仍走舊線路：確認 CC Switch 已啟用新卡，并重開終端。
第十步：遷移成功**理舊線路
新線路通過空目錄和真實項目驗證后，再處理舊線路。根據情況可以停用舊卡、撤銷舊 Key、歸檔舊配置摘要，并在團隊文檔中更新新線路說明。
清理舊線路不是可有可無。長期保留多個不明用途的卡片和 Key，會讓后續排錯越來越難。
- 舊 Key 已泄露：立即撤銷。
- 舊線路不再使用：停用或刪除舊卡。
- 仍需觀察：標記為舊線路，不作為默認入口。
- 團隊使用：同步更新接入文檔和負責人。
? 最后一份遷移接入清單
按遷移流程接入后，Codex 中轉站會更容易長期維護。靈能API提供新的中轉 API 和模型入口，CC Switch負責新舊線路切換，而備份、驗證和清理流程負責讓遷移過程不混亂。