先分清三個東西：Codex、CC Switch 和中轉服務

Codex 是實際執行任務的客戶端，CC Switch 是用于保存和切換配置的管理工具，靈能API則提供 API 地址、令牌和模型信息。三者各自負責不同環節：CC Switch 配置正確，不代表 Codex 進程已經讀取；Codex 能啟動，也不代表當前模型和令牌有效。

理解這三個角色后，遇到問題就能知道應該回到安裝、配置還是服務頁面檢查。

• Codex：打開會話、讀取項目、執行任務。
• CC Switch：管理服務商、模型和當前啟用線路。
• 靈能API：提供當前接口、模型、令牌和賬戶信息。

第一步：安裝前先檢查 Windows 環境

首次安裝建議使用新的 PowerShell 窗口。先確認 Node.js 和 npm 是否可用，再安裝 Codex。每條命令單獨執行并觀察結果，避免一口氣粘貼多條命令后無法定位失敗位置。

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

如果提示無法識別，先安裝 Node.js LTS 并重新打開終端。如果版本號正常但路徑異常，檢查 PATH 是否加載了正確的安裝目錄。這個階段不需要修改 API 配置。

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

安裝成功的最低標準是 node、npm 和 codex 都能返回版本或幫助信息。

第二步：從靈能API頁面準備當前參數

打開靈能API公開頁面或控制臺，確認當前模型列表、Model ID、接口地址和令牌入口。不要直接復制舊教程里的固定模型名，模型、價格和頁面說明可能更新。

建議為首次啟動創建一枚單獨的 Codex 令牌，名稱中注明設備或用途，例如 Codex-Windows-First-****。完整令牌只保存在本地私密位置，不要進入截圖、文章或倉庫。

• 官網入口：https://www.lnsns.com/
• *ase **L：按照當前接口說明填寫版本路徑。
• Model ID：從當天模型列表復制。
• API Key：使用首次測試專用密鑰。

? 第三步：在 CC Switch 中創建首次啟動卡

打開 CC Switch，進入 Codex 配置區域并新增自定義服務商。首次使用不建議同時創建很多模型，先建立一張基礎卡，確認流程成功后再復制出主線路、實驗線路和備用線路。

服務名稱建議寫成“靈能API-Codex-首次測試”。備注可以寫設備、日期和用途。名稱只影響本地識別，但清晰命名能幫助你判斷當前到底啟用了哪條線路。

• 名稱：靈能API-Codex-首次測試。
• 備注：Windows / First **** / 只讀。
• 舊卡片：如已有可用配置，保留用于回退。

?? **步：填寫字段并確認配置沒有串臺

建議按照協議、地址、模型、令牌的順序填寫。先處理不敏感的格式字段，再粘貼 API Key。復制配置卡后尤其要重新核對 Model ID，舊卡片的模型不會自動適應新任務。

服務名稱：靈能API-Codex-首次測試
*ase **L：https://www.lnsns.com/v1
Model ID：以當前模型列表為準
API Key：首次測試專用令牌

*ase **L 通常填寫到 /v1，不要填官網首頁，也不要把完整接口路徑重復拼接進去。出現 404 時先查地址；出現 model not found 時先查 Model ID；出現 401 時再查 Key。

如果 CC Switch 提供獲取模型列表按鈕，可以先保存地址和 Key，再點擊獲取。列表獲取成功是基礎連接通過的信號，但最終還要用 Codex 新進程測試。

第五步：保存、啟用，再重新打開客戶端

新卡片保存后，確認它已經出現在列表中，并點擊啟用或設為當前配置。接著關閉舊的 Codex、PowerShell 和相關**進程，再重新打開。只點擊切換而不重啟，舊進程可能仍然使用之前的配置。

命令行和桌面端如果分別讀取不同配置，建議先只驗證一種啟動方式。命令行驗證通過后，再打開桌面端或其他入口，避免兩個進程同時使用不同線路導致結果難以判斷。

codex --version
mkdir codex-first-session
cd codex-first-session
codex

? 第六步：用空目錄完成第一次會話

首次會話建議在空目錄中完成，不要直接進入重要項目。進入 Codex 后發送一條只讀任務：請確認當前目錄是否為空，并說明如果這里是一個項目，你會按什么順序檢查文件，不要創建、刪除或修改任何文件。

這條任務可以同時檢查命令是否啟動、令牌是否有效、模型是否返回以及當前工作目錄是否正確。若返回正常，再進入真實項目執行局部讀取任務。

第一次不要直接發送批量重構、刪除文件或長時間自動執行任務。先觀察模型是否理解指令，確認線路穩定后再增加任務范圍。

第七步：恢復項目會話時先確認目錄和線路

需要繼續某個項目時，先在 PowerShell 中進入正確目錄，再檢查版本控制狀態和當前配置卡。不要從上一次打開的終端直接繼續，尤其是中途切換過線路或模型的情況。

cd D:\work\your-project
git status
codex

進入項目后的第一條任務建議是只讀取一個指定文件，說明入口、依賴和潛在風險，不修改內容。確認 Codex 讀取的是正確項目后，再提出下一步計劃。

如果項目包含多個環境配置，先說明哪些文件可以讀取、哪些文件不能觸碰。API Key、生產配置和用戶數據不要因為‘項目已經打開’就自動暴露給模型。

第八步：用測試面板確認線路是否真的生效

界面測試和 Codex 會話分別驗證不同環節。CC Switch 測試更接近地址、令牌和模型字段；Codex 會話則驗證客戶端進程是否讀取了當前配置。兩者都通過，才算首次接入完成。

排錯記錄只保留卡片名稱、錯誤碼、Model ID 和時間，不記錄完整 API Key。

• 測試失敗：先檢查卡片字段和服務狀態。
• 測試成功但 Codex 失敗：關閉舊進程并重新啟動。
• Codex 成功但項目失敗：縮小項目讀取范圍。

首次使用常見問題

恢復順序建議是：切回已知可用卡片、關閉舊進程、空目錄測試、比較字段，最后才考慮重新安裝。

• 命令不存在：檢查 Node.js、npm、Codex 和 PATH。
• 401：確認令牌完整、有效且屬于當前卡片。
• 403：檢查額度、模型權限和分組范圍。
• 404：檢查 *ase **L 是否重復 /v1。
• model not found：從當前列表重新復制 Model ID。
• 切換無效：保存并啟用卡片后，關閉舊進程再啟動。
• 項目讀取錯誤：檢查 PowerShell 當前目錄。

首次接入后的安全收尾

首次會話成功后，把測試令牌和正式令牌分開管理。測試結束后，如果不再使用測試令牌就撤銷；正式線路只保留必要權限。不要把完整配置文件直接發給團隊成員，分享時只提供脫敏模板。

靈能API官網：https://www.lnsns.com/

• API Key 不進入 Git、截圖、文章和公開日志。
• 測試線路和正式線路分別命名。
• 升級 Codex 或 CC Switch 后重新完成空目錄測試。
• 需要查看當前模型和服務信息時，通過官網入口進入。

最終檢查：第一次能用，之后也能恢復

完成這份檢查后，首次接入就不再是一次性復制配置，而是一套可以重復啟動、切換和恢復的使用流程。

• Node.js、npm 和 Codex 命令可用。
• CC Switch 中的首次測試卡已保存并啟用。
• *ase **L、Model ID 和 API Key 已逐項核對。
• 舊終端已關閉，新進程完成空目錄只讀任務。
• 進入真實項目前確認目錄和版本控制狀態。
• 主線路、備用線路和測試線路用途清晰。