先搞清楚：Windows、WSL、Docker 是三套環(huán)境

Codex 在 Windows Terminal 里能用，不代表在 WSL 里也能用；WSL 里能用，也不代表 Docker 容器里能用。它們看起來都在同一臺(tái)電腦上，實(shí)際環(huán)境變量、****、證書路徑、用戶目錄和配置文件位置都可能不同。接入 API中轉(zhuǎn)站時(shí)，很多問題就出在這些“看不見的邊界”上。

靈能API提供統(tǒng)一的中轉(zhuǎn)入口，CC Switch可以幫你在本地管理配置卡，但運(yùn)行 Codex 的進(jìn)程到底在哪里，決定了它能讀到哪些變量、走哪條網(wǎng)絡(luò)、使用哪份配置。本文的核心思路是：先確認(rèn)運(yùn)行環(huán)境，再注入變量，再做短任務(wù)驗(yàn)證，最后才進(jìn)入真實(shí)項(xiàng)目。

• Windows 終端、WSL 發(fā)行版、Docker 容器、遠(yuǎn)程服務(wù)器都要單獨(dú)驗(yàn)證。
• 瀏覽器能打開官網(wǎng)，不代表容器里的命令行能訪問同一個(gè)入口。
• 跨環(huán)境接入時(shí)，不要把“配置正確”和“進(jìn)程讀到了配置”混為一談。

第一步：從靈能API確認(rèn)統(tǒng)一入口

先通過 https://www.lnsns.com/ 進(jìn)入靈能API，確認(rèn)當(dāng)前賬號(hào)、API中轉(zhuǎn)站接入說明、*ase **L、可用模型和賬戶狀態(tài)。這個(gè)步驟要在遷移到 WSL 或 Docker 之前完成，因?yàn)楹竺嫠协h(huán)境都應(yīng)該使用同一份來源可靠的接入信息。

不要從舊截圖、舊筆記或其他成員電腦里復(fù)制字段。跨環(huán)境排查已經(jīng)足夠復(fù)雜，如果入口來源還不統(tǒng)一，后面很容易把問題誤判成 WSL 網(wǎng)絡(luò)、Docker DNS 或服務(wù)器防火墻。先把接入字段來源統(tǒng)一，排查才有基準(zhǔn)。

• *ase **L 以靈能API當(dāng)前控制臺(tái)說明為準(zhǔn)。
• API Key 由***創(chuàng)建并安全保存，不寫進(jìn)鏡像和倉庫。
• 模型 ID 要確認(rèn)在當(dāng)前賬號(hào)中可用，再同步到各環(huán)境。

第二步：把字段分成可公開和敏感兩類

跨環(huán)境配置最容易發(fā)生密鑰泄露。有人為了讓 Docker 容器能讀到 Key，直接把真實(shí)密鑰寫進(jìn) Dockerfile；有人為了讓 WSL 自動(dòng)生效，把 Key 寫進(jìn)公開腳本；也有人把服務(wù)器上的環(huán)境變量截圖發(fā)到群里。這些做法后續(xù)都很難收拾。

建議把字段分成兩類：*ase **L、模型 ID、配置卡名稱屬于可寫入說明文檔的字段；API Key、賬號(hào)登錄信息、服務(wù)器 Secret 屬于敏感字段，只能通過密碼管理器、CI Secret、服務(wù)器環(huán)境變量或容器運(yùn)行參數(shù)注入。通過 https://www.lnsns.com/ 獲取靈能API接入信息后，也要遵守這個(gè)分層。

可公開字段：
CODEX_*ASE_**L
CODEX_MODEL
CC Switch 配置卡名稱

敏感字段：
CODEX_API_KEY
賬號(hào)密碼
CI Secret
服務(wù)器**配置

• Dockerfile 里不要**實(shí) Key。
• 倉庫腳本只寫變量名和占位符。
• 截圖前確認(rèn)沒有露出完整密鑰和賬號(hào)敏感信息。

第三步：先在 CC Switch 建一張環(huán)境驗(yàn)證卡

如果你主要在 Windows 本機(jī)操作，可以先在 CC Switch 建一張“靈能API-Codex-Env-Check”配置卡。這張卡只用于跨環(huán)境驗(yàn)證，不承擔(dān)日常開發(fā)任務(wù)。它的作用是作為基準(zhǔn)：在 Windows 里跑通，再去 WSL、Docker 和服務(wù)器里復(fù)現(xiàn)同樣的字段。

配置卡備注里寫清楚字段來源、模型、驗(yàn)證日期和用途，不要寫完整 API Key。后續(xù)如果 WSL 或容器里失敗，可以回到這張卡確認(rèn)本機(jī)基準(zhǔn)是否仍然可用。如果 Windows 基準(zhǔn)也失敗，就先查靈能API賬號(hào)狀態(tài)或本機(jī)配置，不要急著懷疑容器網(wǎng)絡(luò)。

• 環(huán)境驗(yàn)證卡只做短任務(wù)，不做真實(shí)項(xiàng)目寫入。
• 配置**過后，再把同樣字段同步到其他環(huán)境。
• 每次字段變更都要重新跑基準(zhǔn)短任務(wù)。

**步：Windows 本機(jī)先跑基準(zhǔn)驗(yàn)證

Windows 本機(jī)是最適合做第一輪驗(yàn)證的環(huán)境，因?yàn)槟阃ǔＤ芡瑫r(shí)打開瀏覽器、CC Switch、終端和項(xiàng)目文件。先在空目錄里運(yùn)行 Codex，只讓它完成一句短回復(fù)。這個(gè)階段不要讀取真實(shí)項(xiàng)目，也不要讓它創(chuàng)建文件。

mkdir codex-env-*aseline
cd codex-env-*aseline
codex "請(qǐng)只回復(fù)：Windows 基準(zhǔn)驗(yàn)證通過。不要?jiǎng)?chuàng)建、修改或刪除文件。"

這一步通過后，記錄當(dāng)前配置卡名稱、*ase **L 來源、模型 ID 和驗(yàn)證時(shí)間。后面 WSL、Docker、服務(wù)器每一輪都使用同樣提示詞。只有提示詞一致，結(jié)果才可比較；否則你無法判斷失敗是環(huán)境問題，還是任務(wù)內(nèi)容差異造成的。

• 先空目錄，再真實(shí)項(xiàng)目。
• 先短任務(wù)，再長(zhǎng)任務(wù)。
• 先建立 Windows 基準(zhǔn)，再排查其他環(huán)境。

第五步：WSL 里單獨(dú)注入變量

WSL 不是 Windows 終端的簡(jiǎn)單復(fù)制。你在 Windows 里設(shè)置的環(huán)境變量，未必會(huì)自動(dòng)進(jìn)入 WSL；你在 PowerShell 里能訪問的**端口，到了 WSL 里也可能需要使用宿主機(jī)地址或特殊網(wǎng)絡(luò)配置。因此 WSL 要單獨(dú)驗(yàn)證。

建議先在 WSL 里臨時(shí)導(dǎo)出變量，確認(rèn) Codex 能跑通，再?zèng)Q定是否寫入 shell 配置文件。不要一開始就把真實(shí) Key 寫進(jìn)公開 dotfiles，也不要把帶密鑰的配置提交到倉庫。

export CODEX_*ASE_**L="https://www.lnsns.com/"
export CODEX_API_KEY="從安全位置復(fù)制，不寫進(jìn)倉庫"
export CODEX_MODEL="按靈能API控制臺(tái)可用模型填寫"

mkdir -p ~/codex-wsl-check
cd ~/codex-wsl-check
codex "請(qǐng)只回復(fù)：WSL 驗(yàn)證通過。不要?jiǎng)?chuàng)建、修改或刪除文件。"

• WSL 變量要在 WSL 內(nèi)部檢查，不要只看 Windows。
• **設(shè)置要確認(rèn) WSL 能訪問到宿主機(jī)**端口。
• 臨時(shí)驗(yàn)證通過后，再?zèng)Q定是否寫入本機(jī)**配置。

第六步：Docker 容器不要把 Key 燒進(jìn)鏡像

Docker 接入時(shí)，最重要的原則是：鏡像可以共享，密鑰不能共享。不要把 CODEX_API_KEY 寫進(jìn) Dockerfile，也不要把包含真實(shí) Key 的 .env 文件打包進(jìn)鏡像。正確做法是在容器啟動(dòng)時(shí)通過環(huán)境變量注入，或者由部署平臺(tái)的 Secret 機(jī)制提供。

如果只是本地測(cè)試，可以用 --env 參數(shù)傳入變量；如果是團(tuán)隊(duì)環(huán)境，建議使用獨(dú)立的 .env.local 或 Secret 管理，不把真實(shí)文件提交到倉庫。靈能API的 *ase **L 和模型 ID 可以寫入示例，Key 只能運(yùn)行時(shí)注入。

docker run --rm -it \
  -e CODEX_*ASE_**L="https://www.lnsns.com/" \
  -e CODEX_API_KEY="$CODEX_API_KEY" \
  -e CODEX_MODEL="$CODEX_MODEL" \
  your-codex-i**ge:local

• Dockerfile 只描述環(huán)境，不保存真實(shí)密鑰。
• 鏡像構(gòu)建階段不要需要 API Key，運(yùn)行階段再注入。
• 容器日志不要打印完整環(huán)境變量。

? 第七步：遠(yuǎn)程服務(wù)器要區(qū)分用戶和服務(wù)進(jìn)程

服務(wù)器上能否接入，取決于運(yùn)行 Codex 的具體用戶和進(jìn)程。你用 SSH 登錄后設(shè)置的變量，只對(duì)當(dāng)前 shell 生效；如果 Codex 被腳本、服務(wù)或定時(shí)任務(wù)調(diào)用，它可能讀不到這些變量。很多遠(yuǎn)程環(huán)境失敗，就是因?yàn)槿斯さ卿洔y(cè)試通過，服務(wù)進(jìn)程卻沒有同樣配置。

建議服務(wù)器接入也按兩步走：先用當(dāng)前 SSH 會(huì)話跑空目錄短任務(wù)，再檢查實(shí)際服務(wù)或腳本使用的環(huán)境變量注入方式。不要把靈能API Key 寫進(jìn)全局可讀文件，也不要讓多個(gè)項(xiàng)目共用一份服務(wù)器級(jí)密鑰。

printenv | grep CODEX

mkdir -p ~/codex-server-check
cd ~/codex-server-check
codex "請(qǐng)只回復(fù)：服務(wù)器驗(yàn)證通過。不要?jiǎng)?chuàng)建、修改或刪除文件。"

• SSH 會(huì)話通過，不代表定時(shí)任務(wù)或服務(wù)進(jìn)程通過。
• 不同項(xiàng)目建議使用不同 Key，方便回收和用量歸因。
• 服務(wù)器文件權(quán)限要收緊，避免其他用戶讀取敏感配置。

第八步：容器網(wǎng)絡(luò)和**要單獨(dú)測(cè)試

Docker 容器里最常見的問題是網(wǎng)絡(luò)出口不同。宿主機(jī)瀏覽器能訪問靈能API，不代表容器里也能訪問；宿主機(jī)**端口可用，不代表容器默認(rèn)能訪問 127.0.0.1。容器里的 127.0.0.1 指向容器自己，而不是宿主機(jī)。

如果需要**，要根據(jù) Docker Desktop、Linux Docker 或服務(wù)器網(wǎng)絡(luò)情況設(shè)置。不要盲目照抄本機(jī)**端口。先在容器里檢查 DNS、****S 訪問和**變量，再運(yùn)行 Codex 短任務(wù)。

env | grep -i proxy

# 根據(jù)容器實(shí)際情況測(cè)試出口，不要打印敏感請(qǐng)求頭
curl -I https://www.lnsns.com/

• 容器里的 localhost 不是宿主機(jī) localhost。
• **端口要按當(dāng)前 Docker 環(huán)境確認(rèn)。
• 網(wǎng)絡(luò)測(cè)試通過后，再運(yùn)行 Codex。

第九步：按環(huán)境記錄模型和額度策略

本地、WSL、Docker、服務(wù)器對(duì) Codex 的使用頻率可能不同。本地多是交互式問答，容器可能是腳本任務(wù)，服務(wù)器可能是批量分析或自動(dòng)化檢查。不同環(huán)境應(yīng)該有不同額度策略，不能全都默認(rèn)使用同一張高能力配置。

通過靈能API查看模型和賬戶狀態(tài)后，可以為每個(gè)環(huán)境寫清用途：Windows 本機(jī)用于日常開發(fā)，WSL 用于 Linux 工具鏈項(xiàng)目，Docker 用于隔離驗(yàn)證，服務(wù)器用于自動(dòng)化任務(wù)。用途越清楚，Key 拆分和成本歸因越容易。

• 本地環(huán)境適合交互式短任務(wù)和只讀分析。
• 容器環(huán)境適合可復(fù)現(xiàn)檢查，不適合保存長(zhǎng)期密鑰。
• 服務(wù)器環(huán)境適合自動(dòng)化任務(wù)，但要限制觸發(fā)頻率。

第十步：建立跨環(huán)境驗(yàn)收清單

跨環(huán)境接入不要靠感覺驗(yàn)收。建議建立一份清單，每個(gè)環(huán)境都按同樣順序檢查：入口來源、變量存在、**狀態(tài)、短任務(wù)結(jié)果、真實(shí)項(xiàng)目只讀驗(yàn)證、日志是否脫敏。全部通過后，才能把該環(huán)境標(biāo)記為可用。

驗(yàn)收清單：
1. 已從靈能API當(dāng)前控制臺(tái)確認(rèn) *ase **L 和模型
2. API Key 通過安全方式注入，沒有寫進(jìn)倉庫或鏡像
3. 當(dāng)前環(huán)境能讀取 CODEX_*ASE_**L、CODEX_API_KEY、CODEX_MODEL
4. **和網(wǎng)絡(luò)出口已驗(yàn)證
5. 空目錄短任務(wù)通過
6. 真實(shí)項(xiàng)目只讀任務(wù)通過
7. 日志和截圖沒有完整密鑰

這份清單的價(jià)值，在于讓 Windows、WSL、Docker 和服務(wù)器都使用同一套驗(yàn)收語言。以后某個(gè)環(huán)境壞了，你可以直接對(duì)照清單定位，而不是重新從頭猜。

• 驗(yàn)收結(jié)果要寫日期和負(fù)責(zé)人。
• 失敗項(xiàng)不要跳過，先修復(fù)再進(jìn)入下一步。
• 每次 Key 輪換或模型切換后，重新跑一遍清單。

第十一步：常見錯(cuò)誤的快速定位

跨環(huán)境接入失敗時(shí)，先不要急著重裝工具。很多錯(cuò)誤都有清晰方向：變量為空，說明注入失敗；401，優(yōu)先查 Key；403，優(yōu)先查靈能API賬號(hào)權(quán)限、余額和模型授權(quán)；404，優(yōu)先查 *ase **L 和模型 ID；timeout，優(yōu)先查**、DNS、網(wǎng)絡(luò)出口和任務(wù)長(zhǎng)度。

如果 Windows 成功、WSL 失敗，重點(diǎn)看 WSL 變量和**；如果 WSL 成功、Docker 失敗，重點(diǎn)看容器網(wǎng)絡(luò)和運(yùn)行時(shí)注入；如果本地成功、服務(wù)器失敗，重點(diǎn)看服務(wù)器用戶、服務(wù)進(jìn)程和防火墻策略。按環(huán)境差異排查，比盲目換 Key 更快。

Windows 成功，WSL 失敗：檢查 WSL 內(nèi)部變量和**
WSL 成功，Docker 失敗：檢查容器 env、DNS、網(wǎng)絡(luò)出口
本地成功，服務(wù)器失敗：檢查服務(wù)器用戶、服務(wù)進(jìn)程、防火墻
短任務(wù)成功，長(zhǎng)任務(wù)失敗：檢查上下文規(guī)模、模型響應(yīng)、超時(shí)設(shè)置

• 先比較成功環(huán)境和失敗環(huán)境的差異。
• 每次只改一個(gè)變量，保留排查證據(jù)。
• 涉及密鑰疑似泄露時(shí)，直接輪換，不繼續(xù)試錯(cuò)。

? 收尾：跨環(huán)境接入的關(guān)鍵是可復(fù)現(xiàn)

Codex 接入 API中轉(zhuǎn)站本身并不難，難的是讓同一套配置在 Windows、WSL、Docker 和服務(wù)器里都能穩(wěn)定復(fù)現(xiàn)。靈能API負(fù)責(zé)提供統(tǒng)一接入入口，CC Switch負(fù)責(zé)沉淀本地配置卡，環(huán)境變量和驗(yàn)收清單負(fù)責(zé)把配置帶到真正運(yùn)行 Codex 的進(jìn)程里。

建議你從一個(gè)最小閉環(huán)開始：先通過靈能API確認(rèn)接入字段，在 Windows 本機(jī)跑通短任務(wù)，再分別進(jìn)入 WSL、Docker 和服務(wù)器驗(yàn)證同一句提示。每個(gè)環(huán)境都只讀、短任務(wù)、可記錄、可回滾。做到這一步，后續(xù)無論是團(tuán)隊(duì)協(xié)作、自動(dòng)化腳本還是遠(yuǎn)程開發(fā)，都會(huì)穩(wěn)很多。