Codex接入DeepSeek本地路由的详细教程

目录

• Codex接入DeepSeek本地路由教程（使用CC Switch）
• V1：问题分析——为什么需要本地路由
• V1.1 架构设计（CC Switch 核心链路）
• 准备工作
• Step 1：添加 DeepSeek Provider
• Step 2：开启本地路由（核心步骤）
• 1）路由服务
• 2）Codex 接管开关
• Step 3：切换供应商并重启 Codex
• Step 4：验证是否生效
• 其他 Chat 供应商接入方式
• 常见问题排查
• 1. Codex 报 404 / 找不到 /responses
• 2. DeepSeek 上游 404
• 3. /model 看不到模型
• 4. 请求没有走 DeepSeek
• CC Switch vs 直连 API
• 下载地址
• 参考说明

关键词：Codex CLI、DeepSeek API、CC Switch、本地路由、OpenAI Chat Completions 转换、模型代理、API 兼容层

Codex CLI 新版本默认面向 OpenAI Responses API，而市面上大多数模型服务（DeepSeek / Kimi / MiniMax / SiliconFlow 等）实际提供的是：

OpenAI Chat Completions 规范：/chat/completions

两者核心差异：

维度	Responses API	Chat Completions
请求路径	/v1/responses	/v1/chat/completions
数据结构	Response Object	Message Array
流式协议	event-based	SSE chunk
tool 调用	标准化 tool schema	各家兼容不一

直接把 Chat API 塞进 Codex 配置会出现：

• 404 / 400 请求错误
• 模型列表异常
• stream 无法解析
• tool 调用失败

CC Switch 的核心思路是 “协议中间层转换”：

Codex CLI
   ↓ (Responses API)
本地路由 127.0.0.1:15721
   ↓ (协议识别 + 改写)
Chat Completions 上游（DeepSeek）
   ↓
响应转换（Chat → Responses）
   ↓
Codex CLI

关键机制：

Codex 强制指向本地：

http://127.0.0.1:15721/v1

Provider 标记：

meta.apiFormat = openai_chat

路由层执行：

• Responses → Chat 转换
• SSE 重写
• tool schema 兼容

输出再转换回 Responses

在开始前确认以下环境：

• 已安装 CC Switch（支持 3.16.0+）
• 已安装 Codex CLI（已生成 ~/.codex/config.toml）
• 已获取 DeepSeek API Key 或同类 Chat API Key

进入 CC Switch：

Codex → 添加供应商 → 选择 DeepSeek 预设

填写：

• API Key：DeepSeek Key
• 保存即可

预设已包含：

• Base URL
• 默认模型
• reasoning / thinking 参数
• Chat Completions 适配规则
• 路由自动开关标记

进入：

设置 → 路由 → 本地路由

开启：

http://127.0.0.1:15721

• 启用 Codex
• 可关闭 Claude / Gemini（可选）

完成后效果：

• Codex 不再直连 API
• 所有请求进入 CC Switch 路由层
• Key 不暴露在 Codex 配置中

操作：

1. 在 Codex Provider 中启用 DeepSeek
2. 确认提示：需要路由
3. 重启 Codex CLI

原因：

• Codex 不会热加载 config
• modelcatalogjson 需要重新生成
• /model 列表刷新依赖新进程

进入 Codex 后执行：

/model

正常情况：

• 能看到 DeepSeek 模型（如 V4 Flash / Reasoner）
• 默认模型来自 config 第一项
• 请求走 localhost:15721

CC Switch 已预置：

• DeepSeek
• Kimi
• MiniMax
• SiliconFlow

通用规则：

项目	配置
API Format	OpenAI Chat Completions
Base URL	服务根地址（不带 /chat/completions）
路由	必须开启（如果是 Chat 格式）

原因：

• 没走本地路由
• config.toml 未指向 localhost

检查：

~/.codex/config.toml

应为：

http://127.0.0.1:15721/v1

通常原因：

• Base URL 写错（不应带 /chat/completions）
• 使用了非预设配置

正确方式：使用 CC Switch 预设

原因：

• Codex 未重启
• modelcatalogjson 未刷新

解决：

• 重启 CLI
• 重新加载 provider

检查三点一致性：

• Codex Provider = DeepSeek
• 路由服务运行中
• Codex 接管已开启

模式	优点	缺点
直连 Chat API	简单	不兼容 Codex
CC Switch 路由	兼容 Codex + 多供应商	需要本地服务

工具	地址
CC Switch	https://pan.quark.cn/s/abb75497e919
Codex CLI	https://codexdown.cn/

本方案本质是：

OpenAI Responses → Chat Completions 的协议代理层

适用于所有“只提供 Chat API，但需要接入 Codex/Agents”的场景。

以上就是Codex接入DeepSeek本地路由的详细教程的详细内容，更多关于Codex接入DeepSeek本地路由的资料请关注风君子博客其它相关文章！