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

Codex接入DeepSeek本地路由教程（使用CC Switch）

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

V1：问题分析——为什么需要本地路由

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

OpenAI Chat Completions 规范：/chat/completions

两者核心差异：

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

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

V1.1 架构设计（CC Switch 核心链路）

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

Step 1：添加 DeepSeek Provider

进入 CC Switch：

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

填写：

• API Key：DeepSeek Key
• 保存即可

预设已包含：

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

Step 2：开启本地路由（核心步骤）

进入：

设置 → 路由 → 本地路由

开启：

1）路由服务

http://127.0.0.1:15721

2）Codex 接管开关

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

完成后效果：

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

Step 3：切换供应商并重启 Codex

操作：

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

原因：

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

Step 4：验证是否生效

进入 Codex 后执行：

/model

正常情况：

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

其他 Chat 供应商接入方式

CC Switch 已预置：

• DeepSeek
• Kimi
• MiniMax
• SiliconFlow

通用规则：

常见问题排查

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

下载地址

参考说明

本方案本质是：

OpenAI Responses → Chat Completions 的协议代理层

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

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

最新评论