Codex 連接靈能API教程：cc-switch 配置中轉站與 GPT-5.6 的實戰流程

分類：都市

作者：佚名

主角：

來源：靈能API

更新時間： 2026-08-03 17:04:48

開始閱讀閱讀更多

精彩片段

Codex 連接靈能API教程：cc-switch 配置中轉站與 GPT-5.6 的實戰流程如果你希望讓 Codex 通過中轉站穩定調用模型，真正需要掌握的不是復制一段配置，而是弄清楚賬號、API Key、Base URL、模型 ID、cc-switch 當前啟用狀態和終端緩存之間的關系。本篇以靈能API為示例，從準備工作開始，一步步完成配置、驗證、切換與

Codex 連接靈能API教程：cc-switch 配置中轉站與 GPT-5.6 的實戰流程

如果你希望讓 Codex 通過中轉站穩定調用模型，真正需要掌握的不是復制一段配置，而是弄清楚賬號、API Key、*ase **L、模型 ID、cc-switch 當前啟用狀態和終端緩存之間的關系。本篇以靈能API為示例，從準備工作開始，一步步完成配置、驗證、切換與排錯。

發布日期：2026-08-03

一、先明確目標：讓 Codex 只認一條**證的線路

本教程要完成的結果是：在 Windows 電腦上安裝 Codex，通過 cc-switch 新增一條靈能API配置，填入自己的 API Key、接口地址和可用模型，然后在全新終端中完成一次只讀請求。只有這條最小鏈路跑通后，才建議繼續增加備用模型、多個項目配置或自動化腳本。

可以把整條請求鏈路理解成五個節點：Codex 負責發起任務；本地配置負責告訴它訪問哪里；cc-switch 負責保存和啟用線路；靈能API負責接收鑒權并轉發請求；模型服務負責返回結果。任何一個節點出錯，終端里的表現都會不同，所以要按節點排查，而不是反復重裝。

安裝失敗：優先檢查 Node.js、npm 和 PATH。
鑒權失敗：優先檢查靈能API API Key、賬戶權限和啟用狀態。
模型不存在：優先檢查控制臺顯示的精確模型 ID。
改完不生效：優先關閉舊終端和舊 Codex 進程。

二、在靈能API控制臺準備賬戶和 API Key

先打開靈能API官網：https://www.lnsns.com/，登錄賬戶并進入控制臺。第一次配置建議單獨創建一枚“Codex 專用” API Key，這樣后續查看用量、撤銷權限或更換線路時，不會影響其他項目。官網入口是 https://www.lnsns.com/，如果你已經登錄，也可以直接從控制臺的密鑰管理頁面繼續。

接下來還要在靈能API**確認可用模型。教程標題使用 GPT-5.6 作為示例，但具體賬戶能否調用、控制臺實際展示什么名稱，必須以靈能API當前模型列表為準。模型名稱多一個字符、少一個連字符，都可能返回 model not found。

進入靈能API控制臺并完成登錄。
找到 API Key、密鑰管理或令牌管理入口。
創建一枚用途明確的密鑰，例如 Codex-Windows。
復制密鑰后立即保存到密碼管理器，不要發布到文章、截圖或 Git 倉庫。

三、檢查 Windows 環境：先驗證工具，再驗證接口

在 PowerShell 中執行以下命令。每條命令都有返回結果后再進入下一步，可以避免把本地安裝問題誤判為靈能API接口問題。

node -v
npm -v
where.exe node
where.exe npm

如果前兩條沒有版本號，先安裝 Node.js LTS；如果有版本號但 where.exe 找不到路徑，關閉當前 PowerShell 后重新打開。npm 的下載源只影響 Codex 安裝包下載，不會改變靈能API請求地址。需要時可以執行：

npm config set registry https://registry.npmmirror.com
npm config get registry

完成環境檢查后，安裝 Codex 并確認命令已進入 PATH。

npm install -g @openai/codex
codex --version
codex --help

四、理解 cc-switch：它管理的是“當前啟用配置”

cc-switch 的核心作用是集中管理多套供應商配置，并把其中一套寫入 Codex 當前會讀取的位置。保存一張卡片，不代表 Codex 已經開始使用；你還需要啟用這張卡片，并重啟讀取舊配置的終端。

cc-switch Codex 配置頁截圖 — 圖 1：先切換到 Codex 頁面，再點擊添加配置按鈕。

打開 cc-switch 后，先進入 Codex 對應頁面。不要在 Claude 或其他工具的頁面中新增配置，因為不同工具的字段結構和配置文件可能不一樣。進入 Codex 頁面后，再點擊添加配置或新增供應商。

五、新增靈能API配置：先命名，再填連接信息

在 cc-switch 的 Codex 頁面選擇“自定義配置”。供應商名稱可以填寫“靈能API-Codex”，備注可以寫“GPT-5.6 主線路”或項目名稱。命名的目的不是影響請求，而是讓你以后切換時一眼知道哪張卡片對應靈能API。

cc-switch 自定義配置入口截圖 — 圖 2：新增供應商時選擇自定義配置，便于填寫靈能API的連接信息。

供應商名稱：靈能API-Codex。
備注：寫明用途，例如 Windows Codex 主線路。
官網鏈接：填寫 https://www.lnsns.com/，用于本機識別和回到控制臺。
API Key：粘貼從靈能API控制臺創建的完整密鑰。
API 請求地址：填寫 https://www.lnsns.com/v1，注意不要重復追加 /v1。
模型名稱：填寫靈能API模型列表中的精確模型 ID。

六、四個字段的常見誤填方式

第一個高頻錯誤是把靈能API官網地址和 API 請求地址混用。官網地址 https://www.lnsns.com/ 用于進入控制臺；請求地址 https://www.lnsns.com/v1 用于程序發送兼容接口請求。兩者相關，但作用不同。

第二個錯誤是復制 API Key 時帶入了空格或換行。建議在粘貼后用鍵盤方向鍵檢查首尾，不要自行給密鑰加引號。第三個錯誤是模型名稱憑記憶輸入，正確做法是回到靈能API模型列表復制。**個錯誤是接口地址重復寫成 https://www.lnsns.com/v1/v1，這通常會造成 404。

官網地址： https://www.lnsns.com/
API 請求地址： https://www.lnsns.com/v1
模型名稱：以靈能API控制臺顯示的實際 model ID 為準
API Key：使用自己的密鑰，不要使用示例值

如果 cc-switch 提供獲取模型列表或管理與測速按鈕，可以先填 API Key 和請求地址，再執行一次輕量測試。獲取模型列表成功后，再把準確的模型 ID 寫入模型名稱，通常比直接猜名稱更穩。

七、保存、啟用、重啟：三個動作缺一不可

點擊添加或保存后，先確認靈能API-Codex卡片已經出現在 Codex 配置列表中。然后點擊啟用，使它成為當前線路。最后關閉舊的 Codex 進程和 PowerShell，重新打開終端。Codex 通常在啟動時讀取配置，舊終端不會因為 cc-switch 狀態變化而自動刷新。

cc-switch 供應商字段填寫截圖 — 圖 3：重點核對 API Key、請求地址和模型名稱，示例內容不能直接替代自己的賬戶信息。

建議按這個順序操作：保存靈能API配置 → 啟用靈能API卡片 → 完全退出舊終端 → 新開 PowerShell → 在小目錄啟動 Codex。不要在舊終端中連續重試，因為那樣很可能一直使用舊的 auth.json 或 config.toml。

八、先測短請求，再進入真實項目

如果 cc-switch 內置測試返回成功，說明當前卡片至少能夠完成一次基礎請求。接下來新建一個空目錄，避免真實項目中的環境變量、**或項目級配置干擾驗證。

cc-switch 配置測試結果截圖 — 圖 4：先在 cc-switch 中完成輕量測試，再進入終端驗證 Codex。

mkdir codex-lingneng-check
cd codex-lingneng-check
codex

進入 Codex 后，先輸入只讀任務：請分析當前目錄，列出文件并說明下一步需要哪些信息，不要修改任何文件。如果返回正常，再讓它解釋一段短代碼或生成一個小型修改計劃。此時如果出現錯誤，可以更明確地判斷是靈能API連接、模型能力還是項目權限問題。

如果你需要回到靈能API控制臺查看余額、模型和密鑰狀態，官網入口仍然是 https://www.lnsns.com/。不要為了測試把真實 API Key 粘貼到 Codex 對話內容中，密鑰應該只存在于受控配置位置。

九、cc-switch 沒有生效時，檢查本地文件

如果界面顯示靈能API已啟用，但 Codex 仍然訪問舊線路，可以檢查用戶目錄下的 .codex 文件夾。常見文件包括 config.toml 和 auth.json。先備份，再查看，不要一上來刪除整個目錄。

$codexHome = Join-Path $HOME '.codex'
Get-ChildItem $codexHome -Force
Get-Content (Join-Path $codexHome 'config.toml') -ErrorAction SilentlyContinue

下面是幫助理解字段關系的示例。靈能API的接口地址、模型和鑒權方式要以當前控制臺及 Codex 版本說明為準；如果你的版本字段不同，不要把示例強行覆蓋到現有配置中。

model_provider = "lingneng"
model = "gpt-5.6"

[model_providers.lingneng]
name = "靈能API"
*ase_url = "https://www.lnsns.com/v1"
wire_api = "responses"
requires_openai_auth = true

檢查文件后，只修改一個變量并重啟終端驗證。不要同時修改模型、地址、Key 和環境變量，否則即使問題解決，也很難知道是哪一步起作用。