Codex接入DeepSeek保姆级教程：从环境配置到协议代理完整指南

OpenAI Codex作为顶级AI编程助手，默认仅支持Responses API协议，而DeepSeek仅提供Chat Completions API，两者协议不兼容导致无法直接对接。本文提供一套完整的Codex接入DeepSeek保姆级教程，通过部署本地协议转换代理（codex-bridge、cc-switch、AICodeSwitch等工具），实现Codex桌面版与CLI无缝调用DeepSeek V4系列模型。教程涵盖环境准备、API Key获取、代理部署、配置验证全流程，帮助开发者以极低成本体验Codex的强大编程能力。

Codex与DeepSeek接入背景

Codex是什么

OpenAI Codex是一款基于代理式（agentic）架构的AI编程工具，能够在终端或桌面环境中理解代码库、编辑文件、执行命令，帮助开发者高效完成编程任务。Codex采用针对软件工程优化的模型技术，通过强化学习在多种真实编程任务中训练，能够生成贴近人类编程风格的代码，精准遵循指令，并可反复执行测试直到通过。Codex具备后台计算机使用能力，能够像人类一样通过视觉识别、点击和输入自主操控电脑上的各类应用程序。

Codex提供两种主要使用形态：命令行界面（CLI）和桌面应用程序（App）。CLI版本适合直接在终端中操作，桌面版则提供更丰富的图形化交互体验和并行任务管理能力。

DeepSeek API概述

DeepSeek是国产大模型，其V4系列在代码生成与推理能力上表现出色，且API价格极具竞争力。DeepSeek API采用OpenAI兼容的Chat Completions格式，调用方式与OpenAI官方API高度相似。DeepSeek API的base_url为https://api.deepseek.com/v1，支持多种模型如deepseek-v4-pro、deepseek-v4-flash和deepseek-reasoner等。

DeepSeek API的核心特性包括：

• 对话补全（Chat Completions） ：标准的对话式API接口
• 思考模式（Thinking Mode） ：支持思维链内容通过reasoning_content参数返回
• 工具调用（Tool Calls） ：支持Function Calling，遵循JSON Schema格式要求
• FIM补全（Fill In the Middle） ：支持代码补全场景

为什么Codex不能直接接入DeepSeek

Codex与DeepSeek之间存在根本性的协议不兼容问题。Codex从v0.81.0版本开始原生使用OpenAI的Responses API协议，而DeepSeek仅提供Chat Completions API。两者在以下维度存在显著差异：

如果简单地将Codex的base_url配置为DeepSeek的API地址，直接对接会返回400错误。因此，Codex接入DeepSeek的关键在于部署一个本地协议转换代理，在中间层将Responses API请求实时翻译为Chat Completions API请求。

主流接入方案横向对比

目前Codex接入DeepSeek主要有以下几种主流方案，开发者可根据自身技术背景和使用场景选择：

各方案的核心原理相同：在本地启动一个代理服务，将Codex的Responses API请求翻译为DeepSeek的Chat Completions API请求，并将响应逆向翻译回Codex可识别的格式。

准备工作

环境要求

在执行Codex接入DeepSeek之前，请确认以下环境已就绪：

• 操作系统：Windows 10/11、macOS或Linux
• Node.js：版本≥18.0.0（如使用codex-bridge或AICodeSwitch）
• Python：版本≥3.9（如使用codex_proxy）
• Codex客户端：桌面版或CLI，推荐使用最新版本
• 网络环境：能够正常访问DeepSeek API（api.deepseek.com）

获取DeepSeek API Key

DeepSeek API Key是Codex接入DeepSeek的身份凭证，获取步骤如下：

1. 访问DeepSeek开放平台：https://platform.deepseek.com
2. 注册账号并登录
3. 进入控制台，在左侧导航栏找到「API Keys」管理模块
4. 点击「创建新的API Key」或「新建密钥」按钮
5. 填写密钥名称（建议区分开发、测试等环境）
6. 按需配置密钥权限（对话、代码等能力），遵循最小权限原则
7. 创建成功后，立即复制并妥善保存API Key（页面关闭后将无法再次查看）

安全提示：API Key具有完整的账户权限，切勿提交到公开代码仓库或分享给他人。建议通过环境变量方式配置，避免硬编码在配置文件中。

Codex接入DeepSeek详细步骤

方案一：使用codex-bridge接入（推荐）

codex-bridge是一个Node.js编写的轻量级协议转换代理，单文件零依赖，是目前最主流且稳定的Codex接入DeepSeek方案。

步骤1：确认环境

打开终端（Windows推荐Git Bash），执行以下命令验证环境：

node --version   # 应输出 v18.0.0 或更高
codex --version  # 应输出 codex-cli 0.x.x

步骤2：克隆codex-bridge并配置

git clone https://github.com/wujfeng712-ui/codex-bridge.git ~/.codex/codex-bridge
cd ~/.codex/codex-bridge

在项目目录下创建.env文件，填入DeepSeek API Key和模型配置：

DEEPSEEK_API_KEY=sk-your-key-here
DEEPSEEK_MODELS=deepseek-v4-pro,deepseek-v4-flash,deepseek-reasoner
DEFAULT_PROVIDER=deepseek
LOG_LEVEL=info

步骤3：配置Codex

编辑Codex配置文件~/.codex/config.toml：

cli_auth_credentials_store = "file"
model = "deepseek-v4-pro"
model_provider = "local_proxy"

[model_providers.local_proxy]
name = "codex-bridge"
base_url = "http://127.0.0.1:4000/v1"
wire_api = "responses"
env_key = "DEEPSEEK_API_KEY"

注意：模型名称会自动映射，例如Codex请求的gpt-5会被映射为deepseek-v4-pro，gpt-*-mini映射为deepseek-v4-flash。

步骤4：启动代理

在codex-bridge目录下启动代理服务：

node index.js

代理默认监听localhost:4000，成功启动后会输出类似以下信息：

codex-bridge starting...
Endpoint: http://127.0.0.1:4000
Provider: deepseek

步骤5：启动Codex

保持代理终端运行，另开一个终端启动Codex桌面版或CLI：

codex

Codex将自动通过本地代理连接DeepSeek API。在Codex中发起一个编程任务，即可验证接入是否成功。

方案二：使用cc-switch + CCX接入（VSCode插件场景）

如果希望在VSCode中使用Codex插件接入DeepSeek，可采用cc-switch + CCX的组合方案。整体链路为：

VSCode（Codex插件） → cc-switch → CCX → DeepSeek

步骤1：安装CCX

根据操作系统从GitHub Releases下载CCX：

• Windows：https://github.com/BenedictKing/ccx/releases
• 下载对应系统的可执行文件（如ccx-windows-amd64.exe）

将下载的exe文件移动到指定文件夹（如E:\CCX）。

步骤2：配置CCX

在CCX目录下创建.env文件：

PROXY_ACCESS_KEY=your-password-here
PORT=3000
ENABLE_WEB_UI=true
APP_UI_LANGUAGE=zh-CN

注意：PROXY_ACCESS_KEY是Codex访问CCX时使用的本地密钥，与DeepSeek API Key不同，请务必区分。

双击启动CCX可执行文件，保持命令行窗口运行。

步骤3：在CCX管理面板中添加DeepSeek渠道

浏览器访问localhost:3000进入CCX配置页面，输入.env中设置的PROXY_ACCESS_KEY登录。

在顶部协议标签中选择「Codex」协议，然后添加渠道并填入DeepSeek API Key。

步骤4：安装并配置cc-switch

cc-switch是一款跨平台桌面应用，可实现一键切换多个API与模型映射。

从cc-switch官网（https://ccswitch.io/ ）下载对应系统的安装包：

• Windows用户选择.msi后缀的安装包
• Mac用户选择.dmg安装包

安装完成后，在cc-switch中：

1. 点击设置按钮，确保Codex在首页显示
2. 点击「添加模型」，输入DeepSeek API Key后保存
3. 进入路由设置，开启本地路由

步骤5：启动Codex并验证

启动Codex桌面版，在登录界面选择第二项（使用API Key登录），输入DeepSeek API Key。成功登录后即可在Codex中看到DeepSeek模型选项，开始使用DeepSeek驱动的Codex进行编程任务。

方案三：使用AICodeSwitch接入（全平台通用）

AICodeSwitch是一个Node.js工具，在本地启动一个服务，自动接管Codex的请求并转发给DeepSeek等模型。

步骤1：安装Node.js和AICodeSwitch

确保已安装Node.js，然后全局安装AICodeSwitch：

sudo npm i -g aicodeswitch   # macOS/Linux

Windows用户可下载.msi安装包进行安装。

安装完成后验证：

aicos version

步骤2：配置并启动AICodeSwitch

AICodeSwitch会在本地起一个服务，自动进行协议转换。启动命令：

aicos start

步骤3：配置Codex指向本地代理

将Codex的base_url指向AICodeSwitch的本地服务地址，具体配置方式与codex-bridge类似，在~/.codex/config.toml中设置base_url为AICodeSwitch的监听地址。

步骤4：验证接入

启动Codex，发起一个代码生成请求，观察是否正常返回DeepSeek的响应。

验证Codex是否成功接入DeepSeek

完成配置后，可通过以下方式验证Codex接入DeepSeek是否成功：

方法一：发起简单编程任务

在Codex中输入一个明确的编程指令，例如：

写一个Python函数，计算斐波那契数列的第n项

观察Codex的响应速度和输出质量。如果响应正常且代码质量符合预期，说明接入成功。

方法二：检查代理日志

在代理终端（codex-bridge、cc-switch或AICodeSwitch）中查看日志输出，应能看到请求转发和响应返回的记录。如果出现错误日志，可根据错误信息排查。

方法三：使用curl测试

可以直接用curl测试代理是否正常工作：

curl http://127.0.0.1:4000/health   # codex-bridge健康检查

或通过代理发送测试请求，验证协议转换是否正常。

常见问题与故障排查

Q1：启动Codex后报400错误

原因：Codex直接请求了DeepSeek API而未经过代理，协议不匹配。

解决方案：确认~/.codex/config.toml中的base_url已正确指向本地代理地址（如http://127.0.0.1:4000/v1），而非直接指向DeepSeek官方API地址。

Q2：代理启动后Codex无法连接

原因：代理未正常运行，或端口被占用。

解决方案：

1. 确认代理进程正在运行，检查终端是否有错误输出
2. 检查端口是否被占用：netstat -ano | findstr 4000（Windows）或lsof -i:4000（Mac/Linux）
3. 尝试更换端口，并在Codex配置中同步修改

Q3：DeepSeek API Key无效或认证失败

原因：API Key配置错误、已过期或权限不足。

解决方案：

1. 确认.env文件中的DEEPSEEK_API_KEY值正确，注意不要有多余空格或引号
2. 登录DeepSeek开放平台确认API Key状态是否正常
3. 检查API Key是否具备调用所选模型的权限

Q4：工具调用（Function Calling）功能失效

原因：部分代理工具对工具调用的支持不完整，导致Codex的Tools功能失效。

解决方案：选择明确支持Function Calling的代理方案，如codex_proxy完整支持工具定义透传和并行工具调用合并。

Q5：响应速度慢或超时

原因：网络延迟、代理性能瓶颈或DeepSeek API限流。

解决方案：

1. 检查网络连接，确保能稳定访问DeepSeek API
2. 考虑使用国内镜像或优化网络路由
3. 检查DeepSeek API的速率限制，适当调整请求频率

Q6：思考模式（reasoning_content）兼容问题

原因：DeepSeek的思考模式返回的reasoning_content字段可能与Codex的Responses API格式不兼容。

解决方案：在代理配置中禁用思考模式，或选择支持思考模式转换的代理版本（如codex-bridge支持reasoning_content处理）。

Q7：cc-switch配置后Codex仍无法识别DeepSeek模型

原因：90%的配置失败源于遗漏了「开启本地路由」步骤。

解决方案：在cc-switch设置中确认本地路由开关已开启，并检查模型路由规则是否正确配置。

进阶配置建议

模型选择策略

DeepSeek提供多种模型版本，可根据任务类型选择：

• deepseek-v4-pro：适合复杂推理和高质量代码生成
• deepseek-v4-flash：适合快速响应和简单任务，性价比更高
• deepseek-reasoner：适合需要深度思考链的复杂问题

多模型支持

部分代理工具支持同时配置多个模型，可在Codex中根据需要切换。在DEEPSEEK_MODELS环境变量中列出所有可用模型，用逗号分隔。

代理持久化运行

如需将代理作为后台服务长期运行：

• Windows：可使用NSSM（Non-Sucking Service Manager）将代理注册为Windows服务
• macOS：可使用launchd配置开机自启
• Linux：可使用systemd或pm2管理进程

总结

本文提供的Codex接入DeepSeek保姆级教程涵盖了三种主流方案——codex-bridge、cc-switch+CCX和AICodeSwitch，分别适用于不同的使用场景和技术背景。无论选择哪种方案，核心逻辑都是在本地部署一个协议转换代理，将Codex的Responses API请求翻译为DeepSeek的Chat Completions API请求。

完成Codex接入DeepSeek后，开发者可以以极低的API成本体验Codex强大的代理式编程能力，同时将数据链路控制在可控范围内。建议从codex-bridge方案开始尝试，该方案技术成熟、文档完善，且对工具调用和思考模式的支持最为完整。

常见问题（FAQ）

Q1：Codex接入DeepSeek需要付费吗？

DeepSeek API本身按调用量计费，但价格远低于OpenAI官方API。代理工具（codex-bridge、cc-switch等）均为开源免费软件。首次使用可关注DeepSeek开放平台的新用户优惠额度。

Q2：接入后Codex的功能会受影响吗？

协议转换代理会尽可能保持功能完整性。支持工具调用（Function Calling）的代理版本可以完整保留Codex的文件读写、命令执行等核心能力。部分代理对思考模式的支持可能存在差异，建议选择明确支持所需功能的版本。

Q3：Codex CLI和桌面版都能接入DeepSeek吗？

可以。codex-bridge、codex_proxy等工具同时支持Codex CLI和桌面版。配置方法基本一致，主要区别在于CLI使用~/.codex/config.toml配置文件，桌面版可通过界面或配置文件进行设置。

Q4：接入后如何切换回OpenAI官方模型？

如果使用codex-bridge，关闭代理或修改~/.codex/config.toml中的model_provider配置即可。如果使用cc-switch或CodexSwitch，一键关闭开关即可恢复OpenAI。

Q5：国内网络环境下接入是否稳定？

DeepSeek API在国内有较好的网络可达性。如果遇到网络问题，可检查本地网络环境或考虑使用DeepSeek官方推荐的国内接入方式。

Q6：代理工具会记录我的API Key吗？

主流开源代理工具均不会记录或上传API Key。API Key通常通过环境变量或.env文件配置，仅保存在本地。建议从官方GitHub仓库下载代理工具，避免使用来路不明的版本。

Q7：Codex接入DeepSeek后代码质量如何？

DeepSeek V4系列在代码生成和推理能力上表现出色。实际效果取决于具体任务类型和模型选择，建议在实际项目中对比测试后选择最适合的模型版本。