1. 本地 CC Switch 管 Codex 時(shí)遠(yuǎn)程服務(wù)器請(qǐng)求為什么總打不通先說(shuō)清楚這篇要解決的具體問(wèn)題。CC Switch 是一個(gè)本地模型路由工具它能在你本機(jī)起一個(gè)轉(zhuǎn)發(fā)服務(wù)把 Codex、Claude Code 這類(lèi)命令行工具的請(qǐng)求統(tǒng)一收口再按你配置的渠道分發(fā)出去。很多人本地用得好好的一旦把 Codex 裝到遠(yuǎn)程開(kāi)發(fā)機(jī)上請(qǐng)求就發(fā)不出去了——因?yàn)檫h(yuǎn)程服務(wù)器上的 Codex 默認(rèn)會(huì)去連127.0.0.1的某個(gè)端口而那個(gè)端口在服務(wù)器上根本沒(méi)人監(jiān)聽(tīng)真正在跑路由的是你本地電腦上的 CC Switch。這就是典型的「本地有服務(wù)、遠(yuǎn)程要調(diào)用」場(chǎng)景。你有一臺(tái)遠(yuǎn)程開(kāi)發(fā)機(jī)云主機(jī)、公司內(nèi)網(wǎng)跳板機(jī)、實(shí)驗(yàn)室服務(wù)器都算日常在服務(wù)器上跑代碼、跑 Agent但模型入口想統(tǒng)一走本地 CC Switch 管理好處是 Key 只存在本地、渠道切換只改一處、用量和日志都集中。問(wèn)題在于遠(yuǎn)程服務(wù)器和你的本地電腦之間沒(méi)有直接可達(dá)的端口通道Codex 發(fā)出的請(qǐng)求到不了 CC Switch。SSH 端口轉(zhuǎn)發(fā)就是補(bǔ)這條通道的工具。它不需要你改動(dòng)服務(wù)器防火墻也不需要把 CC Switch 暴露到公網(wǎng)而是借助你已經(jīng)建立的 SSH 連接把遠(yuǎn)程服務(wù)器上的某個(gè)本地端口「反向」映射回你本機(jī)的服務(wù)端口。這樣服務(wù)器上訪問(wèn)127.0.0.1:15721實(shí)際流量會(huì)順著 SSH 隧道回到你電腦的127.0.0.1:15721也就是 CC Switch 的路由地址。適合誰(shuí)看手上有遠(yuǎn)程開(kāi)發(fā)機(jī)、已經(jīng)在本地用 CC Switch 管 Codex、希望遠(yuǎn)程也能復(fù)用同一套模型入口的開(kāi)發(fā)者。整篇按「先打通隧道 → 再配 CC Switch → 再填 Codex → 最后驗(yàn)證」的順序走每一步都給可復(fù)制的命令和配置。核心檢索詞就是 SSH 端口轉(zhuǎn)發(fā)、CC Switch、Codex、遠(yuǎn)程服務(wù)器下面所有操作都圍繞這幾個(gè)點(diǎn)展開(kāi)。需要提前說(shuō)明一點(diǎn)SSH 端口轉(zhuǎn)發(fā)走的是你自己已有的 SSH 登錄鏈路屬于標(biāo)準(zhǔn)的遠(yuǎn)程開(kāi)發(fā)手段和任何網(wǎng)絡(luò)規(guī)避工具無(wú)關(guān)。你只是把本機(jī)服務(wù)通過(guò)加密連接共享給遠(yuǎn)程機(jī)器流量始終在你自己的兩臺(tái)設(shè)備之間。2. 前置準(zhǔn)備CC Switch 路由地址、TaoToken Key 與遠(yuǎn)程環(huán)境確認(rèn)動(dòng)手之前先把三樣?xùn)|西確認(rèn)好不然后面配到一半發(fā)現(xiàn)缺東西會(huì)很煩。第一樣是 CC Switch 的本地路由地址。打開(kāi) CC Switch進(jìn)入設(shè)置里的路由本地路由頁(yè)面默認(rèn)服務(wù)地址是127.0.0.1:15721。這個(gè)端口號(hào)要記牢后面 SSH 隧道命令和 Codex 配置都要用它。如果你的 CC Switch 改過(guò)端口以實(shí)際顯示為準(zhǔn)。確認(rèn)這個(gè)服務(wù)處于運(yùn)行狀態(tài)本地瀏覽器或 curl 能訪問(wèn)到它。第二樣是模型渠道的 Key 和 Base URL。CC Switch 本身是路由層真正提供模型能力的是你導(dǎo)入的渠道。如果你還沒(méi)有可用的渠道可以到 TaoToken 控制臺(tái)創(chuàng)建一個(gè) API Key地址是 https://taotoken.net/api-keys 創(chuàng)建后復(fù)制保存。對(duì)應(yīng)的接入文檔在 https://taotoken.net/doc 里面有 Base URL 和模型 ID 的說(shuō)明。TaoToken 的 API 入口是 https://taotoken.net/api 配置時(shí) Base URL 填這個(gè)即可。想先驗(yàn)證模型是否通可以用模型對(duì)話頁(yè)面 https://taotoken.net/models 發(fā)一條測(cè)試消息確認(rèn) Key 有效再往下走。第三樣是遠(yuǎn)程服務(wù)器的環(huán)境。你需要能 SSH 登錄上去并且服務(wù)器上已經(jīng)裝了 Codex 相關(guān)插件或 CLI。如果還沒(méi)裝先在服務(wù)器上把 Codex 裝好裝完先別急著配因?yàn)槟J(rèn)配置連不上我們要先把隧道打通。這里有個(gè)概念要理清CC Switch 跑在你本地Codex 跑在遠(yuǎn)程。兩者之間靠 SSH 反向轉(zhuǎn)發(fā)連接。所謂「反向」是指轉(zhuǎn)發(fā)方向由遠(yuǎn)程指向本地——在 SSH 連接建立時(shí)由遠(yuǎn)程服務(wù)器主動(dòng)把它的某個(gè)端口映射到本地端口。這正好符合我們的需求遠(yuǎn)程的 Codex 訪問(wèn)自己的127.0.0.1:15721流量被 SSH 帶回本地 CC Switch。把這三樣準(zhǔn)備好就可以進(jìn)入配置環(huán)節(jié)了。下面先給 SSH 隧道命令再給 CC Switch 和 Codex 的填寫(xiě)位置。3. 可復(fù)制配置SSH RemoteForward 隧道 CC Switch 與 Codex 填寫(xiě)這一步是全文的核心配置對(duì)了后面就順。分三小塊SSH 隧道、CC Switch 側(cè)、Codex 側(cè)。3.1 SSH 隧道RemoteForward 反向轉(zhuǎn)發(fā)最直接的方式是在 SSH 命令里加-R參數(shù)。假設(shè)你的遠(yuǎn)程服務(wù)器在 SSH config 里叫devbox本地 CC Switch 監(jiān)聽(tīng)127.0.0.1:15721那么登錄命令寫(xiě)成ssh -R 127.0.0.1:15721:127.0.0.1:15721 devbox-R的格式是遠(yuǎn)程監(jiān)聽(tīng)地址:遠(yuǎn)程端口:本地目標(biāo)地址:本地目標(biāo)端口。這條命令的意思是在遠(yuǎn)程服務(wù)器上監(jiān)聽(tīng)127.0.0.1:15721把收到的流量轉(zhuǎn)發(fā)到本地的127.0.0.1:15721。登錄成功后隧道就建立了。但每次手動(dòng)敲參數(shù)容易忘更好的做法是寫(xiě)進(jìn) SSH config 文件。打開(kāi)你本地的~/.ssh/config找到對(duì)應(yīng) Host 段落加上 RemoteForward 配置Host devbox HostName 192.0.2.10 User simon RemoteForward 127.0.0.1:15721 127.0.0.1:15721 ExitOnForwardFailure yes這里HostName和User換成你自己的服務(wù)器地址和用戶名。ExitOnForwardFailure yes很關(guān)鍵如果端口轉(zhuǎn)發(fā)失敗比如遠(yuǎn)程端口被占用SSH 會(huì)直接退出而不是靜默繼續(xù)這樣你能立刻發(fā)現(xiàn)問(wèn)題而不是登錄成功卻發(fā)現(xiàn)隧道沒(méi)通。配好之后直接ssh devbox就會(huì)自動(dòng)帶上轉(zhuǎn)發(fā)。注意如果遠(yuǎn)程服務(wù)器上15721端口已經(jīng)被別的進(jìn)程占用SSH 會(huì)報(bào)remote port forwarding failed。這時(shí)要么換一個(gè)遠(yuǎn)程端口比如-R 127.0.0.1:25721:127.0.0.1:15721要么先查清占用進(jìn)程。換端口的話Codex 側(cè)填的端口也要跟著改。3.2 CC Switch 側(cè)確認(rèn)路由與渠道CC Switch 這邊主要是確認(rèn)路由服務(wù)在跑、渠道已導(dǎo)入。進(jìn)入設(shè)置 → 路由 → 本地路由確認(rèn)服務(wù)地址是127.0.0.1:15721狀態(tài)為運(yùn)行中。然后在渠道管理里把你從 TaoToken 拿到的 Key 導(dǎo)入進(jìn)去Base URL 填https://taotoken.net/api模型 ID 按文檔填你需要的那個(gè)。如果你用的是配置文件方式管理渠道CC Switch 的渠道配置大致是 JSON 結(jié)構(gòu)形如{ name: taotoken, base_url: https://taotoken.net/api, api_key: sk-你的Key, models: [你的模型ID] }具體字段名以你本地 CC Switch 版本為準(zhǔn)路徑一般在應(yīng)用配置目錄下。導(dǎo)入后CC Switch 會(huì)把所有渠道統(tǒng)一暴露在127.0.0.1:15721這個(gè)路由地址上Codex 只需要連這個(gè)地址不用關(guān)心背后是哪個(gè)渠道。3.3 Codex 側(cè)Base URL、Key、Model ID 三件套遠(yuǎn)程服務(wù)器上的 Codex 需要指向本地路由。Codex 的配置通常在~/.codex/config.toml或類(lèi)似路徑核心是三個(gè)值Base URL、API Key、Model ID。Base URL 填http://127.0.0.1:15721注意是遠(yuǎn)程服務(wù)器視角的本地地址因?yàn)樗淼酪呀?jīng)在服務(wù)器上監(jiān)聽(tīng)了這個(gè)端口Key 填 CC Switch 路由要求的 Key如果 CC Switch 路由不校驗(yàn) Key可填任意占位符但建議按 CC Switch 文檔填Model ID 填你在 CC Switch 里配置的模型。一個(gè) TOML 配置示例model 你的模型ID model_provider ccswitch [model_providers.ccswitch] name CC Switch Local Route base_url http://127.0.0.1:15721 api_key sk-你的Key如果你用的是 Codex 的auth.json方式管理憑據(jù)那對(duì)應(yīng)寫(xiě){ base_url: http://127.0.0.1:15721, api_key: sk-你的Key, model: 你的模型ID }三件套缺一不可Base URL 決定請(qǐng)求發(fā)到哪Key 決定能不能過(guò)鑒權(quán)Model ID 決定用哪個(gè)模型。任何一項(xiàng)填錯(cuò)驗(yàn)證階段都會(huì)報(bào)錯(cuò)。填完保存準(zhǔn)備驗(yàn)證。4. 驗(yàn)證請(qǐng)求從遠(yuǎn)程服務(wù)器發(fā)一次對(duì)話確認(rèn)鏈路通配置寫(xiě)完不代表通了必須實(shí)測(cè)。驗(yàn)證分兩步先確認(rèn)隧道端口在遠(yuǎn)程服務(wù)器上確實(shí)被監(jiān)聽(tīng)再?gòu)倪h(yuǎn)程發(fā)一次真實(shí)請(qǐng)求。第一步在遠(yuǎn)程服務(wù)器上執(zhí)行ss -tlnp | grep 15721如果看到類(lèi)似LISTEN 0 128 127.0.0.1:15721的輸出說(shuō)明 SSH 反向轉(zhuǎn)發(fā)已經(jīng)生效服務(wù)器上有人在監(jiān)聽(tīng)這個(gè)端口。如果沒(méi)有輸出說(shuō)明隧道沒(méi)建起來(lái)回到第 3.1 節(jié)檢查 RemoteForward 配置和 SSH 登錄日志。第二步在遠(yuǎn)程服務(wù)器上直接 curl 本地路由確認(rèn)能拿到響應(yīng)curl -s http://127.0.0.1:15721/v1/models \ -H Authorization: Bearer sk-你的Key如果返回模型列表 JSON說(shuō)明從遠(yuǎn)程到本地 CC Switch 的鏈路是通的。如果返回連接拒絕說(shuō)明隧道斷了或 CC Switch 沒(méi)運(yùn)行如果返回 401說(shuō)明 Key 不對(duì)檢查 CC Switch 路由的鑒權(quán)配置。第三步用 Codex 本身發(fā)一次對(duì)話。在遠(yuǎn)程服務(wù)器上啟動(dòng) Codex輸入一句簡(jiǎn)單的話比如「用一句話解釋什么是端口轉(zhuǎn)發(fā)」。觀察返回如果正常輸出內(nèi)容說(shuō)明整條鏈路——遠(yuǎn)程 Codex → 遠(yuǎn)程 15721 → SSH 隧道 → 本地 CC Switch → TaoToken → 模型——全部打通。如果卡住或報(bào)錯(cuò)看 Codex 的輸出日志通常會(huì)指出是連接問(wèn)題還是鑒權(quán)問(wèn)題。實(shí)測(cè)下來(lái)最容易出問(wèn)題的是端口號(hào)和 Key 這兩處。端口號(hào)在 SSH 命令、CC Switch、Codex 三處必須一致Key 在 CC Switch 渠道和 Codex 配置兩處必須匹配。驗(yàn)證通過(guò)后你以后每次ssh devbox登錄隧道會(huì)自動(dòng)建立Codex 直接可用不用重復(fù)配置。5. 本篇常見(jiàn)錯(cuò)排查401、remote port forwarding failed 與 reading choices配置過(guò)程中會(huì)碰到幾類(lèi)典型報(bào)錯(cuò)這里逐個(gè)對(duì)照排查。401 Unauthorized請(qǐng)求到了 CC Switch 但鑒權(quán)沒(méi)過(guò)。原因通常是 Codex 里填的 Key 和 CC Switch 路由要求的 Key 不一致。檢查兩處CC Switch 路由設(shè)置里的鑒權(quán) Key以及 Codex 配置里的api_key。如果 CC Switch 路由不校驗(yàn) Key也要確認(rèn)渠道本身的 Key 是有效的——渠道 Key 無(wú)效時(shí)CC Switch 轉(zhuǎn)發(fā)到上游會(huì)拿到 401最終透?jìng)鹘o Codex。這時(shí)去 TaoToken 控制臺(tái)確認(rèn) Key 狀態(tài)必要時(shí)重新創(chuàng)建一個(gè)。remote port forwarding failed for listen port 15721SSH 登錄時(shí)報(bào)這個(gè)說(shuō)明遠(yuǎn)程服務(wù)器上 15721 已被占用或者之前一條 SSH 連接的轉(zhuǎn)發(fā)沒(méi)釋放。先ssh devbox登錄后執(zhí)行ss -tlnp | grep 15721看誰(shuí)占著如果是殘留的 sshd 轉(zhuǎn)發(fā)進(jìn)程斷開(kāi)舊連接再重連。實(shí)在沖突就換遠(yuǎn)程端口比如-R 127.0.0.1:25721:127.0.0.1:15721同時(shí) Codex 的 Base URL 改成http://127.0.0.1:25721。local proxy failed / connection refusedCodex 報(bào)連接本地代理失敗。這通常是隧道沒(méi)建立或者 CC Switch 沒(méi)運(yùn)行。先在遠(yuǎn)程ss -tlnp | grep 15721確認(rèn)監(jiān)聽(tīng)存在再在本地確認(rèn) CC Switch 路由服務(wù)在跑。兩者缺一請(qǐng)求都到不了。reading choices 相關(guān)報(bào)錯(cuò)這類(lèi)錯(cuò)誤一般出現(xiàn)在響應(yīng)解析階段說(shuō)明請(qǐng)求已經(jīng)到達(dá)上游并返回了數(shù)據(jù)但格式不符合 Codex 預(yù)期。常見(jiàn)原因是 Model ID 填錯(cuò)或者 CC Switch 渠道配置的模型和 Codex 請(qǐng)求的模型不匹配。檢查 Codex 配置里的model字段確保它在 CC Switch 渠道支持的模型列表里。如果 CC Switch 做了模型映射確認(rèn)映射關(guān)系正確。OAuth 相關(guān)報(bào)錯(cuò)如果你用的是需要 OAuth 的渠道而 Codex 走的是 API Key 模式會(huì)報(bào) OAuth 失敗。這種情況要么在 CC Switch 側(cè)把渠道切成 API Key 模式要么在 Codex 側(cè)按 OAuth 流程配置。多數(shù)本地路由場(chǎng)景用 API Key 就夠了不建議混用。排查順序建議固定先看隧道ss命令→ 再看 CC Switch本地 curl→ 再看 Key401 類(lèi)→ 最后看模型 ID解析類(lèi)。按這個(gè)順序走基本能定位到具體環(huán)節(jié)。6. 長(zhǎng)期編碼與 Agent 場(chǎng)景把這條鏈路固定下來(lái)隧道打通、驗(yàn)證通過(guò)之后接下來(lái)是讓它穩(wěn)定服務(wù)于日常開(kāi)發(fā)。幾個(gè)實(shí)用建議。第一把 SSH config 里的 RemoteForward 和 ExitOnForwardFailure 保留這樣每次登錄自動(dòng)建隧道不用記命令。如果你經(jīng)常開(kāi)多個(gè)終端連同一臺(tái)服務(wù)器注意 SSH 復(fù)用ControlMaster場(chǎng)景下轉(zhuǎn)發(fā)只建一次重復(fù)登錄不會(huì)重復(fù)監(jiān)聽(tīng)這是正常的。第二CC Switch 的渠道配置建議固定一個(gè)主渠道加一個(gè)備用渠道主渠道出問(wèn)題時(shí)快速切換Codex 側(cè)不用改任何配置因?yàn)?Base URL 始終指向本地路由。這就是統(tǒng)一入口的價(jià)值遠(yuǎn)程機(jī)器上的工具配置一次之后渠道變更都在本地完成。第三如果你在遠(yuǎn)程跑的是長(zhǎng)期編碼任務(wù)或 Agent建議把 Codex 配置和 SSH 隧道做成啟動(dòng)腳本登錄后自動(dòng)檢查端口監(jiān)聽(tīng)狀態(tài)異常時(shí)給出提示。這樣即使隧道偶發(fā)斷開(kāi)也能快速發(fā)現(xiàn)。第四Key 管理上本地 CC Switch 集中持有渠道 Key遠(yuǎn)程 Codex 只持有路由 Key這樣遠(yuǎn)程服務(wù)器上不落敏感憑據(jù)安全性更好。需要新增渠道時(shí)只改本地 CC Switch遠(yuǎn)程無(wú)感。對(duì)于需要長(zhǎng)期跑 Agent、頻繁調(diào)用模型的場(chǎng)景可以了解下 Coding Plan 這類(lèi)方案地址是 https://taotoken.net/coding-plan 適合把編碼類(lèi)請(qǐng)求集中管理。日常驗(yàn)證模型連通性用模型對(duì)話頁(yè)面 https://taotoken.net/models 接入文檔在 https://taotoken.net/doc 控制臺(tái)和 API Key 管理在 https://taotoken.net/console 和 https://taotoken.net/api-keys 。把這些入口理順本地 CC Switch 加 SSH 端口轉(zhuǎn)發(fā)的組合就能穩(wěn)定支撐遠(yuǎn)程開(kāi)發(fā)機(jī)的模型調(diào)用需求。