Codex 中轉站配置模板教程：靈能API CC Switch 環境變量、項目接入與脫敏復用
當多個項目、多個設備都需要使用 Codex 時，直接復制完整配置很容易把 API Key、舊路徑和錯誤模型一起帶過去。本文以靈能API與 CC Switch 為例，講清如何**不含密鑰的配置模板、如何在本地設置敏感變量、如何讓項目復用配置而不把秘密提交到倉庫，并通過截圖完成一次完整驗證。
先分開‘模板’和‘真實配置’
配置模板應該包含字段名稱、用途說明和占位符，真實配置才包含 API Key 和本機環境。模板可以共享，真實密鑰不能共享。把兩者混在一起，是項目接入過程中最常見的泄露來源。
- 模板：*ase **L、Model ID、字段說明和占位符。
- 本地秘密：API Key、賬號信息和**環境變量。
- 項目規則：哪些目錄可以讀取，哪些文件不能觸碰。
- 驗證記錄：卡片名稱、模型和最近測試日期。
第一步：從靈能API獲取當前參數
進入靈能API公開頁面或控制臺，確認當前接口地址、模型列表和 Model ID。模板中的服務參數也可能隨著版本變化而更新，因此不要把很久以前的模型名稱當成永久值。
官網入口：https://www.lnsns.com/。模型、價格、額度和服務說明以當天頁面為準。
- *ase **L：記錄當前版本路徑。
- Model ID：從當天列表復制。
- API Key：不要寫入模板，單獨在本機創建。
第二步：創建不含密鑰的項目模板
# codex.env.example
CODEX_*ASE_**L=https://www.lnsns.com/v1
CODEX_MODEL=<從當前模型列表復制>
CODEX_API_KEY=<僅在本機設置>模板文件可以提交到項目或分享給團隊，但真實 .env 文件應加入忽略列表。除了 API Key，賬號郵箱、**地址、項目內部路徑和調用日志也不應該進入公開模板。
- 模板文件：允許共享，不包含真實值。
- 本地文件：包含真實值，只保存在本機。
- 倉庫檢查：提交前確認沒有誤加入 .env。
? 第三步：在 CC Switch 建立可復用渠道
打開 CC Switch 的 Codex 配置區域，創建一張“靈能API-Codex-項目模板”卡片。卡片名稱和備注可以共享，但 API Key 必須由每臺設備在本地填寫。
如果團隊成員使用不同模型或權限，可以復制同一模板并分別設置自己的令牌和 Model ID。不要讓所有人共用同一枚 Key。
?? **步：配置本地秘密并檢查路徑
服務名稱：靈能API-Codex-項目模板
*ase **L：https://www.lnsns.com/v1
Model ID：當前項目選定模型
API Key：本機私密值，不提交到倉庫*ase **L 通常填寫到 /v1，不要使用官網首頁，也不要重復寫成 /v1/v1。配置卡名稱、模板文件和真實環境變量三者要保持用途一致，避免項目 A 的 Key 被項目 * 讀取。
第五步：在項目接入前驗證變量是否生效
配置完成后，關閉舊的 Codex 和 PowerShell，重新打開新終端。先在空目錄啟動 Codex，發送只讀任務，確認當前進程讀取的是新配置。不要在真實項目里直接驗證未確認的模板。
mkdir codex-template-check
cd codex-template-check
codex測試任務可以是：請確認當前目錄是否為空，并說明你會如何檢查一個項目，不要創建、刪除或修改文件。確認返回正常后，再進入項目目錄。
第六步：項目中只共享變量名，不共享變量值
團隊協作時，項目文檔可以說明需要哪些變量、變量格式和獲取方式，但不要直接**實值。新成員在自己的控制臺創建令牌，在本機配置環境，然后運行測試。
如果一個變量需要多人共享，應使用專門的密鑰管理方式，而不是復制粘貼到群聊和網盤。
- 文檔說明：變量名稱、用途和格式。
- 本機配置：真實 API Key 和**路徑。
- 共享截圖：脫敏后的字段和操作位置。
- 項目驗證：用空目錄和只讀任務開始。
第七步：模板更新時只改公共部分
當服務地址、Model ID 或協議發生變化時，先更新不含密鑰的模板，再通知各設備重新核對本地卡片。不要直接覆蓋所有設備的真實配置，因為不同項目可能使用不同模型和權限。
模板更新后出現 404，優先檢查地址；出現 model not found，檢查 Model ID；出現 401，檢查本機 Key 是否仍然有效。
- 公共變化：地址、字段說明、默認模型建議。
- 本地變化：Key、**、項目路徑和權限。
- 更新后：每臺設備完成一次空目錄測試。
配置復用常見問題
排錯時只記錄卡片名稱、錯誤碼、Model ID 和時間，不記錄完整 API Key。
- 401：本機 Key 為空、失效或啟用卡片不對。
- 403：賬戶額度、分組或模型權限不同。
- 404：模板中的 *ase **L 版本路徑不正確。
- model not found：模板里的模型 ID 已變化。
- 項目仍讀舊配置：關閉舊進程并重新啟動。
- 密鑰誤提交：立即撤銷舊 Key，清理倉庫和歷史記錄。
配置模板安全清單
需要查看當前模型、令牌和服務信息時，通過可點擊的靈能API官網入口進入：https://www.lnsns.com/。
- 模板文件不包含真實 API Key。
- 真實 .env 文件已加入忽略列表。
- 每臺設備使用自己的令牌。
- 項目文檔只描述變量名和獲取方式。
- 模板更新后每臺設備重新測試。
最終驗收：模板可以復用，但秘密不能復制
把公共配置和個人秘密分開管理，既能提高協作效率，也能降低項目接入后的維護成本。
- 模板包含當前 *ase **L 和 Model ID 占位說明。
- 真實 Key 只存在于本機私密環境。
- CC Switch 卡片名稱與項目用途一致。
- 復用模板后完成空目錄測試。
- 項目首次使用從局部讀取開始。
- 密鑰泄露時可以單獨撤銷和重建。