先弄清楚‘當前到底哪份配置在生效’

同一臺電腦里可能同時存在 CC Switch 渠道、Codex 配置文件、系統環境變量、項目 `.env` 和舊的運行進程。它們的內容不一致時，界面顯示的值不一定等于請求實際使用的值。排查之前先列出所有可能來源。

先確認來源，再修改值。否則可能出現‘改了配置卻沒有任何變化’的假象。

• CC Switch：當前選中的渠道和字段。
• 客戶端配置：Codex 啟動時讀取的配置文件。
• 環境變量：進程啟動時注入的地址、模型或 Key。
• 項目變量：項目運行時加載的 `.env` 和腳本參數。

第一步：建立靈能API的基準配置

打開靈能API服務入口，確認一組已知可用的 *ase **L、Model ID 和測試令牌。把這組信息作為基準，不要在排查過程中頻繁改變。

靈能API入口：https://www.lnsns.com/。基準記錄只保存用途和脫敏信息，不保存完整 Key。

• 基準地址：來自當前接口說明。
• 基準模型：來自當前模型列表。
• 基準令牌：只用于受控測試。

第二步：令牌安全先于配置速度

令牌一旦進入日志、截圖、剪貼板記錄或 Git 提交，就不能繼續把它當作安全密鑰。建議按照測試、個人開發、自動化任務分別創建令牌，并為每枚令牌寫清用途和負責人。

排錯時只記錄 Key 的名稱、長度或末尾少量脫敏字符，不記錄完整內容。

• 不把 Key 寫進文章、教程和圖片。
• 不把完整 Key 寫進 `.env.example`。
• 不把 Key 直接放進公開配置文件。
• 懷疑泄露時先撤銷，再生成新值。

? 第三步：CC Switch 卡片要有明確用途

配置卡名稱不要使用‘默認’‘新建’或‘測試2’。推薦使用‘項目-環境-用途’的命名方式，例如‘do**-local-readonly’。清晰的名稱是回滾和排錯的第一條線索。

復制卡片進行試驗，不要直接覆蓋唯一的可用卡。

• 穩定基準卡：只在確認新配置后更新。
• 測試卡：用于試驗新模型或新地址。
• 臨時卡：完成驗證后及時停用。

**步：建立一份脫敏配置模板

備份的目標是恢復配置結構，而不是復制完整密鑰。模板中保留字段名、用途、模型和地址占位符，真正恢復時再從安全位置填入令牌。

name: do**-local-readonly
*ase_url: <當前接口地址>
model: <當前 Model ID>
api_key: <恢復時重新填寫>
owner: <負責人>
status: active

模板寫清楚字段來源，下一次更換電腦或成員接手時，不必依賴聊天記錄找配置。

• 模板可以進入**文檔或受控倉庫。
• 模板不能包含完整 API Key。
• 恢復后先用空目錄完成測試。

第五步：修改前先備份配置文件

需要手動修改 Codex 配置時，先復制原文件并記錄當前工作狀態。備份文件名稱包含日期和用途，避免多個 *ackup 文件互相混淆。

$config = Join-Path $home '.codex\config.toml'
$*ackup = "$config.*ackup-2026-08-07"
Copy-Item -LiteralPath $config -Destination $*ackup -Force

如果你主要通過 CC Switch 管理渠道，也應該保留一張已驗證的穩定卡作為邏輯備份。

• 先確認源文件路徑確實屬于當前 Codex。
• 備份前不要刪除原文件。
• 修改后只改變一個變量。

第六步：處理環境變量覆蓋問題

當 CC Switch 界面顯示一個模型，而 Codex 實際使用另一個模型時，優先檢查環境變量和舊進程。項目腳本、PowerShell 會話和系統變量都可能覆蓋客戶端讀取的值。

Get-ChildItem Env: | Where-O*ject { $_.Name -**tch 'OPENAI|CODEX|MODEL|API' }
Get-Location
Get-Process | Where-O*ject { $_.ProcessName -**tch 'codex' }

檢查變量時不要輸出完整值，必要時只驗證變量是否存在和長度是否合理。

• 確認當前 PowerShell 是否殘留舊變量。
• 確認項目 `.env` 沒有覆蓋客戶端線路。
• 確認舊 Codex 進程已經退出。

第七步：用‘復制、驗證、替換’完成切換

更換模型、地址或令牌時，不要直接覆蓋穩定卡。復制一張新卡，只修改一個字段，使用空目錄完成最小請求，確認通過后再把新卡設為主卡。

舊卡：do**-local-readonly
新卡：do**-local-readonly-next
變更：只更新 Model ID
驗證：空目錄短請求
結果：通過后再啟用新卡

任何新配置都要有明確的測試結果，不能只憑‘字段看起來正確’就替換穩定卡。

第八步：建立可重復的回滾測試

回滾不是出錯后臨時摸索，而是提前確認過的流程。可以在空目錄中模擬一次新卡失敗：切回舊卡、重啟 Codex、發送短請求，確認舊線路確實能夠恢復。

New-Item -ItemType Directory codex-roll*ack-check
Set-Location codex-roll*ack-check
codex

回滾測試通過后，再進行大范圍項目任務；不要把首次恢復演練放到正式項目里。

• 記錄穩定卡名稱。
• 記錄重啟步驟。
• 記錄最小測試提示。

常見安全和配置陷阱

安全配置的核心不是增加復雜步驟，而是讓每次修改都可識別、**證、可撤銷。

• 把完整 Key 寫在 TOML、腳本或截圖中。
• 直接覆蓋唯一穩定配置，沒有備份。
• 切換卡片后不重啟，誤以為新配置已生效。
• 同時修改地址、模型、協議和 Key，無法定位原因。
• 將臨時測試令牌長期保留在多個設備。
• 把項目 `.env` 提交到倉庫。
• 只看界面狀態，不驗證實際請求。

? 配置管理驗收清單

把靈能API配置從一次性填寫升級為可回滾的管理流程，Codex 在多項目、多模型環境下會更容易維護。

• 已經確認靈能API的當前地址和模型。
• 每枚令牌都有用途和負責人。
• CC Switch 卡片名稱清晰，穩定卡和測試卡分開。
• 配置模板不包含完整 Key。
• 手動修改前保留了備份。
• 環境變量和舊進程已經檢查。
• 新配置經過空目錄測試。
• 穩定卡回滾流程已經驗證。