先了解這套接入方式

Codex 是客戶端，CC Switch 是配置切換工具，靈能API提供模型接口。三者分工不同：靈能API負責接收請求并返回模型結果，CC Switch 保存和切換線路，Codex 則負責在項目或對話中發起任務。

理解這三個角色后，遇到問題就能判斷應該檢查服務、配置卡還是客戶端進程，而不是反復重填所有字段。

• 靈能API：提供 *ase **L、模型和令牌。
• CC Switch：管理多條配置，減少手工修改。
• Codex：讀取當前啟用線路并執行開發任務。

開始前需要準備什么

正式配置前，先準備好 Codex、CC Switch 和一個用于測試的空目錄。Codex 與 CC Switch 的菜單名稱可能隨版本變化，但整體流程通常是：安裝客戶端、創建 API 令牌、添加渠道、獲取模型、啟用渠道、重啟 Codex。

首次接入建議先使用較小額度進行驗證，確認地址、模型、權限和客戶端流程都正常后，再用于長任務。

• Codex 已安裝并可以啟動。
• CC Switch 已安裝，并能打開 Codex 配置頁面。
• 已準備靈能API賬戶和可用額度。
• 準備一個不含敏感代碼的空目錄做首次測試。

第一步：確認靈能API的接口信息

打開靈能API服務入口，查看當前可用模型、接口說明和令牌管理入口。不同模型的標識和權限可能不同，不建議使用舊教程中的地址或手動猜測 Model ID。

靈能API官網入口：https://www.lnsns.com/。本文示例不會展示真實令牌，也不會把令牌寫入項目文件。

• *ase **L：從當前接口說明復制。
• Model ID：從當前模型列表復制精確標識。
• API Key：創建后只在安全位置查看和保存。

第二步：創建專用 API 令牌

在令牌管理頁面創建一枚用于 Codex 的令牌。名稱建議寫成‘codex-local’或‘project-a-codex’，方便后續識別。不要把郵箱、密碼或完整 Key 寫進名稱，也不要把同一枚高權限令牌長期分發給所有設備。

創建完成后，復制令牌并立即保存到本機安全位置。若頁面只顯示一次，關閉頁面后不要嘗試從聊天記錄或截圖中找回。

• 令牌名稱：寫用途和設備，不寫秘密內容。
• 令牌分組：選擇明確支持 Codex 的分組，或按照當前說明選擇。
• 權限范圍：只授予當前任務需要的模型和額度。
• 有效期：臨時測試盡量使用可撤銷或短周期令牌。

第三步：看懂模型、Token 和倍率

中轉服務的模型頁面通常會同時展示輸入價格、輸出價格和分組倍率。輸入是你發送給模型的提示詞、代碼和上下文；輸出是模型生成的回答。Token 可以理解為模型計量文本和代碼的一種單位，中文、英文、符號和代碼的拆分方式并不完全相同。

比較價格時不要只看一個折扣數字，還要確認輸入、輸出、上下文和分組的具體規則。長代碼任務通常會同時產生較多輸入和輸出消耗。

• 輸入價格：發送內容所消耗的計費單位。
• 輸出價格：模型生成內容所消耗的計費單位。
• 倍率：服務對不同模型或渠道進行換算的規則。
• 分組：可能對應不同權限、價格和調用范圍。

? **步：在 CC Switch 創建 Codex 渠道

打開 CC Switch，進入 Codex 菜單，點擊新增渠道或加號。供應商名稱可以寫‘靈能API-Codex’，這樣以后和其他模型線路并存時更容易識別。

不要把完整 Key 寫進截圖、文章或公共配置文件。配置卡用于本機調用，分享時只分享字段結構。

• 供應商名稱：寫清品牌和用途。
• API Key：粘貼剛剛創建的令牌，檢查前后空格。
• API 請求地址：填寫當前說明中的 *ase **L。
• 其他字段：沒有明確要求時先使用默認值。

第五步：獲取模型并保存渠道

填寫地址和 Key 后，點擊獲取模型列表或類似按鈕。如果能成功返回模型，通常說明地址和基本鑒權已經通過；如果獲取失敗，先檢查 *ase **L、Key 和當前分組，不要立即更換多個字段。

模型列表返回后，只選擇當前任務需要的模型，并保存渠道。先不要批量添加所有模型，減少后續選擇和排錯的復雜度。

• 列表為空：確認接口地址和分組是否匹配。
• 401：重新檢查令牌是否復制完整。
• 404：檢查是否重復填寫版本路徑。
• 模型不存在：從當前列表重新選擇 Model ID。

第六步：啟用渠道并重啟 Codex

新渠道保存后，通常還需要手動啟用或切換。很多新手以為點擊保存就已經生效，實際上 Codex 進程可能仍在使用切換前的配置。正確順序是：啟用渠道、關閉舊 Codex、重新打開 Codex。

1. 在 CC Switch 中啟用靈能API-Codex
2. 關閉已經打開的 Codex 窗口和終端進程
3. 重新啟動 Codex
4. 進入空目錄發送只讀測試

如果切換后仍然返回舊模型，優先懷疑舊進程、環境變量或重復配置，而不是馬上重新創建令牌。

第七步：用最小任務完成首次驗證

首次驗證不要直接讓 Codex 修改真實項目。創建一個空目錄，讓它只執行目錄確認、短文本解釋或簡單只讀任務。這樣可以同時驗證線路、模型、權限和客戶端是否真正完成切換。

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

啟動后可以輸入：‘請確認當前工作目錄，并用三句話說明你能做什么，不要修改任何文件。’如果能穩定返回，再進入真實項目。

? 第八步：進入真實項目時分階段操作

首次接入成功后，也不要直接進行大型改造。先讓 Codex 讀取項目結構和關鍵說明，再讓它提出計劃；確認計劃后才執行局部修改；最后運行項目已有的測試命令。

把線路接入和項目變更分開驗證，出現問題時才知道是配置問題還是代碼問題。

• 階段一：確認目錄、分支和項目說明。
• 階段二：讀取與任務相關的文件。
• 階段三：輸出修改計劃和風險點。
• 階段四：只修改明確允許的文件。
• 階段五：運行局部測試并檢查 diff。

常見問題和處理順序

排錯時一次只修改一個變量，記錄錯誤碼、配置卡名稱和測試時間，不要把完整令牌發給他人協助排查。

• 無法獲取模型：檢查地址、Key、分組和網絡。
• 401：檢查令牌是否完整、有效并被當前卡片使用。
• 403：檢查模型權限、余額、額度和分組。
• 404：檢查 *ase **L 是否重復拼接路徑。
• 切換后仍是舊配置：關閉舊進程并重新啟動。
• 長任務超時：縮小上下文，分階段執行并減少并發。

? 接入完成后的檢查清單

完成這些步驟后，靈能API就可以作為 Codex 的一條穩定線路使用。后續需要切換其他模型時，復制配置卡并單獨驗證即可，不必反復破壞當前可用配置。

• Codex 和 CC Switch 已安裝并能啟動。
• 靈能API令牌已創建并安全保存。
• *ase **L 和 Model ID 來自當前接口說明。
• CC Switch 渠道已保存并明確啟用。
• 切換后已經重啟 Codex。
• 空目錄最小測試通過。
• 真實項目先只讀，再計劃，再修改和測試。