摘要随着 AI 编程助手的普及Codex 凭借其强大的代码生成能力备受开发者青睐。然而Codex 默认绑定 OpenAI 官方接口对于希望使用国产大模型如 DeepSeek的开发者来说存在一定门槛。本文将提供一份从下载到配置的完整保姆级教程通过开源工具CC-Switch作为中间转发层将 Codex 的请求无缝转发至 DeepSeek 的 OpenAI 兼容接口。文章涵盖 API Key 获取、客户端安装、供应商配置、本地路由开启及最终验证确保你能够顺利完成配置让 Codex 用上高性价比的 DeepSeek 模型。关键词Codex配置、DeepSeek API、CC-Switch、AI编程助手、API转发、本地路由一、准备工作获取 DeepSeek API Key在开始配置之前我们需要先拿到 DeepSeek 的通行证。打开 DeepSeek 开放平台https://platform.deepseek.com登录你的账号。在左侧导航栏点击API Keys然后点击创建 API Key。输入一个名称比如codex点击创建。立即复制生成的sk-开头的密钥。注意这个密钥只会完整显示一次关闭弹窗后就看不到了请务必妥善保存。安全提示API Key 是账户私有凭证不要分享给他人也不要直接写进公开的代码仓库中。二、安装 Codex 客户端Codex 有多个客户端形态CLI、桌面端、VS Code 插件它们共用同一份配置文件按下面步骤配置一次即可。2.1 下载 Codex访问 OpenAI Codex 官方产品页https://openai.com/codex/或获取页面https://chatgpt.com/codex/get-started/根据你的系统下载对应版本。你也可以通过命令行安装bash# macOS / Linux curl -fsSL https://chatgpt.com/codex/install.sh | sh # 或使用 npm npm i -g openai/codex2.2 首次运行 Codex安装完成后至少运行一次 Codex打开桌面端或执行codex命令目的是让~/.codex目录自动生成。这个目录是后续配置的基础。三、安装 CC-SwitchCC-Switch 是一款跨平台的 API 渠道管理工具用来统一转发 Codex 等 AI 编程工具的接口请求。3.1 下载安装包打开 GitHub Releases 页面https://github.com/farion1231/cc-switch/releases。根据你的系统选择对应格式系统推荐格式WindowsMSI 安装程序 / 便携版压缩包macOSZIP 压缩包 / HomebrewLinuxdeb 包 / rpm 包 / AppImage3.2 安装 CC-SwitchWindows 系统双击 MSI 安装程序跟随向导完成安装。安装路径可以自定义建议避开 C 盘。如果下载的是便携版解压后直接双击主程序即可运行。macOS 系统可以通过 Homebrew 安装也可以解压 ZIP 包把程序拖入“应用程序”文件夹。Linux 系统根据你的发行版执行对应命令bash# Debian / Ubuntu sudo apt install ./CC-Switch-*.deb # Fedora sudo dnf install ./CC-Switch-*.rpmAppImage 文件添加执行权限后直接运行即可。提示CC-Switch 完全免费开源请仅通过上述官方 GitHub Releases 页面获取不要相信任何收费的山寨网站。四、在 CC-Switch 中配置 DeepSeek安装完成后打开 CC-Switch无需注册登录直接进入主界面。4.1 切换到 Codex 面板在 CC-Switch 顶部导航栏选择Codex注意Claude 和 Codex 的配置是分开的不要选错。4.2 添加 DeepSeek 供应商点击主界面右上角的按钮新增一个 API 渠道。在弹出的面板中找到“预设供应商”位置选择DeepSeek。选择后接口参数Base URL 等会自动填入。根据你提供的截图API 请求地址应为https://api.deepseek.com默认模型建议填写deepseek-v4-flash。滚动到API Key输入框粘贴你在第一步获取的sk-开头的密钥。点击保存。4.3 开启本地路由这一步非常关键很多配置完发现 Codex 无法调用原因就是本地路由没有开启。进入 CC-Switch 的设置页面。找到本地路由选项。将路由总开关和Codex 开关都打开。text设置 └── 本地路由 ├── 路由总开关开启 └── Codex开启4.4 激活 DeepSeek 渠道回到 CC-Switch 主界面在渠道列表中选择刚刚创建的DeepSeek条目将其激活为当前使用的供应商。此时你的配置界面应该与截图一致显示“当前应用处于代理接管状态”。五、验证配置完成上述配置后需要重启 Codex 客户端才能生效。完全退出 Codex不是最小化而是彻底关闭进程。重新打开 Codex。在 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 渠道界面显示当前激活为 DeepSeek9重启 Codex 并测试能返回模型回复六、常见问题Q配置完成后 Codex 无法调用怎么办最常见的原因是本地路由没有开启。请回到 CC-Switch 的设置页面确认路由总开关和 Codex 开关都处于打开状态。此外请检查 API Key 是否填写正确以及 DeepSeek 账户是否有余额。QAPI Key 填错了怎么办如果 API Key 填错或缺失会直接导致调用失败。你可以删除现有的 DeepSeek 渠道重新添加并填入正确的 Key。QCC-Switch 中的配置需要重启 Codex 才能生效吗是的。修改配置后需要完全退出 Codex 再重新打开配置才会生效。运行时切换连接不会自动修改现有进程。七、总结本文完整梳理了从下载 Codex、获取 DeepSeek API Key、安装 CC-Switch到配置供应商、开启本地路由、验证调用的全流程。核心逻辑很简单Codex 不认 DeepSeek 的接口CC-Switch 作为中间层帮它转发和转换。只要按照步骤操作几分钟就能完成配置让 Codex 用上 DeepSeek 的强大能力。如果在配置过程中遇到问题欢迎在评论区留言交流。