【保姆级教程】桌面端 Codex 配置 DeepSeek 模型完全指南（使用 ccSwitch）
本文详细介绍如何在 OpenAI Codex 桌面端中，通过 ccSwitch 工具配置使用 DeepSeek 模型，实现低成本、高性能的 AI 编程体验。
目录
一、前言
1.1 什么是桌面端 Codex？
桌面端 Codex 是 OpenAI 推出的独立桌面应用程序，提供了图形化界面，让 AI 编程体验更加直观和便捷。
主要功能：
- 📝 代码生成与补全
- 💬 对话式编程交互
- 🔍 代码解释与重构
- 🐛 Bug 分析与修复
- 📁 项目级代码理解
1.2 什么是 ccSwitch？
ccSwitch 是一款配置切换工具，可以方便地管理和切换各种 AI 编码工具（如 Codex、Cursor、Continue 等）的 API 配置，支持快速切换不同的模型提供商。
ccSwitch 的优势：
- ✅ 图形化界面，配置简单
- ✅ 一键切换不同模型
- ✅ 支持多个配置方案
- ✅ 配置导入导出，方便迁移
1.3 为什么要配置 DeepSeek？
| 对比项 | GPT-4o | DeepSeek-V3 |
|---|---|---|
| 价格 | 较贵 | 极其便宜 |
| 中文理解 | 一般 | 优秀 |
| 代码能力 | 强 | 很强 |
| 响应速度 | 中等 | 快 |
配置 DeepSeek 后，你可以：
✅ 降低成本：DeepSeek 价格约为 GPT-4o 的 1/10
✅ 中文体验：获得更好的中文编程辅助体验
✅ 同等能力：享受同样强大的代码生成能力
二、环境准备
2.1 安装桌面端 Codex
第一步：下载安装包
访问 OpenAI 官网下载桌面端 Codex：
https://openai.com/codex
第二步：安装程序
- Windows：双击
.exe安装包，按提示完成安装 - Mac：将
.dmg中的应用拖入 Applications 文件夹
第三步：登录账号
- 打开 Codex 桌面端
- 使用 OpenAI 账号登录（如没有账号需先注册）
2.2 安装 ccSwitch
第一步：下载 ccSwitch
从官方渠道获取 ccSwitch：
https://github.com/anthropics/ccSwitch/releases
💡 或者在 GitHub 搜索 “ccSwitch” 找到最新版本
第二步：安装 ccSwitch
- Windows：运行安装程序
- Mac：拖入 Applications 文件夹
第三步：启动 ccSwitch
安装完成后，启动 ccSwitch 应用。
2.3 获取 DeepSeek API Key
第一步：注册 DeepSeek 账号
- 访问 DeepSeek 官网
- 点击右上角「注册」按钮
- 使用手机号或邮箱完成注册
第二步：获取 API Key
- 登录后进入 API Keys 管理页面
- 点击「创建 API Key」
- 输入 Key 的名称（如：codex-use）
- 点击「确认」创建
第三步：复制并保存 API Key
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️ 重要提醒：
- API Key 只会显示一次，请立即复制保存
- 不要将 API Key 分享给他人或提交到代码仓库
- 建议保存在密码管理器中
第四步：确认余额
- 进入「费用」页面
- 确认账户有可用余额
- 新用户通常有免费额度，足够测试使用
三、使用 ccSwitch 配置 DeepSeek
3.1 打开 ccSwitch
- 启动 ccSwitch 应用
- 你应该能看到 ccSwitch 的主界面
3.2 添加 DeepSeek 配置
第一步：点击「添加配置」或「+」按钮
在 ccSwitch 主界面找到添加配置的入口。
第二步：选择工具类型
在列表中找到并选择 Codex（或 OpenAI Codex）。
第三步：填写配置信息
如果是选择deepseek供应商只需要填写API Key即可
| 配置项 | 填写内容 |
|---|---|
| 配置名称 | DeepSeek（或你喜欢的名字） |
| API Key | sk-xxxxxxxxxxxxxxxxxxxxxxxx（你获取的 Key） |
| Base URL | https://api.deepseek.com |
| 模型 | deepseek-v4-pro |
第四步：保存配置
点击「保存」或「确认」按钮保存配置。
3.3 切换到 DeepSeek 模型
第一步：在 ccSwitch 中选择配置
在配置列表中，点击你刚创建的 DeepSeek 配置，将其设为当前激活配置。
第二步：重启 Codex
关闭并重新打开 Codex 桌面端，使配置生效。
第三步：验证配置
在 Codex 中发送一条测试消息：
你好，请告诉我你现在使用的是什么模型？
如果回复正常，说明配置成功！
3.4 开启路由模式（重要！）
⚠️ 注意：使用 DeepSeek 时必须开启 ccSwitch 的路由模式，否则请求可能无法正常转发！
什么是路由模式？
路由模式是 ccSwitch 的核心功能之一，它会将 Codex 的 API 请求自动转发到你配置的 DeepSeek 服务器，确保请求能够正确路由到 DeepSeek 的 API。
开启步骤：
第一步：在 ccSwitch 中找到路由模式开关
在 ccSwitch 主界面或设置中，找到「路由模式」或「Route Mode」选项。
第二步：开启路由模式
- 将路由模式开关设置为 开启 状态
- 确保开关显示为已激活（通常是绿色或高亮状态）
第三步：确认路由配置
开启路由模式后，检查以下信息：
| 配置项 | 正确值 |
|---|---|
| 路由目标 | DeepSeek |
| 转发地址 | `https://api.deepseek.com |
| 状态 | 已激活 ✅ |
为什么必须开启路由模式？
- 不开启路由模式时，Codex 的请求可能仍会发送到 OpenAI 的服务器
- 路由模式确保所有请求都被正确拦截并转发到 DeepSeek
- 这是使用第三方 API 的关键配置，不可或缺
验证路由模式是否生效：
- 在 Codex 中发送测试消息
- 查看 ccSwitch 的日志或请求记录
- 确认请求显示为已转发到 DeepSeek
💡 提示：如果配置后仍然无法正常使用，请首先检查路由模式是否已开启！
五、常见问题 FAQ
Q1: 配置后 Codex 还是用 GPT 模型？
可能原因：
- ccSwitch 配置未激活
- Codex 未重启
- 属于正常情况
解决方法：
- 确认 ccSwitch 中 DeepSeek 配置已激活（高亮显示）
- 完全关闭 Codex 后重新打开
- 检查 ccSwitch 是否显示配置已生效
Q2: 提示 “API key not valid”？
可能原因：
- API Key 格式错误（必须以
sk-开头） - API Key 已过期或被删除
- 复制时多了空格
解决方法：
- 重新登录 DeepSeek 官网获取新的 API Key
- 在 ccSwitch 中更新配置
- 确认 Key 完整且无多余字符
Q3: 连接超时或请求失败？
可能原因：
- 网络不通
- Base URL 配置错误
解决方法：
- 检查网络连接
- 确认 Base URL 为：
https://api.deepseek.com,就是选择供应商默认配置的地址。如果在ccWitch中修改了配置，ccWitch也需要重启否知配置不生效 - 如需代理，在系统网络设置中配置
Q4: ccSwitch 找不到 Codex 选项？
可能原因：
- ccSwitch 版本过旧
- 未安装 Codex
解决方法：
- 更新 ccSwitch 到最新版本
- 确认已安装 Codex 桌面端
- 重启 ccSwitch 后再试
Q5: 配置后没有效果？
可能原因：
- 配置未保存
- 需要重启 Codex和ccSwitch
解决方法：
- 在 ccSwitch 中确认配置已保存
- 完全退出 Codex 并重新打开
- 检查 ccSwitch 中配置是否显示为激活状态
Q6: 在codex中添加供应商找不到deepseek？
可能原因：
- ccSwitch 版本太旧
解决方法：
- 更新版本
Q7: 模型返回502代理请求未正确转发？
可能原因：
- 在codex或者ccSwitch中需要下载什么东西
解决方法：
- 开启魔法再次请求一次，成功后，下次直接使用即可
Q8: cc-switch切换其他模型再切回去不能使用？
可能原因：
- ccSwitch配置没有修改
解决方法：
- 把ccSwitch和codex都重启一下
八、总结
通过本文的教程，你已经成功使用 ccSwitch 将桌面端 Codex 接入 DeepSeek 模型。
配置回顾：
✅ 安装了桌面端 Codex
✅ 安装了 ccSwitch 配置工具
✅ 获取了 DeepSeek API Key
✅ 使用 ccSwitch 完成配置
✅ 验证配置成功生效
DeepSeek 的优势：
✅ 成本低：价格约为 GPT-4o 的 1/10
✅ 中文强：对中文理解更准确
✅ 速度快：响应速度快，开发体验好
✅ 能力全：代码能力不输 GPT 系列
参考资料
本文首发于 CSDN，转载请注明出处。
如果这篇文章对你有帮助，请 👍 点赞 + ⭐ 收藏 支持一下！
有问题欢迎在评论区交流讨论。
汇聚全球AI编程工具，助力开发者即刻编程。
更多推荐
9
0- 0
已为社区贡献1条内容
所有评论(0)