Codex 接入 DeepSeek 完全指南：ccswitch-deepseek 协议转换实战（2026）

Codex使用OpenAI的Responses API协议，而DeepSeek只提供Chat Completions API。两者协议不兼容，直接连不上。GitHub上的ccswitch-deepseek项目（28 Star，liuzhengming开源）解决了这个问题——它是一个本地Node.js代理，在两种协议之间做实时翻译。

一、架构原理

Codex客户端 ──Responses API──▶ localhost:11435 ──Chat API──▶ api.deepseek.com
                                   ↑
                            cswitch-deepseek
                            (协议翻译代理)

核心流程：Codex发Responses格式请求→代理转成Chat格式→发给DeepSeek→DeepSeek返回Chat格式→代理转回Responses格式→Codex收到。

二、安装部署

# 克隆仓库
git clone https://github.com/liuzhengming/ccswitch-deepseek.git
cd ccswitch-deepseek

# 安装依赖
npm install

# 配置API Key
echo "api_key=sk-your-deepseek-key" > .env

# 启动代理
npm start

启动后会显示：

========================================
  Codex DeepSeek Proxy (Node.js)
========================================
  Address:   http://127.0.0.1:11435
  Endpoint:  http://127.0.0.1:11435/v1/responses
  Upstream:  DeepSeek API
  Model:     deepseek-v4-pro
========================================

三、配置Codex

3.1 方式一：直接配置config.toml

[model_providers.deepseek]
base_url = "http://127.0.0.1:11435/v1"
wire_api = "responses"
requires_openai_auth = false
stream_idle_timeout_ms = 300000

[profiles.deepseek-v4-pro]
model_provider = "deepseek"
model_name = "deepseek-v4-pro"
context_window = 1000000
max_output_tokens = 32768

[profiles.deepseek-v4-pro.features]
tool_search = false
tool_search_always_defer_mcp_tools = false

3.2 方式二：通过CC-Switch

在CC-Switch中添加新节点：

• API地址：http://127.0.0.1:11435/v1
• 协议类型：OpenAI Compatible

四、环境变量

五、高级功能

• 工具过滤：DeepSeek限制128个工具，超出时自动按关键词优先级裁剪
• 命名空间处理：自动处理MCP工具命名空间
• DSML恢复：修复DeepSeek将工具调用以纯文本泄露的问题
• 角色映射：自动将OpenAI developer role映射为system

六、常见问题

七、总结

ccswitch-deepseek是Codex用户接入DeepSeek的必备工具。配合CC-Switch使用体验最佳。

本文链接：https://www.kkkliao.cn/?id=3898 转载需授权！