這套配置由三部分組成

使用 Codex 中轉(zhuǎn)線路時(shí)，可以把整個(gè)過(guò)程理解成三層：靈能API提供接口和令牌，CC Switch保存并切換渠道，Codex在當(dāng)前目錄中發(fā)起任務(wù)。任何一層配置錯(cuò)誤，最終都可能表現(xiàn)為無(wú)法連接或模型返回失敗。

后文每一步都會(huì)給出驗(yàn)證動(dòng)作，避免只填寫字段卻無(wú)法判斷配置是否真的生效。

• 服務(wù)層：接口地址、模型列表、令牌和權(quán)限。
• 配置層：渠道名稱、API Key 和 *ase **L。
• 使用層：Codex 進(jìn)程、工作目錄和項(xiàng)目任務(wù)。

開(kāi)始前準(zhǔn)備好這些內(nèi)容

正式開(kāi)始前，確認(rèn) Codex 和 CC Switch 已安裝并能啟動(dòng)，同時(shí)準(zhǔn)備一個(gè)不含敏感文件的空目錄。首次配置建議使用可撤銷的測(cè)試令牌，驗(yàn)證通過(guò)后再創(chuàng)建日常開(kāi)發(fā)用的長(zhǎng)期配置。

不要把完整 API Key 放進(jìn)項(xiàng)目、截圖或聊天記錄；配置過(guò)程中只在本機(jī)受控字段中使用。

• Codex 客戶端或命令行版本。
• CC Switch 配置工具。
• 靈能API賬戶和可用額度。
• 一個(gè)用于最小請(qǐng)求測(cè)試的空目錄。

第一步：確認(rèn)靈能API服務(wù)信息

打開(kāi)靈能API服務(wù)入口，查看當(dāng)前可用模型、接口說(shuō)明和令牌管理位置。Model ID、*ase **L 和分組信息應(yīng)以當(dāng)前頁(yè)面為準(zhǔn)，不要直接復(fù)制舊教程中的字段。

靈能API入口：https://www.lnsns.com/。官網(wǎng)地址用于進(jìn)入服務(wù)頁(yè)面，完整令牌不要出現(xiàn)在文章和截圖中。

• *ase **L：從接口說(shuō)明復(fù)制。
• Model ID：從當(dāng)前列表復(fù)制精確名稱。
• 分組：選擇有 Codex 使用權(quán)限的分組。

第二步：創(chuàng)建 Codex 專用令牌

進(jìn)入令牌管理頁(yè)面后，創(chuàng)建一枚專門用于 Codex 的令牌。名稱建議使用‘codex-test’或‘codex-dev’，這樣以后可以區(qū)分測(cè)試、開(kāi)發(fā)和自動(dòng)化任務(wù)。

復(fù)制令牌后立即保存到安全位置。不要通過(guò)瀏覽器歷史、截圖或公共文檔保存完整內(nèi)容。

• 名稱寫用途，不寫密碼或完整 Key。
• 分組選擇當(dāng)前說(shuō)明中適用于 Codex 的選項(xiàng)。
• 權(quán)限盡量只覆蓋當(dāng)前需要的模型。
• 令牌可能泄露時(shí)，優(yōu)先撤銷并重新創(chuàng)建。

第三步：理解模型價(jià)格和 Token

模型頁(yè)面常見(jiàn)輸入價(jià)格、輸出價(jià)格和倍率等字段。輸入通常包括提示詞、代碼和上下文，輸出則是模型生成的文字或代碼。Token 是模型處理文本的一種計(jì)量單位，中文、英文、代碼和符號(hào)的消耗方式可能不同。

選擇線路時(shí)應(yīng)結(jié)合任務(wù)長(zhǎng)度、響應(yīng)穩(wěn)定性和模型能力，不要只根據(jù)頁(yè)面上的單一折扣數(shù)字判斷。

• 輸入價(jià)格：發(fā)送給模型的內(nèi)容產(chǎn)生的消耗。
• 輸出價(jià)格：模型回復(fù)內(nèi)容產(chǎn)生的消耗。
• 分組倍率：服務(wù)對(duì)不同渠道進(jìn)行的計(jì)費(fèi)換算。
• 上下文越長(zhǎng)，輸入消耗和處理時(shí)間通常越高。

? **步：在 CC Switch 中添加渠道

打開(kāi) CC Switch，進(jìn)入 Codex 菜單，點(diǎn)擊新增渠道。供應(yīng)商名稱可以填寫‘靈能API-Codex’，若之后還要配置其他模型，可以再補(bǔ)充用途或環(huán)境。

保存之前檢查 Key 是否帶有空格或換行，地址是否重復(fù)填寫了固定路徑。

• 供應(yīng)商名稱：寫清來(lái)源和用途。
• API Key：粘貼剛剛創(chuàng)建的令牌。
• API 請(qǐng)求地址：填寫當(dāng)前 *ase **L。
• 其他選項(xiàng)：不確定時(shí)先保持默認(rèn)。

第五步：獲取模型并保存配置

填寫完成后點(diǎn)擊獲取模型列表。能夠返回列表，通常說(shuō)明接口地址和基本鑒權(quán)已經(jīng)連通。選擇一個(gè)當(dāng)前需要的模型并保存渠道，第一次不要把全部模型都加入，減少選擇和排錯(cuò)成本。

模型名稱無(wú)法識(shí)別時(shí)，從當(dāng)前列表重新復(fù)制 Model ID，不要手動(dòng)修改大小寫或版本后綴。

• 沒(méi)有列表：檢查地址、Key、網(wǎng)絡(luò)和分組。
• 401：檢查令牌是否完整有效。
• 403：檢查權(quán)限、額度和模型限制。
• 404：檢查路徑是否重復(fù)拼接。

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

渠道保存后，需要在 CC Switch 中點(diǎn)擊啟用或切換到目標(biāo)渠道。之后關(guān)閉舊的 Codex 窗口和終端進(jìn)程，再重新打開(kāi)。客戶端進(jìn)程可能已經(jīng)緩存舊值，只切換界面狀態(tài)并不能保證請(qǐng)求使用新配置。

1. 啟用靈能API-Codex
2. 關(guān)閉舊 Codex 進(jìn)程
3. 重新打開(kāi) Codex
4. 進(jìn)入空目錄測(cè)試
5. 通過(guò)后再進(jìn)入真實(shí)項(xiàng)目

切換后仍然返回舊配置時(shí)，檢查是否存在舊終端、系統(tǒng)環(huán)境變量或項(xiàng)目配置覆蓋。

第七步：完成首次請(qǐng)求驗(yàn)證

首次驗(yàn)證使用空目錄和短任務(wù)，不要直接讓 Codex 修改正式項(xiàng)目。先確認(rèn)它能識(shí)別當(dāng)前目錄，再讓它回答一個(gè)簡(jiǎn)單問(wèn)題，最后讀取一個(gè)無(wú)敏感內(nèi)容的測(cè)試文件。

New-Item -ItemType Directory codex-relay-first-test
Set-Location codex-relay-first-test
codex

三項(xiàng)都通過(guò)后，再進(jìn)入真實(shí)項(xiàng)目做更長(zhǎng)的代碼任務(wù)。

• 確認(rèn)當(dāng)前工作目錄。
• 發(fā)送短文本請(qǐng)求并觀察返回。
• 執(zhí)行只讀文件測(cè)試。

? 第八步：在項(xiàng)目中采用安全的任務(wù)順序

正式項(xiàng)目中，建議按照‘確認(rèn)目錄、讀取規(guī)則、輸出計(jì)劃、局部修改、運(yùn)行測(cè)試’的順序操作。第一條指令不要直接要求全倉(cāng)庫(kù)重構(gòu)，也不要跳過(guò)項(xiàng)目已有的約束文件。

先確認(rèn)當(dāng)前項(xiàng)目根目錄和 Git 狀態(tài)。
讀取 README 和項(xiàng)目規(guī)則。
只分析與任務(wù)相關(guān)的文件。
給出計(jì)劃，等待確認(rèn)后再修改。
完成后展示 diff 和測(cè)試結(jié)果。

• 已有未提交修改時(shí)，先記錄 Git 狀態(tài)。
• 限制讀取范圍，排除構(gòu)建產(chǎn)物和依賴目錄。
• 先做低風(fēng)險(xiǎn)小任務(wù)，確認(rèn)穩(wěn)定后再擴(kuò)大范圍。

常見(jiàn)問(wèn)題處理表

排錯(cuò)時(shí)記錄錯(cuò)誤碼、卡片名稱和測(cè)試時(shí)間，一次只調(diào)整一個(gè)變量，不要發(fā)送完整 API Key。

• 無(wú)法獲取模型：核對(duì) *ase **L、Key、網(wǎng)絡(luò)和分組。
• 401：確認(rèn)令牌沒(méi)有空格、截?cái)嗷蚴А?/li>
• 403：確認(rèn)模型權(quán)限、余額和額度。
• 404：確認(rèn)地址路徑?jīng)]有重復(fù)。
• 超時(shí)：縮小上下文，檢查**和并發(fā)。
• 切換不生效：關(guān)閉舊進(jìn)程并重新啟動(dòng)。

? 配置完成后的最終檢查

當(dāng)這些檢查都完成后，Codex 就擁有了一條清晰、**證、可回滾的靈能API接入線路。

• 靈能API當(dāng)前接口和模型信息已經(jīng)確認(rèn)。
• Codex 專用令牌已創(chuàng)建并安全保存。
• CC Switch 渠道名稱清晰，字段已保存。
• 渠道啟用后已經(jīng)重啟 Codex。
• 空目錄最小請(qǐng)求通過(guò)。
• 真實(shí)項(xiàng)目先只讀，再計(jì)劃，再修改和測(cè)試。
• 令牌沒(méi)有進(jìn)入截圖、倉(cāng)庫(kù)和共享文檔。