先理解：接入成功只是起點

Codex 接入 API 后，并不會自動知道你的項目規則，也不會自動判斷哪些文件可以修改。靈能API負責模型請求，CC Switch負責線路管理，Codex負責在當前目錄里執行工作。真正安全的使用方式，是把‘線路測試’和‘項目操作’分成兩個階段。

只要順序不跳步，出現問題時就能迅速判斷是配置錯誤還是項目本身的問題。

• 先在空目錄驗證線路。
• 再在項目中確認目錄和權限。
• 最后才執行局部修改和測試。

第一步：檢查本機工具是否齊全

開始之前，確認 Codex 能啟動、CC Switch 能打開，并檢查項目常用的運行時。即使暫時不運行代碼，也建議知道當前 Node.js、npm、Python 或 Git 是否可用。

codex --version
node -v
npm -v
python --version
git --version

• 命令不存在：先修復本機環境，不要急著配置 API。
• 版本不符合項目要求：讀取項目文檔和版本文件。
• 工具版本未知：不要直接升級全部依賴。

第二步：從靈能API獲取當前接口信息

打開靈能API服務入口，先確認當前可用模型、*ase **L 和令牌入口。版本變化后，舊筆記里的地址和模型名可能不再適用，所以所有關鍵字段都應以當前說明為準。

靈能API入口：https://www.lnsns.com/。不要在文章、截圖或項目倉庫中放置完整令牌。

• *ase **L：從接口說明復制。
• Model ID：從當前列表復制，不憑記憶填寫。
• API Key：創建后只在本機安全字段中使用。

第三步：創建一枚用于測試的令牌

首次接入建議使用單獨的測試令牌，而不是直接拿長期主令牌做實驗。令牌名稱可以寫‘codex-first-test’，分組和權限按照當前服務說明選擇。測試通過后，再決定是否創建用于日常開發的獨立令牌。

創建后把 Key 粘貼到受控位置，不要通過截圖或聊天記錄傳遞完整內容。

• 測試令牌與日常開發令牌分開。
• 只授予當前需要的模型和額度。
• 令牌可能暴露時立即撤銷并重新生成。

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

打開 CC Switch，進入 Codex 配置頁面，點擊新增渠道。供應商名稱建議寫成‘靈能API-Codex-首次測試’，這樣測試卡和長期使用卡可以清楚區分。

保存之前逐項核對地址、令牌和用途是否一致。不要為了測試同時修改多個高級選項。

• API Key：粘貼測試令牌并檢查空格。
• API 請求地址：填寫當前 *ase **L。
• 高級參數：沒有明確要求時先保持默認。

第五步：獲取模型并完成字段復核

點擊獲取模型列表。如果列表可以返回，說明基本的地址和鑒權已經打通。接下來選擇一個當前任務需要的模型，保存渠道。列表獲取失敗時，優先核對 *ase **L、Key、分組和網絡，不要立即重新安裝 Codex。

• 401：檢查 Key 是否完整、有效。
• 403：檢查權限、額度和分組。
• 404：檢查路徑是否重復拼接。
• 模型不存在：重新復制當前 Model ID。

第六步：啟用渠道并重啟客戶端

保存渠道后，還要點擊啟用或切換。接著關閉舊 Codex 進程并重新打開。配置切換后不重啟，是最常見的‘明明填寫正確卻還是失敗’原因之一。

啟用：靈能API-Codex-首次測試
停止：舊 Codex 窗口和終端進程
啟動：重新打開 Codex
驗證：空目錄只讀請求

如果重啟后仍然使用舊配置，檢查是否有環境變量、項目配置或另一個 CC Switch 卡片覆蓋了當前值。

第七步：空目錄完成三項驗證

首次啟動先不要進入正式項目。創建空目錄后，依次驗證工作目錄、模型回復和只讀文件讀取。每一步都得到正常結果，再進入下一步。

New-Item -ItemType Directory codex-on*oarding-check
Set-Location codex-on*oarding-check
codex

可以輸入：‘請確認當前工作目錄，并說明你不會修改任何文件。’這類請求足夠驗證線路，又不會產生項目變更。

• 測試一：確認當前目錄。
• 測試二：回答一個固定的短問題。
• 測試三：只讀測試目錄中的無敏感文件。

第八步：進入真實項目先做只讀檢查

進入項目根目錄后，第一條指令仍然不要修改代碼。先讓 Codex 確認目錄、讀取 README 和依賴文件，并說明項目的啟動命令。這樣可以確認它沒有讀錯項目，也沒有把測試目錄的上下文帶進來。

請確認當前工作目錄和項目名稱。
只讀取 README.md、package.json 和項目配置。
不要修改任何文件。
說明項目的啟動和測試命令。

• 檢查 Git 狀態，保護已有未提交修改。
• 限制讀取范圍，排除依賴和構建目錄。
• 先看項目規則，再提出下一步任務。

? 第九步：第一次修改采用小范圍任務

驗證讀取正常后，選擇一個低風險、范圍明確的任務，例如補充一個測試、修復一個提示文案或解釋一個函數。要求 Codex 先給出計劃，確認后只修改指定文件。

只處理 src/utils/**te.ts 的一個格式化問題。
先說明原因和修改計劃。
不要修改其他文件，不要升級依賴。
完成后展示 diff，并運行對應測試。

• 修改前：確認工作區已有變更。
• 修改中：限制文件和任務范圍。
• 修改后：查看 diff 和測試結果。

第十步：用錯誤碼快速定位問題

接入過程中最常見的錯誤并不需要全部重裝。先記錄錯誤碼和當前卡片名稱，再按順序檢查字段、權限、進程和網絡。

一次只調整一個變量，才能知道哪個動作解決了問題。

• 401：令牌未被接受，核對復制內容和有效狀態。
• 403：請求被拒絕，檢查權限、額度和模型分組。
• 404：地址或 Model ID 不匹配。
• 超時：縮小上下文，檢查網絡和客戶端**。
• 切換不生效：關閉舊進程并重新啟動。

? 第十一步：完成接入后的安全收尾

這樣做完后，靈能API接入 Codex 就不只是一次成功的試運行，而是一套可以重復使用、出錯可恢復的工作流程。

• 測試令牌是否需要保留，決定后及時禁用。
• 配置卡名稱是否清晰，是否能區分項目和環境。
• 項目 .env 是否被 Git 忽略。
• 截圖、日志和文檔中沒有完整 API Key。
• 保留一張已驗證的穩定配置作為回滾點。