Codex 中轉站接入教程：靈能API CC Switch 在 VS Code 終端完成項目首次運行
很多用戶已經把 Codex 中轉站配置好了，但一進入真實項目就開始迷糊：到底應該在哪個目錄啟動、VS Code 終端和普通 PowerShell 是否一樣、切換 CC Switch 后為什么還像舊線路、第一次讓 Codex 讀項目要怎么限制范圍。本文以靈能API和 CC Switch 為例，把 VS Code 終端里的 Codex 接入流程拆開講清楚，從配置確認到項目首測都能照著做。
先理解：編輯器終端也是一個獨立會話
很多人以為 CC Switch 里切換了配置，所有終端都會立刻同步。實際使用時，VS Code 內置終端、系統 PowerShell、舊 Codex 會話可能各自保留不同狀態。配置剛切換后，如果仍然在舊終端里測試，就可能誤判新線路沒有生效。
所以在 VS Code 里接入 Codex 中轉站，要把“配置卡是否啟用”和“當前終端是否新開”分開檢查。先確認靈能API線路和 CC Switch 卡片，再關閉舊終端，打開新的編輯器終端，最后從項目根目錄啟動 Codex。
- CC Switch 負責保存和啟用線路。
- VS Code 終端負責在當前項目目錄啟動 Codex。
- 項目根目錄決定 Codex 第一眼看到的文件范圍。
- 首次任務必須先只讀驗證，再進入真實修改。
第一步：先確認靈能API服務信息
進入 VS Code 之前，先打開靈能API入口，確認賬戶、模型、額度和 API Key 狀態。不要在編輯器里反復排查半天，最后才發現賬戶側模型或額度本來就不可用。入口：https://www.lnsns.com/
如果這是新項目，建議單獨記錄項目用的 Key 名稱、模型策略和驗證日期。記錄用途即可，不要保存完整 API Key 明文。
- 確認賬戶可以正常訪問。
- 確認準備使用的模型在當前列表中。
- 確認額度足夠完成空目錄和項目首測。
- 確認 Codex 專用 Key 仍然有效。
第二步：準備編輯器項目專用 Key 規則
在 VS Code 中使用 Codex 時，很容易把項目配置、日志和截圖放在一起。為了減少泄露風險，建議給項目準備明確的 Key 規則：Key 只填進 CC Switch，不寫進 .env、不寫進 README、不貼進終端日志。
推薦記錄：
Key 用途：Codex-VSCode-Project
創建日期：2026-08-29
使用位置：CC Switch 配置卡
禁止位置：README、.env、截圖、日志、聊天記錄靈能API提供憑證入口，CC Switch 負責本地保存；項目倉庫只應該保存接入說明和安全邊界，不應該保存真實憑證。
- VS Code 截圖前檢查終端和配置面板是否露出 Key。
- 排錯時只記錄 Key 用途名稱，不記錄完整值。
- 項目交接時**置摘要，不交密鑰明文。
第三步：在 CC Switch 創建 VS Code 項目卡
打開 CC Switch，新建一張專門給 VS Code 項目使用的配置卡。名稱建議寫清服務、工具和使用環境，例如“靈能API-Codex-VSCode”。這樣后續截圖、排錯和交接都容易識別。
第一次接入不要同時建立一堆相似卡片。先讓一張 VS Code 項目卡穩定跑通，再擴展主線路、備用模型和排錯驗證卡。
- 卡片名稱：靈能API-Codex-VSCode。
- 用途備注：VS Code 終端項目開發。
- 默認模型：先選穩定模型，適合首次項目首測。
- 備用模型：跑通后再為復雜任務準備。
**步：填寫 *ase **L、模型和 Key
配置卡里最關鍵的字段仍然是 *ase **L、Model ID 和 API Key。三個字段必須來自同一套靈能API賬戶信息，不要把舊教程、舊模型、舊 Key 混在新項目里使用。
服務名稱：靈能API-Codex-VSCode
*ase **L：https://www.lnsns.com/v1
Model ID：從靈能API當前模型列表復制
API Key：Codex 項目專用 Key字段保存后，確認當前啟用的就是這張 VS Code 項目卡。接下來再打開新的編輯器終端。
- *ase **L 不要重復 /v1。
- 不要把完整接口路徑填到基礎地址里。
- Model ID 使用接口字段，不使用頁面描述詞。
- API Key 粘貼后檢查首尾空格，再避免截圖。
?? 第五步：關閉舊終端，重新打開 VS Code 終端
切換 CC Switch 配置后，不要直接在舊 VS Code 終端里繼續運行 Codex。建議關閉當前終端標簽，重新創建一個新的 PowerShell 或命令行終端，再檢查 Codex 命令。
codex --versionVS Code 有時會保留舊終端會話。新配置生效后，重新開一個干凈終端比反復在舊會話里測試更可靠。
- 能返回版本：本地 Codex 命令可用。
- 找不到命令：先檢查安裝路徑和環境變量。
- 仍然像舊線路：確認配置卡啟用并再次重開終端。
第六步：確認當前目錄就是項目根目錄
Codex 在項目里工作時，當前目錄很重要。你應該在項目根目錄啟動它，而不是在桌面、父級目錄、下載目錄或某個子目錄里隨手啟動。目錄不對，Codex 讀取到的上下文就會偏。
Get-Location
Get-ChildItem
codex確認目錄后再啟動 Codex。項目根目錄清楚，后續限制讀取范圍、運行測試和查看差異都會更順。
- 根目錄通常能看到 README、src、tests、package 文件或項目配置文件。
- 如果只看到零散文件，可能不在項目根目錄。
- 如果在父級目錄，Codex 可能讀取到多個項目，范圍會變大。
第七步：項目內第一輪只讀驗證
第一次在 VS Code 項目終端里啟動 Codex，不要馬上讓它修改代碼。先做只讀驗證，確認它理解項目結構，也確認靈能API中轉線路在項目上下文里穩定。
請只讀分析當前項目，不要修改文件。
允許讀取：README.md、src、tests
禁止讀取：.env、secrets、生產配置、數據庫備份
輸出：項目結構、關鍵目錄、下一步可以執行的小任務只讀階段就能發現很多問題。比如目錄不對、任務太寬、敏感文件未排除、模型上下文不夠等。
- 只讀驗證成功：說明項目目錄和中轉線路基本正常。
- 讀取范圍過大：收窄允許目錄。
- 出現接口錯誤：回到 CC Switch 核對字段。
第八步：第一次修改選一個低風險文件
只讀驗證通過后，可以讓 Codex ***低風險修改。推薦從 README、注釋、單個測試或簡單文案開始，不要第一次就讓它改登錄、支付、權限、部署或數據庫邏輯。
請只修改 README.md。
目標：補充本地啟動步驟。
禁止修改：源碼、依賴、配置和測試文件。
完成后輸出：修改摘要、驗證方式、未觸碰文件說明。這一步不是為了完成大任務，而是驗證 Codex 是否遵守邊界、是否能正確修改文件、是否能輸出可**的交付說明。
VS Code 終端接**見問題
這些問題大多不是單純的接口問題，而是配置、終端、目錄和任務范圍沒有對齊。按順序檢查，通常很快能定位。
- 配置切換后不生效：關閉舊 VS Code 終端，新建終端再啟動 Codex。
- Codex 讀取錯目錄：檢查當前目錄是否為項目根目錄。
- 401：檢查 API Key 是否完整、有效、屬于當前靈能API賬戶。
- 404：檢查 *ase **L 是否重復 /v1，Model ID 是否來自當前列表。
- timeout：先用短提示詞和小目錄復測，再擴大范圍。
- 誤讀敏感文件：在提示詞里明確禁止 .env、secrets 和生產配置。
? 最后一份 VS Code 接入清單
按這套流程接入后，Codex 中轉站在 VS Code 里會更穩。靈能API負責模型和中轉 API 入口，CC Switch負責線路切換，編輯器終端和項目根目錄負責把 Codex 放到正確的工作現場。