先了解這套接入方式

Codex 是客戶(hù)端，CC Switch 是配置切換工具，靈能API提供模型接口。三者分工不同：靈能API負(fù)責(zé)接收請(qǐng)求并返回模型結(jié)果，CC Switch 保存和切換線(xiàn)路，Codex 則負(fù)責(zé)在項(xiàng)目或?qū)υ?huà)中發(fā)起任務(wù)。

理解這三個(gè)角色后，遇到問(wèn)題就能判斷應(yīng)該檢查服務(wù)、配置卡還是客戶(hù)端進(jìn)程，而不是反復(fù)重填所有字段。

• 靈能API：提供 *ase **L、模型和令牌。
• CC Switch：管理多條配置，減少手工修改。
• Codex：讀取當(dāng)前啟用線(xiàn)路并執(zhí)行開(kāi)發(fā)任務(wù)。

開(kāi)始前需要準(zhǔn)備什么

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

首次接入建議先使用較小額度進(jìn)行驗(yàn)證，確認(rèn)地址、模型、權(quán)限和客戶(hù)端流程都正常后，再用于長(zhǎng)任務(wù)。

• Codex 已安裝并可以啟動(dòng)。
• CC Switch 已安裝，并能打開(kāi) Codex 配置頁(yè)面。
• 已準(zhǔn)備靈能API賬戶(hù)和可用額度。
• 準(zhǔn)備一個(gè)不含敏感代碼的空目錄做首次測(cè)試。

第一步：確認(rèn)靈能API的接口信息

打開(kāi)靈能API服務(wù)入口，查看當(dāng)前可用模型、接口說(shuō)明和令牌管理入口。不同模型的標(biāo)識(shí)和權(quán)限可能不同，不建議使用舊教程中的地址或手動(dòng)猜測(cè) Model ID。

靈能API官網(wǎng)入口：https://www.lnsns.com/。本文示例不會(huì)展示真實(shí)令牌，也不會(huì)把令牌寫(xiě)入項(xiàng)目文件。

• *ase **L：從當(dāng)前接口說(shuō)明復(fù)制。
• Model ID：從當(dāng)前模型列表復(fù)制精確標(biāo)識(shí)。
• API Key：創(chuàng)建后只在安全位置查看和保存。

第二步：創(chuàng)建專(zhuān)用 API 令牌

在令牌管理頁(yè)面創(chuàng)建一枚用于 Codex 的令牌。名稱(chēng)建議寫(xiě)成‘codex-local’或‘project-a-codex’，方便后續(xù)識(shí)別。不要把郵箱、密碼或完整 Key 寫(xiě)進(jìn)名稱(chēng)，也不要把同一枚高權(quán)限令牌長(zhǎng)期分發(fā)給所有設(shè)備。

創(chuàng)建完成后，復(fù)制令牌并立即保存到本機(jī)安全位置。若頁(yè)面只顯示一次，關(guān)閉頁(yè)面后不要嘗試從聊天記錄或截圖中找回。

• 令牌名稱(chēng)：寫(xiě)用途和設(shè)備，不寫(xiě)秘密內(nèi)容。
• 令牌分組：選擇明確支持 Codex 的分組，或按照當(dāng)前說(shuō)明選擇。
• 權(quán)限范圍：只授予當(dāng)前任務(wù)需要的模型和額度。
• 有效期：臨時(shí)測(cè)試盡量使用可撤銷(xiāo)或短周期令牌。

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

中轉(zhuǎn)服務(wù)的模型頁(yè)面通常會(huì)同時(shí)展示輸入價(jià)格、輸出價(jià)格和分組倍率。輸入是你發(fā)送給模型的提示詞、代碼和上下文；輸出是模型生成的回答。Token 可以理解為模型計(jì)量文本和代碼的一種單位，中文、英文、符號(hào)和代碼的拆分方式并不完全相同。

比較價(jià)格時(shí)不要只看一個(gè)折扣數(shù)字，還要確認(rèn)輸入、輸出、上下文和分組的具體規(guī)則。長(zhǎng)代碼任務(wù)通常會(huì)同時(shí)產(chǎn)生較多輸入和輸出消耗。

• 輸入價(jià)格：發(fā)送內(nèi)容所消耗的計(jì)費(fèi)單位。
• 輸出價(jià)格：模型生成內(nèi)容所消耗的計(jì)費(fèi)單位。
• 倍率：服務(wù)對(duì)不同模型或渠道進(jìn)行換算的規(guī)則。
• 分組：可能對(duì)應(yīng)不同權(quán)限、價(jià)格和調(diào)用范圍。

? **步：在 CC Switch 創(chuàng)建 Codex 渠道

打開(kāi) CC Switch，進(jìn)入 Codex 菜單，點(diǎn)擊新增渠道或加號(hào)。供應(yīng)商名稱(chēng)可以寫(xiě)‘靈能API-Codex’，這樣以后和其他模型線(xiàn)路并存時(shí)更容易識(shí)別。

不要把完整 Key 寫(xiě)進(jìn)截圖、文章或公共配置文件。配置卡用于本機(jī)調(diào)用，分享時(shí)只分享字段結(jié)構(gòu)。

• 供應(yīng)商名稱(chēng)：寫(xiě)清品牌和用途。
• API Key：粘貼剛剛創(chuàng)建的令牌，檢查前后空格。
• API 請(qǐng)求地址：填寫(xiě)當(dāng)前說(shuō)明中的 *ase **L。
• 其他字段：沒(méi)有明確要求時(shí)先使用默認(rèn)值。

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

填寫(xiě)地址和 Key 后，點(diǎn)擊獲取模型列表或類(lèi)似按鈕。如果能成功返回模型，通常說(shuō)明地址和基本鑒權(quán)已經(jīng)通過(guò)；如果獲取失敗，先檢查 *ase **L、Key 和當(dāng)前分組，不要立即更換多個(gè)字段。

模型列表返回后，只選擇當(dāng)前任務(wù)需要的模型，并保存渠道。先不要批量添加所有模型，減少后續(xù)選擇和排錯(cuò)的復(fù)雜度。

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

第六步：?jiǎn)⒂们啦⒅貑?Codex

新渠道保存后，通常還需要手動(dòng)啟用或切換。很多新手以為點(diǎn)擊保存就已經(jīng)生效，實(shí)際上 Codex 進(jìn)程可能仍在使用切換前的配置。正確順序是：?jiǎn)⒂们馈㈥P(guān)閉舊 Codex、重新打開(kāi) Codex。

1. 在 CC Switch 中啟用靈能API-Codex
2. 關(guān)閉已經(jīng)打開(kāi)的 Codex 窗口和終端進(jìn)程
3. 重新啟動(dòng) Codex
4. 進(jìn)入空目錄發(fā)送只讀測(cè)試

如果切換后仍然返回舊模型，優(yōu)先懷疑舊進(jìn)程、環(huán)境變量或重復(fù)配置，而不是馬上重新創(chuàng)建令牌。

第七步：用最小任務(wù)完成首次驗(yàn)證

首次驗(yàn)證不要直接讓 Codex 修改真實(shí)項(xiàng)目。創(chuàng)建一個(gè)空目錄，讓它只執(zhí)行目錄確認(rèn)、短文本解釋或簡(jiǎn)單只讀任務(wù)。這樣可以同時(shí)驗(yàn)證線(xiàn)路、模型、權(quán)限和客戶(hù)端是否真正完成切換。

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

啟動(dòng)后可以輸入：‘請(qǐng)確認(rèn)當(dāng)前工作目錄，并用三句話(huà)說(shuō)明你能做什么，不要修改任何文件。’如果能穩(wěn)定返回，再進(jìn)入真實(shí)項(xiàng)目。

? 第八步：進(jìn)入真實(shí)項(xiàng)目時(shí)分階段操作

首次接入成功后，也不要直接進(jìn)行大型改造。先讓 Codex 讀取項(xiàng)目結(jié)構(gòu)和關(guān)鍵說(shuō)明，再讓它提出計(jì)劃；確認(rèn)計(jì)劃后才執(zhí)行局部修改；最后運(yùn)行項(xiàng)目已有的測(cè)試命令。

把線(xiàn)路接入和項(xiàng)目變更分開(kāi)驗(yàn)證，出現(xiàn)問(wèn)題時(shí)才知道是配置問(wèn)題還是代碼問(wèn)題。

• 階段一：確認(rèn)目錄、分支和項(xiàng)目說(shuō)明。
• 階段二：讀取與任務(wù)相關(guān)的文件。
• 階段三：輸出修改計(jì)劃和風(fēng)險(xiǎn)點(diǎn)。
• 階段四：只修改明確允許的文件。
• 階段五：運(yùn)行局部測(cè)試并檢查 diff。

常見(jiàn)問(wèn)題和處理順序

排錯(cuò)時(shí)一次只修改一個(gè)變量，記錄錯(cuò)誤碼、配置卡名稱(chēng)和測(cè)試時(shí)間，不要把完整令牌發(fā)給他人協(xié)助排查。

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

? 接入完成后的檢查清單

完成這些步驟后，靈能API就可以作為 Codex 的一條穩(wěn)定線(xiàn)路使用。后續(xù)需要切換其他模型時(shí)，復(fù)制配置卡并單獨(dú)驗(yàn)證即可，不必反復(fù)破壞當(dāng)前可用配置。

• Codex 和 CC Switch 已安裝并能啟動(dòng)。
• 靈能API令牌已創(chuàng)建并安全保存。
• *ase **L 和 Model ID 來(lái)自當(dāng)前接口說(shuō)明。
• CC Switch 渠道已保存并明確啟用。
• 切換后已經(jīng)重啟 Codex。
• 空目錄最小測(cè)試通過(guò)。
• 真實(shí)項(xiàng)目先只讀，再計(jì)劃，再修改和測(cè)試。