這篇教程適合什么場景

如果你希望在 Codex 中使用不止一條模型線路，或者希望在快速問答、代碼修改和長任務之間切換不同模型，那么把配置集中放在 CC Switch 中會更容易管理。本文不依賴某一張默認卡片，而是從命名、字段、測試和回退四個方面建立可復用流程。

先完成一條穩定線路，再增加第二條和第三條，不要第一次就同時配置大量模型。

• 已有 Codex，但需要接入 API 線路。
• 同時使用多個模型，需要快速切換。
• 希望遇到故障時能切回上一條可用配置。

接入前準備與文件安全

準備工作主要包括 Codex、CC Switch、靈能API賬戶和一個空目錄。配置過程中會出現 API Key，這類內容不要寫進 README、截圖、Git 提交或共享文檔。首次測試也不要直接進入包含客戶資料或生產密鑰的項目。

• Codex 可以正常啟動。
• CC Switch 能進入 Codex 配置菜單。
• 擁有可用額度和可撤銷的測試令牌。
• 準備一個不含敏感內容的測試目錄。

第一步：先確認靈能API的當前模型

先打開靈能API服務入口，查看當前模型列表和接口說明。模型名稱、版本后綴和支持能力可能隨時間變化，所以不要直接使用舊配置中的 Model ID。對于 Codex，優先選擇當前說明中明確支持客戶端請求的模型。

靈能API入口：https://www.lnsns.com/。先確認信息，再進入令牌創建和客戶端配置。

• 記錄 *ase **L，但不把完整令牌寫在筆記里。
• 復制精確 Model ID，保留大小寫和分隔符。
• 根據任務選擇適合的模型，不盲目追求數量。

第二步：為不同用途創建令牌

建議至少區分日常開發和臨時測試兩類令牌。日常開發令牌用于穩定工作，臨時測試令牌用于驗證新模型或新地址。這樣即使測試配置被誤分享，也不會影響長期使用的主線路。

令牌只在本機安全位置保存。文章、截圖和團隊說明里只保留字段名稱與脫敏示例。

• 名稱寫用途，例如 codex-dev 或 codex-test。
• 分組按照當前服務說明和項目權限選擇。
• 不使用時及時禁用臨時令牌。
• 出現泄露可能時直接撤銷，不繼續觀察。

第三步：用任務而不是價格選擇模型

模型配置不要只按價格排序。快速解釋一個函數、**安全問題、處理長上下文和執行多文件改動，關注點都不同。可以把模型分成快速卡、**卡和長任務卡，先用短任務測試輸出質量和穩定性。

查看輸入、輸出和倍率時，要結合真實任務估算，不要把單一折扣數字當成最終成本。

• 快速卡：短上下文、快速反饋、適合小修改。
• **卡：關注證據、風險和結構化輸出。
• 長任務卡：關注上下文處理和連續工作穩定性。

? **步：在 CC Switch 中創建第一張卡

打開 CC Switch 的 Codex 頁面，點擊加號或新增渠道。供應商名稱建議包含靈能API、用途和模型類型，例如‘靈能API-Codex-開發’。名稱清楚后，多個渠道同時存在時不容易選錯。

保存前再次確認卡片名稱、地址和 Key 屬于同一用途，避免把一個項目的令牌配到另一個項目。

• API Key 粘貼測試令牌，檢查是否帶有空格。
• API 請求地址填寫當前 *ase **L。
• 不確定的高級字段先保持默認。

第五步：獲取模型并建立第二張卡

點擊獲取模型列表。如果能返回列表，說明基礎地址和鑒權大概率已經通過。選擇一個用于短任務的模型保存第一張卡，然后復制這張卡創建第二張卡，只修改 Model ID，保留其他字段不變。

靈能API-Codex-開發-快速
靈能API-Codex-開發-深度
共同字段：*ase **L、權限范圍
對比字段：Model ID

一次只修改一個字段，后續測試才知道速度和輸出變化究竟來自模型，還是來自地址、權限或其他參數。

第六步：切換配置的正確順序

新增渠道后，點擊啟用或切換到目標卡片。然后完全退出正在運行的 Codex，再重新打開。桌面窗口、終端進程和**任務都可能繼續使用舊配置，只切換界面狀態并不能保證請求已經更新。

啟用目標卡片
關閉舊 Codex 進程
重新啟動 Codex
進入空目錄發送短請求
記錄返回模型或結果

切換后仍返回舊結果時，檢查舊進程、系統環境變量和項目配置是否覆蓋了 CC Switch 的值。

第七步：先做三次小測試

新卡片不要直接用于大型重構。建議連續做三次小測試：確認工作目錄、解釋一段短文本、讀取一個無敏感內容的文件。三次都正常后，再進入真實項目。

New-Item -ItemType Directory codex-model-check
Set-Location codex-model-check
codex

• 測試一：確認當前目錄和運行狀態。
• 測試二：讓模型回答一個固定問題。
• 測試三：只讀一個簡單文件并給出摘要。

第八步：進入項目后使用分階段提示

接入成功只是起點。進入真實項目后，先讓 Codex 讀取目錄和項目說明，再給出任務計劃。確認范圍后才修改文件，修改完成后檢查 diff 并運行針對性測試。

先讀取項目結構，不修改文件。
說明與本任務相關的文件。
給出執行計劃和可能風險。
等待確認后再修改。
完成后展示 diff 和測試結果。

• 不要讓模型默認掃描整個倉庫。
• 不要把配置、令牌和業務秘密放進提示詞。
• 不要跳過 Git 狀態和變更檢查。

第九步：出錯時先回到穩定卡

新模型或新配置出現問題時，先切回已經驗證過的穩定卡，再判斷是模型、地址、權限還是客戶端緩存。不要在一張失敗卡片上連續修改多個字段。

排錯記錄只保存時間、卡片名稱、錯誤碼和脫敏后的配置，不保存完整令牌。

• 401：核對 Key 是否完整和仍然有效。
• 403：檢查額度、分組和模型權限。
• 404：檢查 *ase **L 的路徑拼接。
• 超時：縮短上下文，降低并發，檢查網絡。
• 切換不生效：退出舊進程并重新啟動。

? 多模型接入完成清單

按照這套順序，靈能API不僅可以完成一次接入，還能讓 Codex 在不同任務之間保持清晰、可控的模型切換。

• 第一張靈能API渠道可以完成最小請求。
• 第二張渠道只修改了明確的對比字段。
• 卡片名稱包含項目、環境或用途。
• 切換后已重啟 Codex 并通過短任務測試。
• 穩定卡仍然保留，可以隨時回退。
• 真實項目采用只讀、計劃、修改、測試的順序。
• API Key 未進入截圖、倉庫和共享文檔。