Codex 中轉站接入教程：靈能API CC Switch 在 WSL 子系統中完成終端驗證
很多 Windows 用戶會同時使用 PowerShell、VS Code 終端和 WSL 子系統。Codex 中轉站在其中一個終端能用，不代表換到另一個終端也一定正常，因為路徑、環境變量、**、配置讀取和項目根目錄都可能不同。本文以靈能API和 CC Switch 為例，整理一套 WSL 場景下的接入教程：先在 Windows 側確認服務和配置，再在 WSL 里完成終端驗證，最后進入項目做只讀首測。
先理解：WSL 不是普通 PowerShell 的復制品
在 Windows 上接入 Codex 中轉站時，PowerShell 跑通只是第一步。WSL 有自己的 Linux 文件路徑、終端環境、網絡行為和命令查找方式。你在 Windows 側看到 CC Switch 已啟用，不代表 WSL 里的 Codex 會自動按同樣方式讀取。
因此，WSL 接入要多做一層驗證：先確認靈能API服務信息和 CC Switch 卡片，再確認 WSL 終端里 Codex 命令可用，最后用空目錄短提示詞測試。不要直接進入真實項目，否則問題會混在路徑、網絡和接口字段里。
- Windows 側：確認靈能API賬戶、Key、模型和 CC Switch 配置。
- WSL 側：確認 codex 命令、當前目錄和網絡狀態。
- 驗證側：先空目錄，再測試項目，最后真實項目。
- 排錯側：一次只改一個變量，避免越排越亂。
第一步：先在 Windows 側確認靈能API入口
無論最終在哪個終端里啟動 Codex，服務信息都要先確認。打開靈能API入口，核對賬戶、模型、額度和 API Key 狀態。入口：https://www.lnsns.com/
如果你之前只在 PowerShell 中用過靈能API線路，進入 WSL 前仍然建議重新確認一次服務信息。跨終端使用時，最怕舊筆記和舊環境混在一起。
- 賬戶可以正常登錄。
- 模型列表包含準備給 Codex 使用的 Model ID。
- 額度足夠完成空目錄和項目驗證。
- API Key 是給 Codex 單獨準備的憑證。
第二步：Key 管理不要跨終端亂放
WSL 中經常會出現兩個存放位置：Windows 文件系統和 Linux 子系統文件系統。API Key 不應該隨手寫進項目目錄、shell 歷史、README 或截圖里。接入時只把 Key 填入 CC Switch 或受控配置位置。
推薦記錄：
Key 用途：Codex-WSL-Dev
創建日期：2026-08-29
使用位置：CC Switch 配置卡
禁止位置：README、.env、shell 歷史、截圖、日志靈能API提供憑證入口，CC Switch負責本地線路切換。WSL 場景里更要注意憑證不要同時散落在 Windows 和 Linux 兩套文件系統里。
- 不要把完整 API Key 寫進 .*ashrc 或公開項目文件。
- 排錯時只記錄 Key 用途名稱，不記錄明文。
- 截圖前檢查終端、配置面板和日志輸出。
第三步：在 CC Switch 新建 WSL 驗證卡
打開 CC Switch，新建一張專門用于 WSL 驗證的配置卡，例如“靈能API-Codex-WSL”。它的作用是先跑通跨終端鏈路，不要一開始就承擔復雜項目任務。
等這張 WSL 驗證卡跑通后，再考慮為具體項目創建主線路卡、備用模型卡或排錯卡。第一步先把鏈路跑穩。
- 卡片名稱：靈能API-Codex-WSL。
- 用途備注：WSL 終端驗證和項目首測。
- 模型選擇：優先穩定、響應快、成本可控。
- 高級參數：首次驗證先保持簡單。
**步：填寫 *ase **L、模型和 Key
WSL 場景下，字段填寫仍然遵循同一原則：*ase **L、Model ID 和 API Key 必須來自同一套靈能API賬戶信息。不要把 Windows 舊配置里的模型名直接復制過來，也不要把舊 Key 混進新卡。
服務名稱：靈能API-Codex-WSL
*ase **L：https://www.lnsns.com/v1
Model ID：從靈能API當前模型列表復制
API Key：Codex WSL 專用 Key字段保存后，確認當前啟用的是這張 WSL 驗證卡。下一步再進入 WSL 終端檢查本地命令。
- *ase **L 不要重復 /v1。
- 不要把完整接口路徑填到基礎地址里。
- Model ID 不要使用頁面展示名或舊截圖內容。
- API Key 粘貼后檢查首尾空格。
?? 第五步：進入 WSL 后先檢查 Codex 命令
打開 WSL 終端后，先不要進入真實項目。先檢查 Codex 命令是否可用。PowerShell 中能運行 codex，不代表 WSL 中也一定能運行，因為兩邊的安裝路徑和環境變量可能完全不同。
codex --version這一步只驗證本地命令，不驗證真實項目。把本地命令問題和中轉 API 問題分開，后面會省很多時間。
- 能返回版本：WSL 中 Codex 命令可用。
- 提示找不到命令：先處理 WSL 內部安裝和 PATH。
- 命令卡住：先關閉舊會話，重新打開 WSL 終端。
第六步：WSL 空目錄做最小連接測試
WSL 首次驗證建議放在 Linux 子系統內部的空目錄里，不要直接進入 Windows 掛載盤里的復雜項目。先用固定短提示詞確認靈能API線路、CC Switch 配置和 WSL 終端狀態是否連通。
mkdir -p ~/codex-wsl-check
cd ~/codex-wsl-check
codex請只返回：WSL Codex 中轉站接入成功如果能返回固定文本，說明基礎鏈路可用。失敗時先看錯誤碼：401 查 Key，404 查 *ase **L 和模型，timeout 查網絡、**和終端狀態。
第七步：項目路徑選擇要謹慎
WSL 可以訪問 Linux 文件系統，也可以訪問 Windows 掛載路徑。真實開發時，建議明確項目到底放在哪里，并在項目根目錄啟動 Codex。路徑選錯會導致讀取范圍偏移、權限異常或性能變慢。
pwd
ls
codex確認項目根目錄后，再讓 Codex 做只讀分析。目錄越清楚，任務邊界越容易控制。
- Linux 內部項目：路徑通常在 ~/projects/xxx。
- Windows 掛載項目：路徑可能在 /mnt/d/Projects/xxx。
- 不要在父級目錄啟動，避免 Codex 看到多個項目。
- 不要在密鑰或備份目錄里啟動 Codex。
第八步：真實項目第一輪只讀驗證
空目錄通過后，可以進入真實項目，但第一輪仍然建議只讀。讓 Codex 讀取有限目錄，輸出項目結構、關鍵文件和下一步建議，同時明確禁止讀取敏感目錄。
請只讀分析當前項目，不要修改文件。
允許讀取：README.md、src、tests
禁止讀取：.env、secrets、生產配置、數據庫備份
輸出：項目結構、關鍵文件、下一步可執行的小任務如果只讀驗證能穩定返回，而且沒有越界讀取，再進入小范圍修改。新環境第一次不要直接做大重構。
第九步：WSL 網絡和**要單獨排查
瀏覽器能打開靈能API頁面，不代表 WSL 終端里的請求一定正常。WSL 的網絡和**可能與 Windows 瀏覽器不同，出現 timeout 或偶發失敗時，要單獨檢查 WSL 環境。
不要在排錯記錄里寫敏感**信息。只需要記錄哪個終端通過、哪個終端失敗、錯誤碼和測試時間即可。
- 瀏覽器正常，WSL timeout：優先檢查 WSL 網絡和**。
- PowerShell 正常，WSL 異常：檢查兩邊環境變量差異。
- 空目錄正常，項目超時：縮小項目讀取范圍。
- 偶發失敗：連續做三次短提示詞，記錄時間和結果。
WSL 接**見問題速查
WSL 的排錯原則依然是分層：先命令，再網絡，再字段，再項目范圍。不要一上來就重建全部配置。
- WSL 找不到 codex：檢查 WSL 內部安裝和 PATH。
- PowerShell 能用但 WSL 不能用：檢查兩邊終端環境和網絡。
- 401：檢查 API Key 是否屬于當前靈能API賬戶，是否復制完整。
- 404：檢查 *ase **L 是否重復 /v1，模型 ID 是否來自當前列表。
- timeout：先用空目錄短提示詞復測，再查**和項目體量。
- 讀取錯項目：檢查 pwd 是否在項目根目錄。
? 最后一份 WSL 接入清單
按這套流程做，WSL 中的 Codex 中轉站接入會更清楚。靈能API負責中轉 API 和模型入口，CC Switch負責線路切換，而 WSL 終端、項目路徑和網絡驗證負責讓配置真正落到正確環境里。