一、為什么接入教程一定要講備份恢復？

很多 Codex 接入 API 中轉站的教程都停在“復制地址、填入 Key、選擇模型、測試成功”這一步。短期看已經夠用，但真實使用一段時間后，你一定會遇到配置遷移問題：電腦更換、系統重裝、終端環境被清理、CC Switch 配置卡誤刪、團隊成員接手舊項目。

如果沒有備份和恢復規范，每次遷移都會像重新接入一次：到處找官網、找模型名、找 *ase **L、問誰有 Key、猜之前用的是哪張配置卡。更糟的是，有些人會把完整 Key 寫進普通文檔里，表面解決恢復問題，實際增加泄露風險。

比較好的方法是把“可公開的配置規范”和“不可公開的密鑰值”分開保存。靈能API 用來確認真實入口、模型和密鑰狀態，CC Switch 用來恢復本地配置卡，團隊文檔只保存說明和占位模板。這樣既能恢復，也不把敏感信息到處散落。

二、備份對象先分成三層

第一層是***息，比如官網入口、配置卡命名規則、模型用途說明、驗證命令。這些內容可以放在項目文檔或團隊知識庫里，方便新人查看。第二層是半敏感信息，比如某個 Key 的用途、負責人、創建日期、適用項目，這些可以記錄，但不要包含完整密鑰。第三層是真實密鑰，只能放在密碼管理器、本機**環境變量或**重新生成。

這三層分清之后，備份策略會立刻變簡單。***息負責“讓人知道怎么恢復”，半敏感信息負責“讓人知道恢復哪套配置”，真實密鑰負責“讓請求真正跑起來”。不要把三者混在一個 Word 文檔、聊天記錄或截圖里。

• 公開層：官網、*ase **L 來源說明、模型用途、測試步驟。
• 記錄層：Key 名稱、所屬項目、負責人、創建時間、狀態。
• 密鑰層：真實 API Key，只放在受控位置，必要時從靈能API重新生成。

三、恢復前先回到靈能API確認入口

當你要恢復 Codex 接入時，第一步不是打開舊截圖，而是先進入 [靈能API](https://www.lnsns.com/) 確認當前賬號、入口和模型狀態。舊截圖只能說明當時頁面長什么樣，不能保證今天的權限、余額和模型仍然一致。

如果團隊里有多個賬號，務必先確認當前登錄的是哪一個。很多恢復失敗其實不是配置寫錯，而是新電腦登錄了另一個賬號，導致復制到 CC Switch 的 Key、模型和 *ase **L 不屬于同一套體系。

建議把 https://www.lnsns.com/ 作為團隊接入文檔里的唯一入口來源。恢復時從這個入口進去，再根據**實際展示的信息填寫配置，不要從舊聊天記錄里復制陌生地址。

四、備份文檔只寫“恢復說明”，不寫完整 Key

備份文檔可以很詳細，但有一條紅線：不要寫完整 API Key。你可以寫“本項目使用靈能API中轉入口”“配置卡名稱為 codex-**in”“模型名稱以**當前可用列表為準”“Key 由負責人分配或自行生成”，但不要把真實密鑰直接寫進去。

文檔越像說明書越好，越像密鑰倉庫越危險。一個干凈的恢復文檔應該讓人知道去哪里拿信息、每個字段代表什么、恢復后怎么驗收，而不是直接暴露一串能被復制使用的憑證。

恢復文檔建議寫：
官網入口：靈能API
配置工具：CC Switch
配置卡名稱：codex-**in-dev
*ase **L：從**接口說明復制
API Key：從密碼管理器讀取或重新生成
首次驗證：短請求，只讀模式

五、備份 CC Switch 配置卡時要保留字段邏輯

如果 CC Switch 支持導出配置，可以導出不含真實 Key 的模板；如果暫時不能導出，就用截圖和字段說明替代。重點不是保存某個界面的像素，而是保存字段邏輯：哪個字段填入口、哪個字段填密鑰、哪個字段填模型、哪個配置卡適合哪個項目。

配置卡名稱建議保持可讀，例如 lingneng-codex-dev、lingneng-codex-do**、lingneng-codex-ci。恢復到新電腦時，按同樣名稱重建卡片，團隊溝通會更順。否則每個人都叫 default，排障時很難判斷當前到底啟用了哪條線路。

• 截圖可以保留字段位置，但敏感字段要隱藏。
• 配置卡名稱要保留項目、環境和用途。
• 恢復說明里寫字段來源，不寫密鑰本體。

六、真實 Key 丟了怎么辦？不要試圖找舊值

很多**的 API Key 只在創建時完整展示一次，后續只能看到名稱或片段。這是正常的安全設計。換機后如果找不到舊 Key，不要在本地緩存、截圖、聊天記錄里翻完整值，更不要讓同事把以前的密鑰直接發給你。

正確做法是回到 靈能API **，按項目或成員重新生成一枚 Key，并把舊 Key 標記為待停用或直接停用。然后在 CC Switch 中復制舊配置卡，只替換 API Key，其余字段先不動。這樣可以把恢復風險壓到最低。

• 找不到舊 Key：重新生成，不從不安全位置翻找。
• 懷疑舊 Key 泄露：先停用，再創建新 Key。
• 只是換電腦：可以先新建恢復卡，通過后再清理舊設備配置。

? 七、恢復字段時按順序填，不要同時猜多個變量

恢復 CC Switch 配置時，最忌諱一邊換 Key，一邊換模型，一邊改 *ase **L。這樣失敗后你完全不知道是哪一步錯了。建議按固定順序：先填 *ase **L，再填 API Key，再填 Model，最后確認接口類型和超時設置。

如果舊電腦還能打開，可以把舊配置卡作為參考，但不要直接截圖完整密鑰。你只需要對照字段結構和非敏感字段，把新電腦上的卡片重建出來。API Key 使用新生成或安全保存的值即可。

恢復順序：
1. 新建 CC Switch 配置卡
2. 填入來自靈能API的 *ase **L
3. 填入新的或安全保存的 API Key
4. 填入當前項目使用的 Model
5. 保存配置卡并啟用
6. 重啟終端后做短請求驗證

八、恢復后先做空目錄驗證

恢復完成后，不要立刻進入真實項目讓 Codex 修改代碼。先創建一個空目錄或進入***目錄，讓 Codex 做只讀回答。這樣能確認 API 中轉站鏈路是否恢復成功，同時不會對項目文件產生影響。

第一次驗證可以問一個極短問題，比如“請用三句話說明當前會話已啟動，不要創建文件”。如果這一步失敗，說明問題還在接入鏈路上；如果成功，再進入項目倉庫做只讀檢查；最后才允許它參與修改任務。

• 空目錄短請求通過：說明基礎鏈路可用。
• 項目只讀檢查通過：說明倉庫環境基本可用。
• 寫入任務前確認分支、權限和備份，避免恢復階段誤改文件。

九、新電腦恢復建議保留一個過渡配置卡

換電腦恢復時，建議先建一張過渡配置卡，比如 lingneng-codex-restore-20260901。它用于驗證新電腦環境，不直接覆蓋你原來的正式配置名稱。等確認 Codex、終端、編輯器都能正常讀取后，再把它改成正式名稱。

過渡卡的好處是有回看路徑。恢復失敗時，你知道這張卡就是新電腦驗證用的，不會誤以為正式卡壞了。團隊排障時，也能根據名稱判斷當前是在恢復階段還是正式使用階段。

過渡卡名稱：lingneng-codex-restore-20260901
正式卡名稱：lingneng-codex-dev
文檔記錄：恢復時間、設備、負責人、測試結果
不要記錄：完整 API Key

十、誤刪配置卡后的補救路線

如果 CC Switch 配置卡被誤刪，不要慌。先從備份文檔里找到配置卡命名、用途和字段說明，再進入 靈能API **確認入口與模型。如果舊 Key 找不到，就重新生成一枚 Key；如果舊 Key 仍在安全管理器里，可以繼續使用，但建議借這個機會檢查是否需要輪換。

誤刪配置卡的真正損失通常不是卡片本身，而是你不知道它原來填了什么。只要團隊保留了字段說明、模型用途和命名規則，重建成本并不高。反過來，如果所有信息都只存在某臺電腦上，誤刪就會變成一次完整事故。

• 先找恢復說明，不要憑記憶亂填。
• 再確認**入口和模型，不要復制舊地址。
• 最后用短請求驗收，不要直接跑長任務。

十一、團隊備份表建議記錄這些字段

團隊使用時，可以維護一張不含密鑰的備份表。字段包括：配置卡名稱、適用項目、環境、模型用途、Key 名稱、負責人、創建日期、最近驗證日期、狀態、備注。這樣任何人恢復配置時，都能知道應該重建哪一張卡。

這張表只記錄元信息，不記錄真實 Key。它的價值在于幫助你追蹤“哪套配置還在使用”“哪套配置已經廢棄”“誰負責更新文檔”。當靈能API**發生 Key 輪換或模型調整時，同步更新這張表即可。

建議字段：
配置卡名稱 / 項目 / 環境 / 用途 / Key名稱 / 負責人 / 創建日期 / 最近驗證 / 狀態 / 備注
狀態示例：使用中、待驗證、已廢棄、臨時恢復

十二、恢復完成后順手***清理

恢復成功不代表工作結束。建議順手清理舊設備、舊配置、舊截圖和臨時文件。尤其是包含 API Key 的臨時記事本、聊天記錄截圖、桌面備份文件，都應該檢查一遍。恢復流程越順，越容易留下臨時痕跡。

如果舊電腦已經不再使用，確認 CC Switch 配置已刪除，終端環境變量已清理，本地明文文件已移除。必要時進入 靈能API **停用舊 Key，再用新 Key 作為正式配置。

• 清理舊設備里的本地配置和環境變量。
• 刪除含敏感信息的臨時截圖或文檔。
• 確認恢復卡是否需要改名為正式卡。
• 把恢復結果寫回團隊備份表。

十三、推薦的完整恢復演練

如果這套流程要給團隊長期使用，建議每隔一段時間***恢復演練。選一臺干凈電腦或臨時用戶環境，只根據備份文檔和**信息重建 CC Switch 配置，然后運行 Codex 短請求。演練能暴露文檔缺口，比如字段解釋不清、模型名過期、負責人變更、官網入口沒有更新。

演練不需要很重，十五分鐘就夠。關鍵是驗證一件事：當原電腦不在身邊時，團隊還能不能依靠文檔、靈能API**和 CC Switch，把 Codex API 中轉站鏈路恢復出來。能做到這一點，說明你的接入方案已經不再依賴某個人的記憶。

演練目標：不用舊電腦恢復 Codex 接入
演練材料：備份說明、靈能API**、CC Switch
通過標準：短請求成功、配置卡命名正確、文檔無密鑰泄露

? 十四、結語：可恢復，才算真正接入完成

Codex 接入 API 中轉站，不只是第一次跑通命令。真正值得長期使用的接入方案，應該在換機、誤刪、交接、密鑰丟失時都能恢復。靈能API 負責提供可確認的**入口和接口信息，CC Switch 負責保存可切換的本地配置，文檔負責沉淀恢復規則。

把這三塊串起來之后，接入就不再是一段憑運氣保存的個人配置，而是一套能遷移、能交接、能補救的工作流程。等下一次換電腦或重裝環境時，你會感謝現在多寫下來的這幾行說明。