Codex 中轉站安全配置教程：靈能API CC Switch 密鑰管理、權限與故障恢復
Codex 接入中轉站后，真正需要長期維護的不只是 API 地址，還包括密鑰生命周期、配置卡權限、主備線路和故障恢復。本文以靈能API和 CC Switch 為例，說明如何從創建專用令牌開始，建立不暴露密鑰、可回退、**證的 Codex 使用流程。
? 為什么接入成功后還要做安全配置
API Key 一旦進入客戶端，就可能被保存在配置文件、環境變量、日志或截圖中。很多問題并不是接口本身不安全，而是密鑰被復制到過多位置，或者主線路和測試線路共用同一枚 Key。安全配置的目標，是讓每條線路只擁有必要信息，并且出現異常時可以單獨停用。
- 密鑰可追蹤：知道哪臺電腦、哪個用途在調用。
- 權限可控制：不把所有應用放在同一枚 Key 下。
- 配置可回退：主線路異常時不必臨時修改主卡片。
- 問題可定位：錯誤碼與卡片名稱能夠對應起來。
? 先劃分四個安全邊界
可以把一次 Codex 中轉接入分成賬戶、令牌、客戶端和項目四個邊界。賬戶負責額度和模型權限；令牌負責身份認證；CC Switch 負責配置切換；項目則決定 Codex 能看到哪些文件、執行哪些任務。任何一層過度開放，風險都會被放大。
賬戶：額度、模型范圍、調用狀態
令牌：單獨用途、可撤銷、不可公開
CC Switch：配置卡、當前啟用狀態
項目：目錄權限、文件范圍、命令確認因此，不要把 API Key 當成唯一安全措施。即使密鑰沒有泄露，也要限制 Codex 第一次進入項目時的讀取范圍和修改范圍。
第一步：在靈能API控制臺創建專用令牌
進入靈能API公開頁面或控制臺后，先確認當前模型和令牌管理入口。為 Codex 創建專用令牌，名稱中寫清設備或用途，例如 Codex-Windows-主線路。不要讓多個項目共用一枚無法區分來源的 Key。
創建時只選擇 Codex 需要的分組或模型范圍。若頁面提供更多權限選項，不要為了省事全部打開。令牌生成后立即保存到密碼管理器，文章、截圖和聊天記錄只展示字段位置，不展示真實密鑰。
如果懷疑令牌曾經出現在公開位置，直接撤銷舊令牌并創建新的，不要試圖通過修改名稱來‘修復’已經暴露的密鑰。
- 官網入口：https://www.lnsns.com/
- 令牌名稱：設備 客戶端 用途。
- 令牌范圍：只選擇實際需要的分組或模型。
第二步：本地工具和配置文件先做最小檢查
安全配置也需要從本地工具開始。新開 PowerShell，先確認 Node.js、npm 和 Codex 能夠運行，再打開 CC Switch。這樣可以避免把安裝問題、舊環境變量和密鑰問題混在一起。
node -v
npm -v
where.exe node
where.exe npm
codex --version檢查項目目錄時，不要把包含 API Key 的環境文件直接提交到版本控制。Windows 用戶尤其要注意項目根目錄的 .env、PowerShell 歷史記錄和臨時腳本。需要共享配置時，只分享不含密鑰的模板。
# 示例模板，不填**實密鑰
CODEX_*ASE_**L=https://www.lnsns.com/v1
CODEX_MODEL=<當前模型ID>
CODEX_API_KEY=<本地私密值>? 第三步：在 CC Switch 里建立主卡片和恢復卡片
不要只創建一張‘默認配置’。建議至少保留主卡片和恢復卡片。主卡片用于日常工作，恢復卡片可以是已知可用的舊配置，或者參數已經驗證過的備用線路。恢復卡片不需要每天使用，但要定期***輕量測試。
復制卡片后，要重新檢查 API Key 和 Model ID。不要把復制操作當成安全隔離，復制出來的卡片可能仍然引用原來的密鑰和模型。
?? **步：填寫字段時避免三種泄露和三種路徑錯誤
配置字段時，先填寫服務名稱、協議和地址，再填寫模型，最后粘貼 Key。截圖或錄屏前隱藏 API Key；分享錯誤日志時刪除請求頭；提交代碼前檢查是否把密鑰寫進配置文件。
服務名稱：靈能API-Codex-主線路
*ase **L：https://www.lnsns.com/v1
Model ID：從當前列表復制
API Key：只在本地私密字段中保存路徑錯誤主要有三類：把官網地址當成 *ase **L，把完整接口路徑填進基礎地址，或者重復添加 /v1。出現 404 時先檢查地址；出現 model not found 時先檢查 Model ID；出現 401 時再檢查 Key。
如果 CC Switch 有顯示或隱藏 Key 的開關，日常使用保持隱藏。需要更換密鑰時，創建新令牌并驗證成功后，再撤銷舊令牌。
第五步：啟用后用只讀任務驗證權限邊界
保存并啟用配置后，關閉舊的 Codex 和 PowerShell，重新啟動。先在空目錄驗證接口返回，再進入真實項目。第一條任務只允許讀取目錄狀態，不允許創建、刪除或修改文件。
mkdir codex-security-check
cd codex-security-check
codex建議發送：請確認當前目錄是否為空，并說明你會如何檢查一個項目，不要訪問目錄外文件，不要創建、刪除或修改文件。這個任務可以同時驗證線路、當前目錄和基本權限邊界。
進入真實項目后，先讓 Codex 只讀取一個指定文件。確認返回內容正確，再提出修改方案。任何寫入操作都應先檢查版本控制狀態，并保留可回退方式。
第六步：發現異常時先隔離，不要繼續擴大影響
如果發現異常用量、未知模型調用或密鑰疑似暴露，第一步不是繼續測試，而是隔離問題。暫停使用可疑卡片，撤銷對應令牌，再檢查其他應用是否共用了同一枚 Key。確認賬戶狀態后，創建新令牌并只在測試卡片中驗證。
不要把完整密鑰發送給任何人協助排錯。需要他人幫助時，只提供錯誤碼、脫敏后的地址、模型 ID 和不含密鑰的配置結構。
- 疑似泄露：立即撤銷舊令牌。
- 調用異常：核對令牌名稱、卡片名稱和使用設備。
- 額度變化異常：檢查是否有共享配置或**任務。
- 模型異常：核對分組、模型范圍和當前 Model ID。
常見錯誤與恢復順序
推薦恢復順序是：切回已知可用卡片、關閉舊進程、用空目錄測試、比較新舊字段、最后才考慮升級或重新安裝軟件。
- 401：確認當前卡片啟用狀態、Key 是否有效、Key 是否屬于當前服務。
- model not found：從當前列表復制精確 Model ID。
- 切換后仍使用舊配置：關閉舊終端和 Codex，重新啟動新進程。
- 請求超時：先縮短上下文，再檢查網絡、**和任務長度。
安全維護清單：每周檢查一次即可
需要查看當前模型、令牌、額度和服務信息時，可以通過可點擊的靈能API官網入口進入：https://www.lnsns.com/。實際頁面信息優先于舊截圖和舊筆記。
- 主線路和備用線路名稱是否仍然清晰。
- 是否有不再使用的舊令牌需要撤銷。
- API Key 是否出現在項目文件、截圖或日志中。
- 當前模型是否仍在服務列表中。
- 恢復卡片是否完成過最近一次輕量測試。
- 升級 Codex 或 CC Switch 后是否重新驗證。
? 最后確認：一套配置是否真的可長期使用
當配置具備最小權限、清晰命名、可回退和**證四個條件時，Codex 中轉接入才算真正完成。
- 每個用途有獨立令牌，且令牌名稱可以追蹤來源。
- CC Switch 中有明確的主卡片和恢復卡片。
- *ase **L、Model ID 和分組來自當前服務信息。
- 啟用配置后，舊 Codex 進程已經關閉并重新啟動。
- 空目錄只讀任務通過，真實項目從局部讀取開始。
- 發生密鑰問題時，可以撤銷、重建并快速恢復。
