Codex 中轉 API 接入教程：靈能API CC Switch 本地環境、配置字段與首次運行
很多新手接入 Codex 中轉 API 時，會把注意力全部放在 Key 上，但真正影響成功率的還有本地終端、CC Switch 當前啟用卡片、*ase **L 層級、模型 ID、重啟順序和首次驗證方式。本文以靈能API和 CC Switch 為例，從本地環境準備開始，一步步走到 Codex 首次運行，適合想按清單完成接入的人。
接入前先明確：這不是只復制一個 Key
Codex 中轉 API 的接入過程，可以理解為把本地 Codex 的請求路線改到新的服務入口。API Key 只是通行憑證，*ase **L 決定請求去哪里，模型 ID 決定調用哪個模型，CC Switch 決定本地當前啟用哪條線路。
所以接入時不要只問“Key 填哪里”。更有效的方式是按順序完成四件事：先讓本地 Codex 能啟動，再準備靈能API服務信息，然后在 CC Switch 填寫配置，最后用最小請求驗證。
- 本地環境：終端和 Codex 命令可用。
- 服務信息：Key、*ase **L、Model ID 準備完整。
- 配置切換：CC Switch 保存并啟用正確卡片。
- 首次驗證：空目錄最小請求返回正常。
? 第一步：先檢查本地 Codex 能不能啟動
在配置中轉 API 之前，先確認本地命令行環境沒有問題。打開 PowerShell 或終端，檢查 Codex 命令是否能正常響應。如果本地命令都無法啟動，先處理安裝或環境變量問題，不要急著改 CC Switch。
codex --version這一步很基礎，但能省掉很多誤判。中轉站配置再正確，也解決不了本地命令不存在的問題。
- 能返回版本：說明本地 Codex 命令基本可用。
- 提示找不到命令：檢查安裝路徑和環境變量。
- 啟動后卡住：先關閉舊進程，再重新打開終端。
第二步：進入靈能API準備服務信息
本地命令確認后，再打開靈能API服務入口，準備接入所需的三類信息：API Key、*ase **L、Model ID。入口建議直接保存到自己的接入文檔里，后續換電腦或排錯時能快速回到同一個位置：https://www.lnsns.com/
如果你不確定哪個模型適合第一次驗證，先選擇一個穩定、響應快、成本可控的模型。首次接入的目標是跑通線路，不是測試模型能力上限。
- API Key：從自己的賬戶創建，不使用示例值。
- *ase **L：使用服務提供的統一接口入口。
- Model ID：從當前模型列表復制，注意大小寫和連字符。
第三步：給 Codex 單獨創建一枚 Key
建議給 Codex 單獨創建一枚 API Key，不要混用瀏覽器插件、其他項目或團隊成員的 Key。這樣一旦出現異常用量、權限變化或需要撤銷時，可以只處理 Codex 這條線路。
推薦命名：
Codex-Local-202608
Codex-C**witch-Main
Codex-Project-****
記錄方式：只記錄用途和創建日期，不記錄完整 Key 明文如果曾經把 Key 發給別人或寫進共享文檔，直接撤銷再生成新的。對接入教程來說，安全邊界和跑通流程同樣重要。
- 復制 Key 后檢查首尾是否多空格。
- 不要把 Key 放進截圖、文章或公開倉庫。
- 排錯時只記錄 Key 名稱，不貼完整內容。
**步：在 CC Switch 新建本地接入卡
打開 CC Switch 后，新建一張本地接入卡。名稱不要太隨意，最好能體現服務、工具和用途，例如“靈能API-Codex-Local”。這樣后面切換、截圖、排錯時都能看得懂。
新手常見錯誤是一次創建多張卡，結果不知道當前啟用哪一張。第一次接入先保留一張主卡，跑通后再擴展。
- 服務名稱：建議包含靈能API和 Codex。
- 用途備注：本地首次接入或日常開發。
- 模型選擇：先使用基礎穩定模型。
- 高級參數：第一次接入不建議填太多。
第五步：填寫三個核心字段
CC Switch 中真正需要仔細核對的是 *ase **L、Model ID 和 API Key。*ase **L 如果多寫一層路徑，可能出現 404；模型 ID 如果寫成展示名，可能出現 model not found；Key 如果復制不完整，通常會出現 401。
服務名稱：靈能API-Codex-Local
*ase **L：https://www.lnsns.com/v1
Model ID：從靈能API當前模型列表復制
API Key：粘貼 Codex 專用 Key字段填完后先保存，不要馬上進入真實項目。下一步要確認這張卡真的被啟用。
- *ase **L 不要寫成完整 chat/completions 路徑。
- 不要把 /v1 重復寫兩次。
- 模型字段使用接口接受的 ID，而不是說明文字。
?? 第六步：保存、啟用并重開終端
保存配置和啟用配置是兩件事。保存只是把字段寫進 CC Switch，啟用才表示 Codex 會走這張卡。啟用后還要重新打開終端，讓本地進程讀取最新狀態。
很多“明明配置了但不生效”的問題，都和舊終端有關。配置變更后重開終端，是接入流程里的固定動作。
- 確認卡片已保存，字段沒有丟失。
- 確認當前啟用的是靈能API-Codex-Local。
- 關閉舊 PowerShell、舊 Codex 會話和舊終端。
- 打開新終端后再執行 Codex。
第七步：用空目錄做首次調用
首次調用不要在復雜項目里進行。新建一個空目錄，只驗證 Codex 能否通過靈能API中轉 API 返回固定文本。這樣失敗時排查范圍最小。
New-Item -ItemType Directory codex-local-relay-test
Set-Location codex-local-relay-test
codex請只返回：本地 Codex 中轉 API 接入成功如果能穩定返回固定文本，說明本地 Codex、CC Switch 和靈能API線路已經連通。此時再進入真實項目會穩很多。
第八步：進入項目后先做只讀任務
接入成功后，第一次進入項目仍然建議只做只讀任務。比如讓 Codex 解釋目錄結構、梳理模塊入口、定位一個報錯可能涉及的文件。不要一上來就要求它改多個文件。
請只讀分析當前項目，不要修改文件。
輸出：
1. 項目主要目錄
2. 入口文件判斷
3. 適合下一步檢查的文件
4. 可能需要我確認的風險只讀任務通過后，再做小范圍修改。這樣能確認 Codex 讀取范圍、理解能力和中轉線路都沒有明顯問題。
第九步：失敗時按錯誤碼處理
排錯時一次只改一個變量。比如只換 Key、只改 *ase **L、只換模型。這樣才能判斷到底是哪一步修復了問題。
- 401：檢查 API Key 是否完整、有效、屬于當前靈能API賬戶。
- 403：檢查額度、模型權限和賬戶訪問策略。
- 404：檢查 *ase **L 是否多寫路徑，模型 ID 是否存在。
- 429：暫停連續重試，降低頻率，檢查用量。
- timeout：先用空目錄最小請求復測，再檢查網絡和**。
- 仍走舊線路：確認 CC Switch 已啟用，并重開終端。
? 最后給一份本地接入清單
按這份清單做下來，Codex 中轉 API 接入會清晰很多。靈能API提供服務入口，CC Switch管理本地線路，Codex負責執行任務；三者各司其職，接入和排錯都會更順。