先定邊界：本機配置和遠程配置不是一回事

很多人第一次在遠程服務(wù)器里接入 Codex 中轉(zhuǎn)站時，會默認認為“本地能用，SSH 上去也應(yīng)該能用”。實際并不是這樣。本機桌面里的 CC Switch、瀏覽器登錄態(tài)、系統(tǒng)環(huán)境變量，通常只屬于本機；遠程服務(wù)器上的 shell、用戶目錄、配置文件和網(wǎng)絡(luò)出口，則是另一套環(huán)境。

所以這篇教程不從“復(fù)制一段配置”開始，而是先把鏈路拆成三段：靈能API 負責提供中轉(zhuǎn)服務(wù)和模型能力，CC Switch 負責整理可切換配置，遠程 SSH 終端負責真正執(zhí)行 Codex。只要三段分別驗證，遠程接入就不會亂。

• 本機：用于登錄靈能API、管理 Key、整理配置字段。
• CC Switch：用于保存 *ase **L、Model ID、API Key 等連接信息。
• 遠程服務(wù)器：用于運行 Codex，并確認當前 shell 是否真的讀到了配置。
• 項目目錄：用于最后一輪真實任務(wù)驗證，不要一開始就直接進入生產(chǎn)項目。

第一步：確認靈能API賬號、額度和模型狀態(tài)

先在瀏覽器中打開靈能API入口，確認賬號可以正常進入、Key 沒有被撤銷、模型列表可見、額度能夠支撐測試。入口地址是 https://www.lnsns.com/。遠程服務(wù)器接入失敗時，先排除服務(wù)側(cè)問題，會比在終端里反復(fù)改命令更省時間。

這里不要把完整 Key 發(fā)到聊天窗口或截圖里。你只需要記錄 Key 的用途、創(chuàng)建時間和后四位，方便后續(xù)確認是不是同一條遠程線路。

• 確認賬號登錄正常，避免把賬號問題誤判成 SSH 配置問題。
• 確認模型名稱和 Model ID 來自當前頁面，不使用舊截圖或聊天記錄。
• 確認 API Key 仍然有效，復(fù)制時不要帶前后空格。
• 確認余額或套餐可以完成至少兩輪短請求測試。

第二步：為遠程服務(wù)器單獨準備一組連接信息

遠程服務(wù)器建議使用單獨的 Key，而不是和本機開發(fā)共用一組。原因很簡單：遠程機可能由多人登錄，也可能跑自動任務(wù)；一旦出現(xiàn)異常調(diào)用，用獨立 Key 可以快速定位、限額和撤銷，不影響本機日常使用。

遠程專用記錄模板：
用途：Codex SSH 遠程終端驗證
平臺：靈能API
*ase **L：https://www.lnsns.com/v1
Model ID：從當前模型列表復(fù)制
Key 備注：server-codex-ssh，不記錄完整明文

靈能API 的角色是提供可訪問的中轉(zhuǎn)入口，而不是替你管理每臺服務(wù)器上的密鑰邊界。密鑰怎么分配、誰能讀取、保存在哪里，應(yīng)該在接入前先想清楚。

• 一臺遠程機對應(yīng)一條用途清晰的 Key，后續(xù)追蹤更容易。
• 不要把 Key 寫進 README、部署文檔、公開截圖或 issue。
• 團隊共享服務(wù)器建議給 Key 設(shè)置調(diào)用預(yù)算，先低額度試運行。

第三步：在 CC Switch 建一張 SSH 專用配置卡

接下來打開 CC Switch，新建一張專門給遠程服務(wù)器使用的配置卡。卡片名稱建議寫清楚用途，比如“靈能API-Codex-SSH-******”。這樣后續(xù)切換本機、WSL、容器、遠程服務(wù)器時，不會把不同場景混在一起。

如果你已經(jīng)有一張本機可用的靈能API配置卡，也不要直接復(fù)用。復(fù)制一張再改名更穩(wěn)，至少能保證本機和遠程排查互不干擾。

• 卡片名稱包含用途，不只寫“默認配置”。
• 先使用穩(wěn)定模型完成接入驗證，再考慮切換更高規(guī)格模型。
• 高級參數(shù)保持默認，先減少變量。
• 備注里寫明遠程服務(wù)器名稱或用途，但不要寫 Key 明文。

? **步：核對 *ase **L、Model ID 和 Key

這一段最容易出錯。*ase **L 要寫到接口根路徑，Model ID 要與靈能API當前模型列表一致，API Key 要使用遠程專用 Key。只要其中一個字段來自舊配置，SSH 終端里就可能出現(xiàn) 401、404、timeout 或模型不可用。

推薦核對順序：
1. *ase **L：確認協(xié)議、域名和 /v1 路徑
2. Model ID：從靈能API當前模型列表復(fù)制
3. API Key：使用遠程服務(wù)器專用 Key
4. 保存配置：確認字段沒有回退或被清空
5. 啟用配置：確認當前啟用的就是 SSH 專用卡

如果你準備把配置同步到遠程服務(wù)器，建議只同步必要字段，不同步本機所有歷史卡片。遠程環(huán)境越干凈，后面越好排錯。

• *ase **L 不要重復(fù)寫兩個 /v1。
• Model ID 不要使用頁面展示名替代真實調(diào)用名。
• Key 粘貼后檢查首尾空格，尤其是從表格或聊天窗口復(fù)制時。

第五步：登錄 SSH 后先檢查當前用戶和工作目錄

遠程服務(wù)器上經(jīng)常有多個用戶：root、deploy、u*untu、administrator、項目專用用戶。Codex 在哪個用戶下運行，就會讀取哪個用戶目錄和環(huán)境變量。登錄后第一件事不是運行 Codex，而是確認當前身份和目錄。

whoami
pwd
ls -la
printenv | grep -Ei 'OPENAI|API|CODEX|*ASE|KEY'

這一步看起來基礎(chǔ)，但它能提前發(fā)現(xiàn) 70% 的遠程接入問題。很多失敗不是靈能API不可用，而是 Codex 在錯誤的用戶、錯誤的目錄、錯誤的環(huán)境變量下啟動了。

• 如果當前是 root，但項目實際由 deploy 用戶維護，先切到正確用戶再配置。
• 如果當前目錄是系統(tǒng)目錄，不要直接發(fā)起項目級任務(wù)。
• 如果環(huán)境變量里已有舊 Key 或舊 *ase **L，先記錄來源再清理。

?? 第六步：把配置寫到遠程 shell 能讀取的位置

如果你的 CC Switch 配置不會自動同步到遠程服務(wù)器，就需要在遠程 shell 里設(shè)置必要變量。不同工具讀取的變量名可能不同，實際以你當前 Codex 環(huán)境要求為準。關(guān)鍵原則是：只在當前用戶的**配置里保存，不寫進項目倉庫。

# 示例：寫入當前用戶 shell 配置，變量名按你的 Codex 環(huán)境調(diào)整
export OPENAI_*ASE_**L="https://www.lnsns.com/v1"
export OPENAI_API_KEY="替換為遠程專用Key"
export OPENAI_MODEL="從靈能API模型列表復(fù)制的Model ID"

如果遠程服務(wù)器使用 zsh、*ash、fish 或系統(tǒng)服務(wù)啟動 Codex，配置文件位置會不同。不要只改一個文件就假設(shè)全局生效，應(yīng)該用新 SSH 會話重新驗證。

• 臨時測試可以先在當前 shell export，確認成功后再寫入用戶配置文件。
• 不要把 export 命令寫進項目啟動腳本，除非它本來就是**腳本。
• 寫入后重新打開 SSH 會話，確認新會話也能讀取。

第七步：在空目錄做第一輪短請求驗證

正式進入項目之前，先建一個空目錄做短請求。這樣可以排除項目依賴、權(quán)限、歷史配置、隱藏文件和超大上下文帶來的干擾。驗證目標只有一個：確認遠程服務(wù)器當前 shell 能通過靈能API中轉(zhuǎn)站完成一次干凈請求。

mkdir -p ~/codex-ssh-relay-check
cd ~/codex-ssh-relay-check
codex

請只回復(fù)：SSH 遠程終端的 Codex 中轉(zhuǎn)站配置已生效。

空目錄驗證成功以后，再進入真實項目。不要跳過這一步，因為真實項目失敗時變量太多，很難判斷是網(wǎng)絡(luò)、配置、權(quán)限還是上下文過大。

• 成功：說明遠程 shell、Key、*ase **L、Model ID 至少能完成基礎(chǔ)調(diào)用。
• 401：優(yōu)先檢查 Key 是否來自當前靈能API賬號，是否復(fù)制完整。
• 404：優(yōu)先檢查 *ase **L 路徑和 Model ID。
• timeout：檢查遠程服務(wù)器網(wǎng)絡(luò)出口、防火墻、**和 DNS。

第八步：進入真實項目前先做只讀檢查

遠程服務(wù)器里的項目往往直接連著部署流程或生產(chǎn)配置。第一次讓 Codex 進入項目時，建議先做只讀分析，不要直接讓它修改文件、運行遷移或重啟服務(wù)。先確認它能讀取正確目錄，再逐步放開任務(wù)。

請只讀分析當前項目，不要修改文件。
請輸出：
1. 項目技術(shù)棧
2. 可能影響 Codex 中轉(zhuǎn) API 的配置文件
3. 需要避開的敏感目錄
4. 下一步最小驗證建議

這一步能判斷靈能API線路在真實項目上下文里是否穩(wěn)定。如果只讀分析都不穩(wěn)定，不要急著做代碼修改，先回到空目錄和短任務(wù)繼續(xù)排查。

• 確認 Codex 沒有讀取 secrets、備份、私鑰或生產(chǎn)配置。
• 確認輸出能正常完成，而不是在掃描階段超時。
• 確認模型響應(yīng)風格、速度和上下文容量符合預(yù)期。

第九步：遠程場景常見故障排查

SSH 接入的故障很少只有一個原因。建議按“服務(wù)側(cè)、配置側(cè)、遠程 shell、項目側(cè)”的順序排查，每次只改一個變量，改完就重新開會話復(fù)測。

排查記錄里可以寫靈能API、配置卡名稱、錯誤碼、發(fā)生時間和測試目錄，但不要寫完整 Key。把可復(fù)現(xiàn)步驟留下來，下次換機器時能直接復(fù)用。

• 本機可用、遠程不可用：檢查遠程服務(wù)器是否設(shè)置了同樣的 *ase **L、Key 和 Model ID。
• 同一臺遠程機某個用戶可用、另一個用戶不可用：檢查用戶級 shell 配置和權(quán)限。
• 空目錄可用、項目不可用：檢查項目環(huán)境變量、**設(shè)置和上下文規(guī)模。
• 偶發(fā) timeout：檢查服務(wù)器網(wǎng)絡(luò)出口、DNS、**和防火墻策略。
• 模型調(diào)用名報錯：回到靈能API模型列表重新復(fù)制 Model ID。

第十步：團隊服務(wù)器建議加一層使用規(guī)范

如果遠程服務(wù)器不是你一個人用，就不要把 Codex 中轉(zhuǎn)站接入做成“誰都能調(diào)用、誰都不知道 Key 在哪里”的狀態(tài)。團隊場景里，靈能API的 Key、CC Switch配置卡、遠程用戶權(quán)限和項目目錄權(quán)限，最好都有明確邊界。

遠程接入的目標不是“能跑就行”，而是讓每一次調(diào)用都能追蹤來源、控制成本、明確權(quán)限。這樣 Codex 才適合放進長期開發(fā)流程。

• 每個團隊或項目使用獨立 Key，不和個人測試 Key 混用。
• 給遠程服務(wù)器 Key 設(shè)置合理預(yù)算，先小額度運行。
• 共享服務(wù)器不要把 Key 寫入全局 /etc/profile，除非確認所有用戶都應(yīng)訪問。
• 項目級任務(wù)先從只讀、測試、格式化、局部修復(fù)開始，不直接做大范圍重構(gòu)。

? 最后一份 SSH 接入檢查清單

完成這些步驟后，遠程服務(wù)器里的 Codex 中轉(zhuǎn)站接入就有了清晰的驗證路徑：先確認靈能API服務(wù)側(cè)，再確認 CC Switch 配置，再確認 SSH 終端讀取，最后進入真實項目。這樣做雖然多了幾分鐘檢查，但能顯著減少后續(xù)排錯成本。

• 靈能API賬號、模型、額度和遠程專用 Key 已確認。
• CC Switch 已創(chuàng)建 SSH 專用配置卡，并啟用當前卡片。
• *ase **L、Model ID、API Key 三項來源一致。
• SSH 登錄后已確認當前用戶、目錄和舊環(huán)境變量。
• 遠程 shell 已重新打開，并能讀取新配置。
• 空目錄短請求驗證通過。
• 真實項目第一輪只讀分析通過，沒有觸碰敏感文件。
• 團隊共享服務(wù)器已設(shè)置 Key 用途、預(yù)算和訪問邊界。