Codex 接入 DeepSeek Chat API：CC Switch 本地路由攻略

一句話概覽

適用版本：CC Switch 3.16.0 及以上版本。本文根據倉庫內文檔與代碼整理，並用 DeepSeek 作爲 OpenAI Chat Completions 兼容接口的示例。截圖來自當前前端界面，使用去敏示例數據生成，避免泄露真實 API Key 或賬戶餘額。

爲什麼需要本地路由

新版 Codex CLI 面向的是 OpenAI Responses API，而 DeepSeek、Kimi、MiniMax、SiliconFlow 等很多供應商實際暴露的是 OpenAI Chat Completions 形態，也就是 /chat/completions。這兩種協議的請求體、流式事件和返回結構不同，直接把 Chat 接口填進 Codex 配置裏，常見結果就是模型列表不對、請求 404/400，或者流式響應無法被 Codex 正確解析。

CC Switch 的做法是讓 Codex 始終連本機路由，仍以 Responses API 發送請求；路由在內部識別當前供應商是否是 Chat 格式，再把請求改寫成 Chat Completions 發給上游，最後把 Chat 響應轉換回 Responses 形態返回給 Codex。

這條鏈路主要分成四步：

Codex 接管時，本地配置會被寫成 http://127.0.0.1:15721/v1，並強制保持 wire_api = “responses”。
Provider 的 meta.apiFormat = “openai_chat” 會告訴路由：真實上游是 Chat Completions。
路由把 /responses 或 /v1/responses 改寫到 /chat/completions，並把 Responses 請求體轉換成 Chat 請求體。
上游返回後，路由再把 Chat 的 JSON 或 SSE 轉回 Codex 能理解的 Responses JSON/SSE。

準備工作

你需要先準備好三樣東西：

已安裝並能啓動的 CC Switch。
已安裝 Codex CLI，並至少運行過一次，讓 ~/.codex/config.toml 目錄結構存在。
DeepSeek 或同類 Chat Completions 供應商的 API Key。

DeepSeek 官方文檔目前寫明 OpenAI 兼容 base URL 是 https://api.deepseek.com（其他供應商常見的是帶 /v1 後綴的 base URL），Chat API 路徑是 /chat/completions；CC Switch 的 DeepSeek 預設已經按這些信息配好，請優先使用預設，不需要手動拼接口路徑。

第一步：添加 Codex 供應商

打開 CC Switch，切到頂部的 Codex 標籤，點擊右上角的加號添加供應商。

選擇內置預設裏的 DeepSeek，只需要做兩件事：

填入 DeepSeek API Key。
保存供應商。

預設已經內置 DeepSeek 的請求地址、默認模型、模型菜單、thinking/reasoning 參數，並會自動打開需要本地路由映射。你可以按需調整默認模型或模型顯示名；協議轉換交給路由層完成即可。

第二步：開啓本地路由並接管 Codex

進入設置裏的路由頁面，展開本地路由，完成兩個開關：

打開路由總開關，啓動本地服務。默認地址是 127.0.0.1:15721。
在路由啓用中打開 Codex。如果只想讓 Codex 走路由，可以保持 Claude、Gemini 關閉。

接管後，CC Switch 會把 Codex 的 live 配置指向本機路由，並用佔位符管理認證。真實 DeepSeek Key 仍保存在 CC Switch 的 Provider 配置裏，由本地路由在轉發時注入，不需要你把 Key 暴露給 Codex live 配置。

第三步：切換供應商並重啓 Codex

回到 Codex 供應商列表，點擊 DeepSeek 供應商的啓用。如果看到需要路由標記，說明這個供應商必須在路由運行時使用；沒有啓動路由時，CC Switch 會彈出“需要路由服務才能正常使用”的提示。

切換後建議重啓當前 Codex 終端會話。原因是：

Codex 進程可能已經讀取過舊的 config.toml。
modelcatalogjson 生成後，/model 菜單通常需要新進程才能刷新。

進入 Codex 後，可以用 /model 查看當前模型是否來自 DeepSeek 預設，例如 DeepSeek V4 Flash。目前 Codex app 不支持自定義多模型選擇，會默認使用配置裏的第一個模型。

其它 Chat 供應商怎麼處理

DeepSeek、Kimi、MiniMax、SiliconFlow 等常見 Chat 格式供應商在 CC Switch 裏已有預設，優先用預設即可。只有預設裏沒有的供應商，才需要選擇自定義配置；這時按對方文檔填 API Key、base URL 和模型，並把 API 格式選爲 OpenAI Chat Completions (需開啓路由)。

如果上游直接支持 OpenAI Responses API，就不需要打開需要本地路由映射；這時 CC Switch 可以按 Responses 直連，不做 Chat 轉換。