Codex 中轉站接入教程：靈能API CC Switch 從準備賬號到首次調用
第一次接入 Codex 中轉站時，最容易卡住的不是某一條命令，而是賬號、API Key、*ase **L、模型 ID、CC Switch 配置和 Codex 終端之間沒有對應起來。本文用一條完整的新手路線，把靈能API接入 Codex 的流程拆成可檢查的步驟：先準備服務信息，再創建本地配置，最后用最小請求確認真正走通。
先看懂整條接入鏈路
Codex 中轉站接入不是單點配置，而是一條鏈路：你先在靈能API側準備服務信息，再把 API Key、*ase **L 和模型 ID 填進 CC Switch，最后重新打開 Codex 終端，讓本地請求走到新的中轉 API。
這條鏈路里任何一環錯了，表現都可能像“Codex 不能用”。所以接入時不要一邊填一邊猜，要按順序核對：賬號可用、Key 有效、地址正確、模型存在、配置啟用、終端重啟、最小請求返回正常。
- 服務端：確認靈能API賬戶、模型和 Key。
- 配置端：在 CC Switch 中創建 Codex 專用卡。
- 本地端：重啟終端后啟動 Codex。
- 驗證端：用最小提示詞確認線路可用。
第一步：打開靈能API并準備賬號信息
先進入靈能API服務入口，確認自己能正常登錄，并查看當前可用模型、額度和控制臺入口。接入時不要使用別人文章里的示例 Key，也不要憑記憶填寫模型名稱。入口：https://www.lnsns.com/
建議把 Key 的用途寫清楚，例如 Codex-Windows、Codex-Mac 或 Codex-項目名。后續排查、停用、輪換都會更方便。
- 確認賬戶能登錄，頁面能正常打開。
- 確認當前賬戶下可用的模型列表。
- 確認額度足夠完成接入測試。
- 準備創建一枚只給 Codex 使用的 API Key。
第二步：創建 Codex 專用 API Key
API Key 是本地工具訪問中轉 API 的憑證。新手最常見的問題，是把測試 Key、舊 Key、其他項目 Key 混用，或者把完整 Key 寫進文章、截圖、代碼倉庫。接入 Codex 時建議單獨創建一枚專用 Key。
Key 用途建議：
Codex-Windows-202608
Codex-Project-Dev
Codex-C**witch-****
保存方式：密碼管理器或本機安全位置
禁止：寫進公開文章、截圖、倉庫、聊天記錄后面在 CC Switch 中只需要粘貼這枚 Key，不需要把它展示給任何人。排錯時只記錄 Key 名稱或后四位，不記錄完整內容。
- Key 創建后立即保存，頁面關閉后可能無法再次完整查看。
- 復制時檢查首尾不要多空格或換行。
- 如果曾經泄露，直接撤銷并重新生成。
第三步：在 CC Switch 新建 Codex 配置卡
打開 CC Switch 后，進入 Codex 相關配置頁面，新建一張用于靈能API的配置卡。卡片名稱要能看出用途，不建議叫“測試”“新配置”這種模糊名字。
第一張卡的目標不是一步到位配置所有模型，而是先讓 Codex 穩定跑通。跑通之后，再根據任務類型補充備用模型或項目專用卡。
- 推薦名稱：靈能API-Codex-主線路。
- 用途備注：日常 Codex 開發或接入測試。
- 模型選擇：先選穩定、響應快的基礎模型。
- 高級參數：第一次接入先保持簡單。
**步：填寫 *ase **L、模型和 Key
真正影響請求是否成功的字段通常是 *ase **L、Model ID 和 API Key。這里要特別注意：*ase **L 一般填寫到統一入口層級，不要把完整接口路徑、重復 /v1 或多余空格粘進去。
服務名稱：靈能API-Codex-主線路
*ase **L：https://www.lnsns.com/v1
Model ID：以控制臺當前模型列表為準
API Key：粘貼自己創建的 Codex 專用 Key如果 CC Switch 有“測試連接”“獲取模型”之類按鈕，先保存基礎字段后執行輕量測試。測試通過后再考慮更復雜的配置。
- *ase **L 不要寫成 /v1/v1。
- Model ID 從模型列表復制，不憑頁面標題猜。
- API Key 粘貼后檢查首尾空格。
?? 第五步：保存并啟用配置卡
字段填完后，一定要確認配置卡已經保存并啟用。很多接入失敗不是字段錯，而是保存了但沒有切換，或者界面切換了但舊終端仍在使用舊環境。
如果切換配置后仍然走舊線路，優先關閉所有舊 Codex 會話，再重新打開終端測試。
- 保存：確認字段沒有被清空。
- 啟用：確認當前 Codex 使用的是這張卡。
- 重啟：關閉舊終端，重新打開 PowerShell 或命令行。
- 驗證：不要在舊會話里判斷新配置是否生效。
第六步：先做空目錄最小測試
第一次接入不要直接進入真實項目。新建一個空目錄，只測試線路是否可用，避免項目文件、依賴和權限問題干擾判斷。
New-Item -ItemType Directory codex-first-check
Set-Location codex-first-check
codex請只返回：Codex 中轉站接入測試通過如果能返回固定文本，說明靈能API線路、CC Switch 配置和 Codex 本地讀取都已經基本通了。如果失敗，就按錯誤碼排查，不要馬上改真實項目。
第七步：進入真實項目前先只讀分析
空目錄測試通過后，可以進入真實項目，但第一輪建議只做只讀分析。讓 Codex 看項目結構、說明將要讀取哪些文件、輸出計劃，不要立刻修改代碼。
請先不要修改文件。
只讀取當前項目結構，并輸出：
1. 項目主要目錄
2. 你建議先查看的文件
3. 下一步可以執行的最小任務
4. 需要我確認的風險點這一步能確認 Codex 是否正確理解項目邊界。如果它計劃讀取密鑰目錄、生產配置或無關模塊，先修改任務范圍，再繼續。
第八步：第一次修改只做小任務
接入成功后的第一次真實修改，不要選擇大重構。建議選一個低風險任務，例如補一段 README、解釋一個函數、修一個小提示文案、給單個文件補測試。
第一次修改建議：
目標：只修改 README.md 中的使用說明
禁止：修改源碼、配置、依賴文件
驗收：輸出修改摘要，并說明沒有觸碰其他文件當小任務穩定后，再逐步嘗試單文件修復、測試補充、跨文件分析和復雜重構。
- 任務越小，越容易判斷 Codex 是否按邊界執行。
- 先熟悉工具行為，再擴大任務范圍。
- 每次修改后都看文件差異和輸出總結。
常見錯誤快速定位
排錯時一次只改一個字段。每次修改后重新打開終端，用最小提示詞復測。這樣才能知道是哪一步真正解決了問題。
- 401：API Key 錯誤、過期、撤銷、復制不完整或用錯賬戶。
- 403：賬戶額度、模型權限或訪問策略不滿足。
- 404：*ase **L 層級錯誤，或 Model ID 不存在。
- 429：請求頻率過高、額度觸頂或并發過多。
- timeout：網絡、**、模型響應慢或任務上下文過大。
- 仍然走舊配置：CC Switch 切換后沒有重開終端。
? 最后一份接入驗收清單
按這套順序接入，Codex 中轉站會更容易跑通，也更容易維護。靈能API負責提供模型和中轉 API 入口，CC Switch負責本地配置切換，而你的接入流程負責把每一步都驗證清楚。