為什么要用中轉方式接入 Codex

Codex 本身更像一個執行任務的客戶端，真正決定它使用哪種模型的，是你提供的賬戶或 API 配置。對于希望按量使用模型、需要在多個模型之間切換，或者不想頻繁修改本地配置文件的用戶，中轉站配合 CC Switch 是一條相對清晰的管理路徑。

它的價值不在于把所有模型都堆進來，而在于把入口、密鑰、模型和切換動作集中管理。配置完成后，可以按任務選擇線路；遇到某條線路異常，也可以切換到備用配置進行對照。

需要先說明的是：不同服務商的頁面字段和模型名稱可能不同，本文的具體地址和品牌信息以靈能API當前頁面為準。

• 配置集中：API 地址、令牌和模型可以在一張卡片中管理。
• 模型可選：根據任務需要選擇不同能力和成本的模型。
• 便于切換：不用反復手動編輯多個本地配置文件。
• 排錯清晰：可以保留主線路和備用線路進行對照。

開始前準備：只需要兩類工具和三項參數

接入前先準備本地客戶端和服務參數。建議使用新的 PowerShell 窗口，避免舊環境變量或舊進程干擾第一次測試。

node -v
npm -v
npm install -g @openai/codex
codex --version

如果 node、npm 或 codex 無法識別，先解決本地安裝和 PATH 問題。工具鏈通過后再創建令牌，可以避免把軟件安裝錯誤誤判成 API 請求錯誤。

• 本地工具：Node.js、npm、Codex 和 CC Switch。
• 服務參數：API Key、*ase **L、Model ID。
• 安全準備：一個只讀測試目錄，以及保存密鑰的**位置。

第一步：先看靈能API的模型信息

進入靈能API公開頁面或控制臺后，先查看當前模型列表、模型接口 ID 和計費說明。模型頁面的展示名是給人看的，CC Switch 最終需要的是服務端能夠識別的 Model ID。不要直接照抄舊教程里的固定模型名稱。

閱讀模型信息時，至少記錄三項：模型名稱、輸入價格、輸出價格。輸入通常包括你的問題、項目上下文和代碼；輸出則是模型生成的回答、代碼或修改建議。長任務往往同時消耗大量輸入和輸出，因此不能只看其中一項價格。

• 官網入口：https://www.lnsns.com/
• 模型 ID：從當前列表復制，不憑記憶輸入。
• 價格單位：確認是按 1M Tokens、余額或其他單位展示。

第二步：創建一枚專門用于 Codex 的令牌

在控制臺創建令牌時，名稱只要能識別用途即可，例如 Codex-Windows 或 Codex-Project-****。不要把多個應用的密鑰混在一起，專用令牌便于查看調用、控制風險和后續撤銷。

如果頁面提供分組、渠道或模型范圍選項，先理解它們的含義，再提交。分組通常影響可用模型、路由范圍或計費折算；它不是簡單的備注字段。Codex 使用哪一組，應以控制臺當天的說明和可用模型列表為準。

令牌生成后通常只完整顯示一次。復制時不要粘貼到公開文檔，也不要把完整密鑰發給他人。若復制失敗或懷疑泄露，直接撤銷并生成新令牌，不要繼續使用不確定的舊密鑰。

• 名稱：寫清客戶端、設備或用途。
• 分組：選擇與 Codex 和目標模型匹配的分組。
• 權限：只開啟完成任務所需的范圍。

第三步：看懂折扣、輸入輸出和倍率

模型價格頁面常見折扣、輸入、輸出和倍率幾個概念。它們可能來自不同的計費層，不能簡單地把一個數字當成最終成本。比較模型時，先確認單位和計算方式，再判斷是否適合自己的任務。

Token 可以粗略理解為模型處理文本時使用的計量單位。中文、英文、代碼、標點和空格的占用方式并不完全相同，所以不要用字數直接等同于 Token。項目級任務往往同時包含大量輸入上下文和輸出代碼，實際消耗會比一句短問答高。

更穩妥的選擇方式是：先用低風險、短文本測試模型，再根據任務長度和回答質量決定是否切換到更強模型。不要為了追求最低單價，忽略上下文、穩定性和返回質量。

• 折扣：表示相對某個基準價格的折算比例，不等于最終余額扣除額。
• 輸入價格：處理提示詞、上下文、代碼和問題的費用。
• 輸出價格：處理模型生成內容的費用，長回答通常更明顯。
• 倍率：平臺內部對模型、輸出或分組進行換算的參數。

? **步：在 CC Switch 中新建 Codex 配置

打開 CC Switch，進入 Codex 菜單并點擊新增渠道或自定義供應商。CC Switch 的主要作用是保存和切換配置，因此可以同時保留多個線路。配置名稱建議包含靈能API、Codex 和用途，方便之后確認當前啟用的卡片。

新增時先填寫服務名稱和備注，再處理請求字段。服務名稱本身不會改變接口，但清晰的命名可以降低切換錯誤。建議保留原有已知可用配置，測試新渠道失敗時可以立即切回。

• 供應商名稱：靈能API-Codex-主線路。
• 備注：Windows / Codex / 日常開發。
• 官網鏈接：https://www.lnsns.com/

?? 第五步：填寫 API 地址、密鑰和模型

進入詳細字段后，按照‘地址—模型—密鑰’的順序填寫。地址先確認路徑層級，模型再核對接口 ID，最后粘貼令牌。這樣出現 404 或 model not found 時，可以先排除格式問題，再檢查鑒權。

供應商名稱：靈能API-Codex-主線路
API Key：粘貼剛剛創建的專用令牌
API 請求地址：https://www.lnsns.com/v1
模型名稱：以靈能API當前模型列表為準

*ase **L 通常填寫到 /v1，不要把官網地址當成 API 地址，也不要把完整的接口路徑重復拼進去。最常見的地址錯誤是 /v1/v1、少寫版本路徑，或者把不屬于當前服務的域名粘貼進來。

如果 CC Switch 提供獲取模型列表按鈕，可以先保存地址和 Key，再執行獲取。能夠拉到模型列表，說明地址、密鑰和基礎協議至少已經形成了初步閉環；但最終仍要通過 Codex 實際啟動驗證。

第六步：選擇模型、保存并啟用渠道

獲取模型列表后，從當前可用列表中選擇一個適合測試的模型。首次接入建議選擇響應快、任務范圍適中的模型，不要一上來就用最長上下文或最復雜的模型。選擇后點擊添加或保存，并確認這張卡片已經出現在 Codex 渠道列表。

注意：新建配置通常不會自動成為當前線路。保存后還要點擊啟用、切換或設為當前配置。界面上應能看到選中狀態或啟用標記。若沒有啟用，Codex 仍會繼續使用舊渠道。

• 模型列表能加載：地址、Key 和基礎連接大概率正確。
• 模型已添加：說明配置卡保存完成。
• 卡片已啟用：說明下一次新進程可以讀取它。

? 第七步：重啟 Codex 并***低風險驗證

切換渠道后必須關閉舊的 Codex 和 PowerShell 窗口，再重新打開。舊進程可能仍然持有之前的環境變量或配置狀態，只在 CC Switch 中點擊切換而不重啟，容易造成‘頁面顯示新線路，實際請求走舊線路’。

mkdir codex-relay-check
cd codex-relay-check
codex

進入 Codex 后，先發一條只讀指令：請確認當前目錄是否為空，并說明如果這里是一個代碼項目，你會先檢查哪些內容，不要創建、刪除或修改文件。這個任務可以驗證命令啟動、身份認證、模型返回和工作目錄。

如果空目錄測試成功，再進入真實項目讀取一個指定文件。確認返回穩定后，才允許它提出或執行小范圍修改。第一次接入不建議直接運行批量重構、刪除文件或長時間自動任務。

常見問題：按錯誤碼定位，不要反復重裝

排錯時記錄錯誤碼、卡片名稱、模型 ID 和時間，不要記錄完整 API Key。一次只修改一個字段，才能判斷哪項變化解決了問題。

• 401：檢查令牌是否完整、是否被撤銷，以及當前啟用的卡片是否正確。
• 403：檢查賬戶額度、分組權限、模型權限或訪問策略。
• 404：檢查 API 請求地址，尤其確認沒有重復 /v1。
• model not found：回到模型列表重新復制精確 Model ID。
• 模型列表獲取失敗：檢查地址、Key、網絡和客戶端協議選項。
• 切換后沒有變化：關閉舊終端和 Codex 進程，啟用卡片后重新打開。
• 請求超時：先縮短任務，減少上下文，再檢查網絡、**和服務狀態。

安全收尾：讓這套配置可以長期使用

令牌能用不等于可以隨意傳播。建議為不同設備或用途創建獨立令牌，把完整 Key 保存在密碼管理器中。需要分享教程或截圖時，只展示字段位置，不展示真實密鑰、賬號信息和完整請求頭。

需要查看當前模型、令牌和服務信息時，通過可點擊的靈能API官網入口進入：https://www.lnsns.com/。實際頁面說明優先于舊截圖和舊文章。

• 主線路、測試線路和備用線路分別命名。
• 更換令牌時先創建新 Key 并驗證，再撤銷舊 Key。
• 模型或客戶端升級后重新***空目錄測試。
• 不要把含密鑰的配置文件提交到 Git 或公開網盤。

最終清單：五分鐘完成一次自檢

當這份清單全部通過時，中轉接入就從一次性的復制配置，變成了一套可以復查、切換和維護的工作流程。

• Node.js、npm 和 Codex 命令可用。
• 令牌由自己的控制臺創建，且沒有出現在公開內容中。
• 分組或渠道與 Codex 和目標模型匹配。
• *ase **L 和 Model ID 來自當前服務列表。
• CC Switch 渠道已保存并啟用。
• 舊 Codex 已關閉，新終端完成只讀驗證。
• 真實項目首次只讀取局部文件，修改前已確認回退方式。