Codex接入DeepSeek本地路由的詳細教程
我要評論Codex接入DeepSeek本地路由教程（使用CC Switch）
關(guān)鍵詞：Codex CLI、DeepSeek API、CC Switch、本地路由、OpenAI Chat Completions 轉(zhuǎn)換、模型代理、API 兼容層
V1：問題分析——為什么需要本地路由
Codex CLI 新版本默認面向 OpenAI Responses API，而市面上大多數(shù)模型服務（DeepSeek / Kimi / MiniMax / SiliconFlow 等）實際提供的是：
OpenAI Chat Completions 規(guī)范：/chat/completions
兩者核心差異：
| 維度 | Responses API | Chat Completions |
|---|---|---|
| 請求路徑 | /v1/responses | /v1/chat/completions |
| 數(shù)據(jù)結(jié)構(gòu) | Response Object | Message Array |
| 流式協(xié)議 | event-based | SSE chunk |
| tool 調(diào)用 | 標準化 tool schema | 各家兼容不一 |
直接把 Chat API 塞進 Codex 配置會出現(xiàn)：
- 404 / 400 請求錯誤
- 模型列表異常
- stream 無法解析
- tool 調(diào)用失敗
V1.1 架構(gòu)設計（CC Switch 核心鏈路）
CC Switch 的核心思路是 “協(xié)議中間層轉(zhuǎn)換”：
Codex CLI ↓ (Responses API) 本地路由 127.0.0.1:15721 ↓ (協(xié)議識別 + 改寫) Chat Completions 上游（DeepSeek） ↓ 響應轉(zhuǎn)換（Chat → Responses） ↓ Codex CLI
關(guān)鍵機制：
Codex 強制指向本地：
http://127.0.0.1:15721/v1
Provider 標記：
meta.apiFormat = openai_chat
路由層執(zhí)行：
- Responses → Chat 轉(zhuǎn)換
- SSE 重寫
- tool schema 兼容
輸出再轉(zhuǎn)換回 Responses
準備工作
在開始前確認以下環(huán)境：
- 已安裝 CC Switch（支持 3.16.0+）
- 已安裝 Codex CLI（已生成
~/.codex/config.toml） - 已獲取 DeepSeek API Key 或同類 Chat API Key
Step 1：添加 DeepSeek Provider
進入 CC Switch：
Codex → 添加供應商 → 選擇 DeepSeek 預設
填寫：
- API Key：DeepSeek Key
- 保存即可
預設已包含：
- Base URL
- 默認模型
- reasoning / thinking 參數(shù)
- Chat Completions 適配規(guī)則
- 路由自動開關(guān)標記
Step 2：開啟本地路由（核心步驟）
進入：
設置 → 路由 → 本地路由
開啟：
1）路由服務
http://127.0.0.1:15721
2）Codex 接管開關(guān)
- 啟用 Codex
- 可關(guān)閉 Claude / Gemini（可選）
完成后效果：
- Codex 不再直連 API
- 所有請求進入 CC Switch 路由層
- Key 不暴露在 Codex 配置中
Step 3：切換供應商并重啟 Codex
操作：
- 在 Codex Provider 中啟用 DeepSeek
- 確認提示：
需要路由 - 重啟 Codex CLI
原因：
- Codex 不會熱加載 config
- modelcatalogjson 需要重新生成
/model列表刷新依賴新進程
Step 4：驗證是否生效
進入 Codex 后執(zhí)行：
/model
正常情況：
- 能看到 DeepSeek 模型（如 V4 Flash / Reasoner）
- 默認模型來自 config 第一項
- 請求走 localhost:15721
其他 Chat 供應商接入方式
CC Switch 已預置：
- DeepSeek
- Kimi
- MiniMax
- SiliconFlow
通用規(guī)則：
| 項目 | 配置 |
|---|---|
| API Format | OpenAI Chat Completions |
| Base URL | 服務根地址（不帶 /chat/completions） |
| 路由 | 必須開啟（如果是 Chat 格式） |
常見問題排查
1. Codex 報 404 / 找不到 /responses
原因：
- 沒走本地路由
- config.toml 未指向 localhost
檢查：
~/.codex/config.toml
應為：
http://127.0.0.1:15721/v1
2. DeepSeek 上游 404
通常原因：
- Base URL 寫錯（不應帶
/chat/completions） - 使用了非預設配置
正確方式：使用 CC Switch 預設
3. /model 看不到模型
原因：
- Codex 未重啟
- modelcatalogjson 未刷新
解決：
- 重啟 CLI
- 重新加載 provider
4. 請求沒有走 DeepSeek
檢查三點一致性：
- Codex Provider = DeepSeek
- 路由服務運行中
- Codex 接管已開啟
CC Switch vs 直連 API
| 模式 | 優(yōu)點 | 缺點 |
|---|---|---|
| 直連 Chat API | 簡單 | 不兼容 Codex |
| CC Switch 路由 | 兼容 Codex + 多供應商 | 需要本地服務 |
下載地址
| 工具 | 地址 |
|---|---|
| CC Switch | https://pan.quark.cn/s/abb75497e919 |
| Codex CLI | https://codexdown.cn/ |
參考說明
本方案本質(zhì)是：
OpenAI Responses → Chat Completions 的協(xié)議代理層
適用于所有“只提供 Chat API，但需要接入 Codex/Agents”的場景。
以上就是Codex接入DeepSeek本地路由的詳細教程的詳細內(nèi)容，更多關(guān)于Codex接入DeepSeek本地路由的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
Codex從config.toml到AGENTS.md的配置實戰(zhàn)
最近用 AI 寫代碼的人越來越多，但很多同學對 Codex 的理解還停留在一個層面：把它當成一個能幫你補代碼、解釋代碼的聊天工具,本文就從 config.toml、AGENTS.md、權(quán)限策略2026-05-29
Codex 是OpenAI 推出的一系列人工智能編碼工具，通過將任務委托給強大的云端和本地編碼代理，幫助開發(fā)人員提升工作效率，文中通過示例介紹的非常詳細，需要的朋友們下面隨2026-05-29
本文詳細介紹了如何wen模型在macOSOSMini環(huán)境下配置Codex調(diào)用自定義AIAPI的方法,包括配置文件編寫、環(huán)境變量設置等以及常見問題及解決方案，感興趣的可以了解一下2026-05-29
2026年國內(nèi) Codex 安裝教程和使用教程(GPT-5.4完整指南)
本文主要介紹了國內(nèi) Codex 安裝教程和使用教程，基于GPT-5.4模型,文中通過示例介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來2026-05-21
本文主要介紹了Codex的五種使用方式,并包括直接下載應用、通過CodexCLI在終端使用、在VSCode插件中使用、通過Homebrew安裝以及通過GitHubRelease下載手動安裝，具有一定的2026-05-21- 本文主要介紹了OpenAI Codex 使用教程，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2026-04-30
