Openai

关注公众号 jb51net

关闭
AI > Openai >

使用CC-Switch将DeepSeek接入Codex的完整配置教程

脚本之家

摘要

随着 AI 编程助手的普及，Codex 凭借其强大的代码生成能力备受开发者青睐。然而，Codex 默认绑定 OpenAI 官方接口，对于希望使用国产大模型（如 DeepSeek）的开发者来说存在一定门槛。本文将提供一份从下载到配置的完整保姆级教程，通过开源工具 CC-Switch 作为中间转发层，将 Codex 的请求无缝转发至 DeepSeek 的 OpenAI 兼容接口。文章涵盖 API Key 获取、客户端安装、供应商配置、本地路由开启及最终验证，确保你能够顺利完成配置，让 Codex 用上高性价比的 DeepSeek 模型。

一、准备工作：获取 DeepSeek API Key

在开始配置之前，我们需要先拿到 DeepSeek 的通行证。

  1. 打开 DeepSeek 开放平台（https://platform.deepseek.com），登录你的账号。
  2. 在左侧导航栏点击 API Keys，然后点击 创建 API Key。
  3. 输入一个名称（比如 codex），点击创建。
  4. 立即复制生成的 sk- 开头的密钥。注意：这个密钥只会完整显示一次，关闭弹窗后就看不到了，请务必妥善保存。

安全提示：API Key 是账户私有凭证，不要分享给他人，也不要直接写进公开的代码仓库中。

二、安装 Codex 客户端

Codex 有多个客户端形态（CLI、桌面端、VS Code 插件），它们共用同一份配置文件，按下面步骤配置一次即可。

2.1 下载 Codex

访问 OpenAI Codex 官方产品页（https://openai.com/codex/）或获取页面（https://chatgpt.com/codex/get-started/），根据你的系统下载对应版本。你也可以通过命令行安装：

# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# 或使用 npm
npm i -g @openai/codex

2.2 首次运行 Codex

安装完成后，至少运行一次 Codex（打开桌面端或执行 codex 命令），目的是让 ~/.codex 目录自动生成。这个目录是后续配置的基础。

三、安装 CC-Switch

CC-Switch 是一款跨平台的 API 渠道管理工具，用来统一转发 Codex 等 AI 编程工具的接口请求。

3.1 下载安装包

打开 GitHub Releases 页面：https://github.com/farion1231/cc-switch/releases。根据你的系统选择对应格式：

系统推荐格式
WindowsMSI 安装程序 / 便携版压缩包
macOSZIP 压缩包 / Homebrew
Linuxdeb 包 / rpm 包 / AppImage

3.2 安装 CC-Switch

Windows 系统：双击 MSI 安装程序，跟随向导完成安装。安装路径可以自定义，建议避开 C 盘。如果下载的是便携版，解压后直接双击主程序即可运行。

macOS 系统：可以通过 Homebrew 安装，也可以解压 ZIP 包，把程序拖入“应用程序”文件夹。

Linux 系统：根据你的发行版执行对应命令：

# Debian / Ubuntu
sudo apt install ./CC-Switch-*.deb
# Fedora
sudo dnf install ./CC-Switch-*.rpm

AppImage 文件添加执行权限后直接运行即可。

提示：CC-Switch 完全免费开源，请仅通过上述官方 GitHub Releases 页面获取，不要相信任何收费的山寨网站。

四、在 CC-Switch 中配置 DeepSeek

安装完成后打开 CC-Switch，无需注册登录，直接进入主界面。

4.1 切换到 Codex 面板

在 CC-Switch 顶部导航栏选择 Codex（注意：Claude 和 Codex 的配置是分开的，不要选错）。

4.2 添加 DeepSeek 供应商

  1. 点击主界面右上角的 + 按钮，新增一个 API 渠道。
  2. 在弹出的面板中，找到“预设供应商”位置，选择 DeepSeek。
  3. 选择后，接口参数（Base URL 等）会自动填入。根据你提供的截图，API 请求地址应为 https://api.deepseek.com，默认模型建议填写 deepseek-v4-flash。
  4. 滚动到 API Key 输入框，粘贴你在第一步获取的 sk- 开头的密钥。
  5. 点击 保存。

4.3 开启本地路由

这一步非常关键，很多配置完发现 Codex 无法调用，原因就是本地路由没有开启。

  1. 进入 CC-Switch 的 设置 页面。
  2. 找到 本地路由 选项。
  3. 将 路由总开关 和 Codex 开关 都打开。
设置
└── 本地路由
    ├── 路由总开关（开启）
    └── Codex（开启）

4.4 激活 DeepSeek 渠道

回到 CC-Switch 主界面，在渠道列表中选择刚刚创建的 DeepSeek 条目，将其激活为当前使用的供应商。此时，你的配置界面应该与截图一致，显示“当前应用处于代理接管状态”。

五、验证配置

完成上述配置后，需要重启 Codex 客户端才能生效。

  1. 完全退出 Codex（不是最小化，而是彻底关闭进程）。
  2. 重新打开 Codex。
  3. 在 Codex 中随便提一个问题，比如“写一个 Python 快速排序”，看看是否能正常返回 DeepSeek 的回复。

如果一切正常，恭喜你，Codex 现在已经由 DeepSeek 驱动了！

自检清单

你可以对照下表快速检查每一步是否完成：

序号待办事项自检标准
1申请 DeepSeek API Key拿到 sk- 开头的字符串
2下载 CC-Switch 安装包安装包格式与系统匹配
3完成 CC-Switch 安装能正常打开主界面
4新建 API 渠道渠道列表出现新条目
5选择 DeepSeek 供应商接口参数自动填入
6填写并保存 API Key提示保存成功
7开启本地路由两个开关总开关与 Codex 开关均为开启
8激活 DeepSeek 渠道界面显示当前激活为 DeepSeek
9重启 Codex 并测试能返回模型回复

六、常见问题

Q：配置完成后 Codex 无法调用怎么办？
最常见的原因是本地路由没有开启。请回到 CC-Switch 的设置页面，确认路由总开关和 Codex 开关都处于打开状态。此外，请检查 API Key 是否填写正确，以及 DeepSeek 账户是否有余额。

Q：API Key 填错了怎么办？
如果 API Key 填错或缺失，会直接导致调用失败。你可以删除现有的 DeepSeek 渠道，重新添加并填入正确的 Key。

Q：CC-Switch 中的配置需要重启 Codex 才能生效吗？
是的。修改配置后，需要完全退出 Codex 再重新打开，配置才会生效。运行时切换连接不会自动修改现有进程。

七、总结

本文完整梳理了从下载 Codex、获取 DeepSeek API Key、安装 CC-Switch，到配置供应商、开启本地路由、验证调用的全流程。核心逻辑很简单：Codex 不认 DeepSeek 的接口，CC-Switch 作为中间层帮它转发和转换。只要按照步骤操作，几分钟就能完成配置，让 Codex 用上 DeepSeek 的强大能力。如果在配置过程中遇到问题，欢迎在评论区留言交流。

以上就是使用CC-Switch将DeepSeek接入Codex的完整配置教程的详细内容，更多关于CC-Switch将DeepSeek接入Codex的资料请关注脚本之家其它相关文章！