Codex 中轉站接入教程：靈能API CC Switch 新電腦從零配置到項目驗證
換電腦、重裝系統或新開一臺開發機時，Codex 中轉站往往需要重新接入。很多人會直接復制舊配置，結果遇到 Key 混用、*ase **L 寫錯、CC Switch 未啟用、舊終端不生效等問題。本文以靈能API和 CC Switch 為例，把新電腦從零接入 Codex 的過程拆成一套清單：先準備服務信息，再配置本地線路，最后用空目錄和真實項目兩輪驗證。
新電腦接入先別急著復制舊配置
新環境接入 Codex 中轉站，最容易出現兩類問題：一類是舊機器上的配置沒有同步完整，另一類是舊配置本身已經過期。比如 API Key 已經撤銷、模型 ID 已調整、*ase **L 復制時多了一層路徑，或者 CC Switch 當前啟用的不是你以為的那張卡。
所以新電腦接入不要只靠復制粘貼。更穩的做法是重新走一遍最小鏈路：確認靈能API賬戶狀態，創建或確認 Codex 專用 Key，在 CC Switch 新建配置卡，重開終端，再用空目錄最小提示詞驗證。
- 先確認賬戶和模型，再填本地配置。
- 先跑空目錄，再進入真實項目。
- 先做只讀驗證，再允許文件修改。
- 排錯時一次只改一個變量。
第一步：打開靈能API確認服務信息
在新電腦上接入前，先打開靈能API入口，確認賬戶能正常訪問，并查看當前模型、額度和控制臺信息。入口建議保存到瀏覽器收藏夾或項目接入文檔中：https://www.lnsns.com/
如果舊電腦上的 Key 已經長期使用，建議在新電腦接入時重新創建一枚新 Key。這樣遷移過程更清楚，也方便后續停用舊環境。
- 賬戶可以正常登錄。
- 當前模型列表能看到準備使用的模型。
- 賬戶額度足夠完成接入測試。
- 確認是否需要重新創建 Codex 專用 Key。
第二步：為新電腦準備 Codex 專用 Key
新設備最好使用獨立命名的 API Key，不要直接沿用所有舊配置。Key 名稱里可以帶上設備、用途和日期，后續如果這臺機器停用，就能快速判斷要撤銷哪一枚憑證。
Key 命名示例：
Codex-NewPC-202608
Codex-Laptop-Dev
Codex-Office-C**witch
記錄方式：只記錄用途、創建日期和負責人，不記錄完整 Key排錯時只需要記錄 Key 的用途名稱，不要記錄完整值。只要憑證管理清楚，新電腦接入和舊環境回收都會輕很多。
- Key 創建后立即保存到安全位置。
- 不要把完整 Key 寫進教程、截圖或聊天記錄。
- 舊機器不用時，及時撤銷或輪換舊 Key。
第三步：在 CC Switch 新建新設備配置卡
打開 CC Switch，在 Codex 配置區域新建一張專門給新電腦使用的配置卡。不要直接把舊卡片名稱復制過來，否則以后很難判斷是哪臺設備、哪個項目、哪條線路出了問題。
配置卡的第一目標是讓鏈路跑通，不是把所有模型和參數一次性塞進去。等基礎驗證通過后，再按項目需求添加備用模型或獨立項目卡。
- 推薦名稱：靈能API-Codex-NewPC。
- 用途備注：新電腦首次接入或日常開發。
- 默認模型：選擇穩定、響應快的模型。
- 高級參數：首次接入先保持簡單。
**步：填寫 *ase **L、Model ID 和 API Key
新電腦接入時，三個字段必須重新核對：*ase **L、Model ID 和 API Key。舊筆記里的字段可能已經過期，復制時也容易混入空格、換行或重復路徑。
服務名稱：靈能API-Codex-NewPC
*ase **L：https://www.lnsns.com/v1
Model ID：以靈能API當前模型列表為準
API Key：粘貼新電腦專用 Key字段填完后先保存配置，不要急著進入項目。下一步要確認這張卡片確實已啟用，并且終端讀取的是新狀態。
- *ase **L 不要寫成 /v1/v1。
- 不要把完整 chat/completions 路徑填到基礎地址里。
- Model ID 不要憑展示名稱猜，直接復制接口字段。
- Key 粘貼后檢查首尾是否多空格。
?? 第五步：保存、啟用，并重新打開終端
CC Switch 保存配置后，還要確認當前啟用的是這張新設備卡。啟用后關閉舊終端，重新打開 PowerShell 或命令行，再啟動 Codex。舊會話可能還保留舊環境，不適合作為判斷依據。
如果你在新電腦上同時安裝了多個終端工具，建議先固定使用一個終端完成接入驗證，避免不同終端環境變量不一致。
- 確認字段保存后沒有丟失。
- 確認當前啟用卡片是靈能API-Codex-NewPC。
- 關閉舊 Codex 會話和舊終端。
- 打開新終端后再執行 codex。
第六步：空目錄做第一次連通性驗證
第一次驗證不要放在真實項目里。新建一個空目錄，啟動 Codex，只發送一個固定短提示詞。這樣能排除項目依賴、文件權限、測試命令等干擾。
New-Item -ItemType Directory codex-new-device-check
Set-Location codex-new-device-check
codex請只返回：新電腦 Codex 中轉站接入成功如果能返回固定文本，說明靈能API線路、CC Switch 卡片和新終端讀取都已經基本連通。如果失敗，先停在空目錄排錯，不要把問題帶進真實項目。
第七步：測試項目驗證文件讀取和小修改
空目錄通過后，可以準備一個很小的測試項目，用來驗證 Codex 是否能讀取文件、輸出計劃、執行小范圍修改和總結結果。測試項目不要包含真實密鑰或生產配置。
測試項目建議：
new-device-demo/
README.md
src/example.js
tests/example.test.js這一步能發現新電腦上的權限、路徑、終端命令和文件編碼問題。測試項目跑通后，再進入真實項目會穩很多。
- 先讓 Codex 只讀分析目錄結構。
- 再允許它修改一個低風險文件。
- 最后讓它輸出修改點和驗證結果。
第八步：進入真實項目先做只讀任務
真實項目第一輪不要直接改代碼。建議只讓 Codex 讀取指定目錄，輸出項目結構、關鍵文件和下一步計劃。這樣能確認它沒有越界讀取，也能驗證新電腦上的工作目錄和權限是否正常。
請只讀分析當前項目，不要修改文件。
允許讀取：src、tests、README.md
禁止讀取：.env、密鑰文件、生產配置、數據庫備份
輸出：項目結構、建議查看文件、下一步計劃只讀分析準確后，再開始單文件修改、測試補充或代碼**。新電腦剛接入時，先小步驗證，比一次性跑大任務更可靠。
第九步：新環境常見問題處理
新電腦接入失敗時，不要立刻懷疑所有環節。按本地命令、靈能API賬戶、CC Switch 配置、空目錄請求、項目讀取的順序排查，定位會更快。
- codex 命令不存在：先檢查安裝和環境變量。
- 401：檢查新設備 Key 是否復制完整、是否屬于當前靈能API賬戶。
- 404：檢查 *ase **L 和模型 ID，不要復制舊筆記里的過期字段。
- timeout：先用空目錄最小請求復測，再檢查網絡和**。
- 配置不生效：確認 CC Switch 已啟用新卡，并重開終端。
- 項目讀取失敗：檢查當前目錄、文件權限和禁止讀取規則。
? 最后一份新電腦接入清單
新電腦接入 Codex 中轉站，關鍵是重新建立一條**證的最小鏈路。靈能API負責提供中轉 API 和模型入口，CC Switch負責本地線路切換，而空目錄、測試項目和真實項目三段驗證，負責確保這條鏈路真的穩定可用。