Codex 中轉站接入教程：靈能API CC Switch 安全配置、權限邊界與敏感目錄隔離
Codex 中轉站接入成功之后，很多人會馬上把它放進真實項目里使用，但忽略了安全邊界：哪些目錄可以讀取、哪些命令可以執行、API Key 怎么保存、截圖和日志能不能外發。本文以靈能API和 CC Switch 為例，整理一套更穩妥的安全接入流程，讓 Codex 能用、好用，同時不把密鑰和生產配置暴露出去。
先明確：安全接入不是慢一步，而是少踩坑
很多新手第一次接入 Codex 中轉站時，只關注能不能返回答案；真正進入項目后，風險才會出現：Codex 讀取了 .env，日志里出現完整 Key，截圖里帶著敏感字段，或者一次任務誤改了生產配置。
安全接入的目標不是限制工具能力，而是把風險邊界提前寫清楚。只要邊界明確，Codex 仍然可以分析代碼、補測試、寫文檔、解釋報錯，同時避免碰到不該碰的目錄和憑證。
- 明確哪些目錄可以讀取，哪些目錄禁止讀取。
- 明確哪些命令可以執行，哪些命令必須人工確認。
- 明確 API Key、Cookie、Token 不進入文章、截圖和日志。
- 明確首次接入必須先空目錄驗證，再進入真實項目。
第一步：從靈能API確認服務和賬號狀態
安全接入同樣從服務入口開始。先進入靈能API，確認賬戶能正常訪問、模型可用、額度正常，并準備一枚專門給 Codex 使用的 Key。入口：https://www.lnsns.com/
如果這枚 Key 用于真實項目，名稱要寫清用途，例如 Codex-Secure-Dev 或 Codex-ProjectA。后續輪換、停用和排查都會更清楚。
- 賬戶可以正常登錄，避免本地排查時誤判。
- 模型 ID 從當前列表復制，不憑舊筆記填寫。
- 額度足夠完成接入驗證和小任務測試。
- API Key 建議單獨創建，不混用其他工具。
第二步：API Key 只放在該放的位置
API Key 是中轉 API 的訪問憑證，不能出現在公開文章、截圖、倉庫、日志或聊天記錄里。接入時可以記錄 Key 的用途、創建日期、負責人，但不要記錄完整值。
推薦記錄：
Key 用途：Codex-Secure-Dev
創建日期：2026-08-29
使用位置：CC Switch 配置卡
負責人：項目維護人
禁止記錄：完整 API Key 明文靈能API負責提供憑證入口，CC Switch負責本地保存和切換。你的安全規則要負責確保憑證不被復制到錯誤位置。
- 截圖前檢查輸入框是否顯示 Key。
- 日志里不要輸出 Authorization Header。
- 排錯時只寫 Key 名稱或脫敏摘要。
- 發現泄露后直接撤銷并重新創建。
第三步：在 CC Switch 創建安全接入卡
打開 CC Switch，新建一張用于安全接入的配置卡。卡片名稱建議寫清服務、工具和用途，例如“靈能API-Codex-Secure”。不要把安全驗證卡、日常開**和臨時排錯卡混在一起。
第一張安全接入卡的目標不是性能最強，而是字段清楚、用途清楚、驗證清楚。跑通之后再擴展項目卡和備用模型卡。
- 卡片名稱：靈能API-Codex-Secure。
- 用途備注：安全接入驗證、真實項目只讀測試。
- 模型選擇：先選穩定模型，減少排錯變量。
- 高級參數：首次接入先保持簡單。
**步：填寫字段時同步做安全檢查
填寫 *ase **L、Model ID 和 API Key 時，不只要看是否正確，還要看是否安全。比如 Key 是否顯示在截圖里，*ase **L 是否來自當前入口，模型 ID 是否來自自己的賬戶。
服務名稱：靈能API-Codex-Secure
*ase **L：https://www.lnsns.com/v1
Model ID：從當前模型列表復制
API Key：粘貼 Codex 專用 Key，不公開展示字段填完后保存并啟用配置卡，隨后關閉舊終端，打開新終端進行驗證。
- *ase **L 不要重復 /v1，也不要寫完整接口路徑。
- Model ID 不要使用頁面描述詞或舊截圖內容。
- API Key 粘貼后檢查首尾空格，再隱藏或避免截圖。
?? 第五步：啟用后先做空目錄驗證
安全接入的首次驗證一定要放在空目錄里。空目錄沒有 .env、沒有生產配置、沒有客戶數據，適合用來確認靈能API線路、CC Switch 配置和 Codex 終端狀態是否連通。
New-Item -ItemType Directory codex-secure-check
Set-Location codex-secure-check
codex請只返回：安全接入驗證通過如果空目錄都無法返回固定文本，先不要進入真實項目。按 401、403、404、429、timeout 的錯誤類型逐項排查。
第六步：真實項目先寫目錄白名單
進入真實項目后，第一條提示詞就要寫明目錄白名單和黑名單。不要讓 Codex 自己決定全項目讀取范圍，尤其不要默認允許讀取密鑰、生產配置、數據庫備份或客戶原始數據。
允許讀取：README.md、src、tests、do**
禁止讀取：.env、secrets、config/prod、**ta*ase/*ackups、客戶原始數據、私鑰文件
允許修改：本次任務指定文件
禁止修改：支付、權限、部署腳本，除非單獨確認目錄白名單能減少上下文消耗，也能降低誤讀敏感信息的風險。長期使用時，建議把這段規則做成項目提示詞模板。
- 只讀分析也要寫允許讀取范圍。
- 修改任務必須寫允許編輯的文件。
- 敏感目錄默認禁止讀取。
第七步：命令執行按風險分級
Codex 可能會建議執行測試、安裝依賴、構建項目、刪除文件或訪問外部服務。不同命令風險不同，安全接入時要提前寫清哪些可以執行，哪些必須人工確認。
可以讓 Codex 先列出將要執行的命令和原因，再由你決定是否繼續。這樣不會犧牲效率，也能保留關鍵控制點。
- 低風險：查看文件、列目錄、運行只讀檢查。
- 中風險：本地測試、構建、格式化、生成臨時文件。
- 高風險：刪除文件、寫數據庫、上傳內容、修改生產配置。
- 外部訪問：涉及網絡、登錄、憑證時必須確認。
第八步：用只讀任務完成真實項目首測
真實項目第一次驗證，不建議直接修改代碼。先讓 Codex 只讀分析項目結構，并確認它遵守了目錄白名單。通過后再放開單文件修改或測試補充。
請只讀分析當前項目，不要修改文件。
允許讀取：README.md、src/auth、tests/auth
禁止讀取：.env、secrets、生產配置、數據庫備份
輸出：項目結構、關鍵文件、下一步建議、未讀取的敏感目錄說明如果 Codex 輸出中主動說明沒有讀取禁止目錄，說明邊界提示生效；如果它計劃訪問敏感目錄，先修正提示詞，不要繼續執行。
第九步：日志、截圖和交付說明都要脫敏
接入完成后，日常排錯和交付說明也要保持脫敏。可以記錄靈能API配置卡名稱、*ase **L、模型、錯誤碼和驗證結果，但不要記錄完整 API Key、Cookie、Authorization Header 或客戶隱私數據。
可記錄：
配置卡：靈能API-Codex-Secure
*ase **L：https://www.lnsns.com/v1
錯誤碼：401
驗證結果：空目錄失敗，重新粘貼 Key 后恢復
不可記錄：完整 API Key、Cookie、私鑰、生產數據庫地址安全接入不是只在配置當天***，而是每次截圖、排錯、交付時都要順手檢查。
- 截圖前檢查輸入框、地址欄、控制臺輸出。
- 日志共享前搜索 Key、Token、Cookie 等***。
- 交付說明只寫結果和驗證方式，不寫憑證明文。
? 最后一份安全接入清單
按安全接入流程配置后，Codex 中轉站不僅能跑通，也更適合真實項目長期使用。靈能API提供中轉 API 和模型入口，CC Switch負責本地線路切換，而目錄邊界、命令分級和脫敏習慣負責把風險關在可控范圍內。