Codex 中轉站換機教程：靈能API CC Switch 配置備份、遷移與恢復驗證
更換電腦、重裝系統或把項目交給團隊成員時，Codex 的中轉配置不能簡單復制整個用戶目錄。完整令牌、舊環境變量和緩存進程都可能帶來安全與兼容問題。本文以靈能API和 CC Switch 為例，整理一套先脫敏備份、再恢復配置、最后完成最小驗證的遷移流程。
遷移前先區分三類內容
換機時不要把所有文件打包復制。配置遷移可以分成三類：可以公開保存的結構信息、只能在安全位置保存的秘密信息，以及不應該遷移的緩存和臨時狀態。
遷移的目標是恢復可用結構，而不是把舊設備的全部狀態原樣搬過去。
- 結構信息：渠道名稱、用途、模型和地址占位符。
- 秘密信息：API Key、Cookie、環境變量真實值。
- 臨時狀態：舊進程、緩存、日志和測試目錄。
第一步：記錄靈能API的基準信息
在舊設備上打開靈能API服務入口，確認當前使用的 *ase **L、Model ID、分組和令牌用途。只記錄配置元數據，完整 Key 不進入遷移文檔。
靈能API入口：https://www.lnsns.com/。遷移文檔只保留安全的脫敏字段。
- 記錄當前主線路的用途和負責人。
- 記錄當前使用的精確 Model ID。
- 確認舊設備令牌是否需要撤銷。
第二步：先處理舊設備令牌
如果舊電腦即將交給他人、送修或重裝系統，建議先撤銷舊設備專用令牌，再在新設備創建新令牌。不要把舊 Key 復制到新電腦后長期共用。
遷移是重新整理權限的機會，不要把歷史遺留的高權限 Key 一起帶到新設備。
- 舊設備不再使用：撤銷舊令牌。
- 舊設備仍保留：明確新舊設備用途。
- 團隊遷移：為成員創建獨立令牌。
- 發現備份泄露：立即撤銷并重新生成。
第三步：**脫敏遷移模板
把每張 CC Switch 渠道整理成一份模板，寫清楚名稱、用途、環境、地址和模型。API Key 使用占位符，恢復時再從靈能API安全位置復制。
name: project-a-local
provider: 靈能API
environment: development
*ase_url: <當前 *ase **L>
model: <當前 Model ID>
api_key: <遷移時重新創建>
status: active- 一個渠道對應一個用途。
- 停用渠道標注原因，不直接刪除記錄。
- 模板放在受控目錄，不公開上傳。
? **步：在新設備安裝基礎工具
新設備先安裝 Codex 和 CC Switch，確認軟件可以啟動，再恢復渠道。不要先復制舊設備的整個配置目錄，因為版本差異和緩存文件可能導致啟動問題。
codex --version
node --version
npm --version
Get-Location- 軟件版本記錄下來，方便遷移后比較。
- 項目運行時按項目要求安裝。
- 先不要打開正式項目執行寫入任務。
第五步：在 CC Switch 重新創建渠道
打開新設備上的 CC Switch，進入 Codex 菜單，根據脫敏模板逐項創建渠道。建議在名稱中加入新設備或新環境標識，便于后續確認哪張卡正在使用。
不要只復制舊截圖里的字段；服務地址和模型列表可能已經變化。
- 供應商名稱：與遷移模板保持一致。
- API Key：使用新設備專用令牌。
- *ase **L：從當前說明重新核對。
- Model ID：從當前模型列表重新選擇。
第六步：獲取模型并檢查新舊差異
新設備配置完成后，點擊獲取模型列表。對比舊模板中的模型名稱和當前返回列表，確認沒有使用已經下線或權限不足的模型。
模型列表正常返回后，再保存渠道，不要在新設備上直接導入大量歷史配置。
- 401：檢查新令牌是否復制完整。
- 403：檢查新令牌分組和額度。
- 404：檢查當前 *ase **L。
- 模型缺失：從當前列表選擇可用模型。
第七步：啟用新渠道并清理舊進程
選擇新建渠道并啟用，然后關閉可能已經運行的 Codex、終端和**任務。新設備通常沒有舊進程，但第一次啟動前仍然要保持動作順序一致，便于以后重復遷移。
Get-Process | Where-O*ject { $_.ProcessName -**tch 'codex' }
Stop-Process -Name codex -Force -ErrorAction SilentlyContinue
Start-Process codex如果新設備的進程名稱不同，可以手動退出并重新打開；關鍵是確保 Codex 從新配置啟動。
第八步：用空目錄完成恢復驗證
恢復后的第一次請求要在空目錄中完成。先確認工作目錄，再發送短文本請求，最后只讀一個無敏感內容的測試文件。三項都通過后，再進入正式項目。
New-Item -ItemType Directory codex-migration-check
Set-Location codex-migration-check
codex驗證失敗時，優先比較模板、當前卡片和新設備環境，不要直接復制舊設備全部文件。
- 確認新設備當前目錄。
- 確認模型可以返回短響應。
- 確認只讀任務不會寫入文件。
? 第九步：遷移真實項目時重新確認路徑
項目目錄也不建議直接整包復制而不檢查。進入新設備后的項目根目錄，先看 Git 狀態、依賴文件和環境變量，再讓 Codex 只讀分析。
Get-Location
git status --short
Get-ChildItem -Force | Select-O*ject Name- 確認項目路徑和分支正確。
- 確認 `.env` 沒有攜帶舊設備秘密。
- 確認依賴和運行時符合項目要求。
- 先讀取項目說明，再開始修改。
遷移失敗時的恢復順序
遷移排錯要區分服務、客戶端、系統環境和項目四層，一次只驗證一個變量。
- 無法獲取模型：檢查地址、令牌、分組和網絡。
- 切換無效：確認渠道啟用并重啟 Codex。
- 模型不存在：以新設備當前列表為準。
- 項目行為不同：比較運行時、目錄和環境變量。
- 令牌疑似暴露：立即撤銷舊令牌。
- 配置損壞：根據脫敏模板重新創建，不覆蓋現有卡片。
? 換機遷移驗收清單
把遷移過程做成模板，下一次更換設備時就能減少臨時操作，也能避免把舊設備的風險一起帶到新環境。
- 舊設備令牌已經按需要撤銷或重新分配。
- 遷移模板沒有完整 API Key。
- 新設備 Codex 和 CC Switch 可以正常啟動。
- 渠道已經按當前服務信息重新創建。
- 模型列表獲取成功。
- 新設備已重啟 Codex 并通過空目錄測試。
- 正式項目路徑、分支和環境變量已復核。
- 舊配置和新配置都有清晰的負責人和狀態。