Codex 中轉站接入教程：靈能API CC Switch 在 Git 項目中完成首次修改與提交前驗證
Codex 中轉站接入成功后，真正進入代碼倉庫時還要多一層謹慎：它會讀取文件、生成計劃、修改代碼、運行測試，最后還可能協助整理提交說明。對于 Git 項目來說，第一次使用 Codex 不應該直接大改，而要先建立分支、限定目錄、只讀分析、小范圍修改、查看差異和提交前驗證。本文以靈能API和 CC Switch 為例，把這條 Git 項目接入流程完整拆開。
先理解：Git 倉庫里接入 Codex 要留退路
空目錄里跑通 Codex 中轉 API，只說明線路可用；進入 Git 倉庫后，Codex 會面對真實代碼、配置文件、測試腳本和歷史改動。第一次讓它動手前，必須先確認當前工作區干凈、分支清楚、修改范圍可控。
Git 的價值在于可**和可回退。把 Codex 接入真實項目時，不要只看它的回答順不順，而要看每次修改是否能通過差異檢查、測試驗證和人工確認。這樣即使任務失敗，也不會把項目狀態弄亂。
- 先確認中轉 API 線路穩定，再進入倉庫。
- 先建立任務分支，再允許文件修改。
- 先看修改計劃，再執行小范圍改動。
- 先跑測試和查看差異，再整理提交說明。
第一步：確認靈能API線路和模型狀態
進入 Git 項目前，先打開靈能API入口，確認賬戶、模型、額度和 Codex 專用 Key 狀態。入口：https://www.lnsns.com/
如果你計劃讓 Codex 做代碼**或跨模塊分析，可以準備一個備用模型；但首次接入 Git 倉庫時，先用穩定模型完成最小驗證更穩。
- 賬戶可以正常登錄，模型列表可見。
- Model ID 來自當前列表，不使用舊截圖內容。
- 額度足夠完成一次只讀分析和小范圍修改。
- API Key 是 Codex 專用，不混用其他工具。
第二步：憑證不要進 Git 倉庫
Git 項目里最危險的不是改錯一行代碼，而是把 API Key、Cookie、Token 或生產配置提交進去。接入 Codex 前先定規則：Key 只放在 CC Switch 或安全位置，不寫入 README、.env 示例、測試文件或提交說明。
可記錄：
Key 用途：Codex-Git-Project
創建日期：2026-08-29
使用位置：CC Switch 配置卡
禁止：完整 API Key、Cookie、Token、私鑰、生產數據庫地址進入 Git靈能API提供憑證入口，CC Switch負責本地保存和切換；Git 倉庫只應該保存代碼和說明，不應該保存真實憑證。
- 截圖前檢查配置面板和終端輸出。
- 提交前搜索敏感***。
- 排錯日志只保留錯誤碼和脫敏摘要。
第三步：在 CC Switch 建立 Git 項目卡
打開 CC Switch，為 Git 項目創建一張獨立配置卡，例如“靈能API-Codex-GitDev”。這張卡用于真實倉庫中的只讀分析、小范圍修改和提交前說明。
第一次接入不要同時創建太多相似卡片。先讓 Git 項目卡跑通，再擴展備用模型和團隊協作卡。
- 卡片名稱包含靈能API、Codex 和 Git 項目用途。
- 默認模型選擇穩定模型，適合首次小任務。
- 備注寫清項目名稱、用途和創建日期。
- 排錯卡和正式項目卡分開，避免混用。
**步：填寫 *ase **L、模型和 Key
Git 項目卡的核心字段仍然是 *ase **L、Model ID 和 API Key。三個字段必須來自同一套靈能API賬戶信息，不要把舊服務地址、舊模型名和新 Key 混在一起。
服務名稱：靈能API-Codex-GitDev
*ase **L：https://www.lnsns.com/v1
Model ID：從靈能API當前模型列表復制
API Key：Codex Git 項目專用 Key字段保存后確認配置卡已啟用，然后關閉舊終端，重新打開項目終端。
- *ase **L 不要重復 /v1。
- 不要把完整接口路徑填進基礎地址。
- Model ID 使用接口字段，不憑展示名稱猜。
- API Key 粘貼后檢查首尾空格。
?? 第五步：進入倉庫前先確認工作區狀態
真實 Git 倉庫接入 Codex 前，先確認當前有沒有未提交改動。不要在一堆已有改動上直接讓 Codex 修改，否則后面很難區分哪些是你改的，哪些是 Codex 改的。
git status
codex --version如果你不能確定現有改動是否重要，先暫停 Codex 任務，避免覆蓋別人或自己未完成的工作。
- 工作區干凈：適合開始首次驗證。
- 已有未提交改動：先提交、暫存或記錄清楚。
- Codex 命令異常：先處理本地環境，不進入任務。
第六步：為首次任務創建獨立分支
首次使用 Codex 修改 Git 項目時，建議新建一個任務分支。分支名稱不需要復雜，但要能看出任務目標。這樣即使修改不滿意，也能很容易丟棄或對比。
git switch -c codex-first-check
# 如果環境不支持 switch，可使用：git checkout -* codex-first-check不要在主分支上直接做第一次大任務。新分支會讓接入驗證更輕松，心里也更有底。
- 分支用于隔離 Codex 第一次修改。
- 任務失敗可以直接回到原分支檢查。
- 任務成功后再整理提交說明。
第七步：先讓 Codex 只讀分析倉庫
進入任務分支后，第一輪仍然只讀。讓 Codex 讀取有限目錄，輸出項目結構、關鍵文件和下一步建議，不要直接修改。
請只讀分析當前 Git 項目，不要修改文件。
允許讀取：README.md、src、tests
禁止讀取：.env、secrets、生產配置、數據庫備份、私鑰文件
輸出：項目結構、關鍵目錄、適合首次修改的小任務如果只讀階段就出現 timeout，先縮小目錄范圍，不要讓 Codex 一次分析整個倉庫。
- 只讀分析可以確認項目根目錄是否正確。
- 可以確認 Codex 是否遵守讀取邊界。
- 可以先發現敏感目錄和大體量目錄。
第八步：第一次修改只選低風險文件
只讀分析通過后，第一次修改建議選擇低風險文件，例如 README、注釋、單個測試或非核心文案。不要直接讓 Codex 改支付、權限、部署、數據庫遷移或生產配置。
請只修改 README.md。
目標：補充 Codex 本地開發驗證步驟。
禁止修改：源碼、依賴、配置、測試文件。
完成后輸出：修改摘要、驗證方式、未觸碰文件說明。這一步主要驗證 Codex 是否能遵守邊界、是否能正確寫文件、是否能輸出清楚的變更說明。確認穩定后，再擴大到單模塊代碼修改。
第九步：修改后先看差異，再跑測試
Codex 修改完成后，不要只看它的總結。先查看 Git 差異，確認沒有越界改動，再運行相關測試或檢查命令。
git diff
git status如果差異不符合預期，先讓 Codex 根據 diff 做解釋，不要立刻追加新任務繼續改。
- 確認修改文件和任務目標一致。
- 確認沒有敏感信息進入差異。
- 確認沒有無關格式化或大范圍重寫。
- 確認測試命令只針對相關范圍。
第十步：讓 Codex 輸出提交前說明
差異和測試確認后，可以讓 Codex 根據本次改動整理提交前說明。說明要包括修改點、驗證方式、影響范圍和剩余風險，不要寫成泛泛的表揚。
請根據本次 Git diff 輸出提交前說明：
- 修改了什么
- 為什么這樣改
- 如何驗證
- 是否觸碰敏感文件
- 是否有剩余風險
- 建議提交信息這份說明可以直接轉成提交記錄、PR 描述或交付備注。
- 提交說明來自實際 diff，不來自想象。
- 驗證方式要寫具體命令或檢查動作。
- 如果沒有測試，也要明確說明未運行。
Git 項目接**見問題速查
Git 項目里最大的優勢就是能看差異、能回退。把這些動作嵌入 Codex 接入流程，使用體驗會穩很多。
- 工作區不干凈：先處理已有改動，再讓 Codex 修改。
- 讀取范圍過大：限制 README、src 子目錄或指定文件。
- 誤改無關文件：先看 git diff，再要求只修正指定文件。
- 401：檢查 API Key 是否完整、有效、屬于當前靈能API賬戶。
- 404：檢查 *ase **L 和 Model ID 是否正確。
- timeout：先用空目錄短請求復測，再縮小項目范圍。
? 最后一份 Git 項目接入清單
按這套方式接入，Codex 中轉站在 Git 項目里會更像一個可控的開發助手。靈能API負責中轉 API 和模型入口，CC Switch負責線路切換，而 Git 分支、diff、測試和提交說明負責讓每次修改都能檢查、能追蹤、能回退。