30款热门AI模型一站整合DeepSeek/GLM/Qwen 随心用限时 5 折。 点击领海量免费额度1. 先搞清楚 Codex、CC Switch 和 DeepSeek 到底是什么关系如果你正在尝试让 Codex 使用 DeepSeek 的模型却卡在下载 CC Switch 或 Codex 上或者遇到各种 404、502 错误那这篇文章就是为你准备的。核心问题其实很明确Codex 官方只支持 OpenAI 的 Responses API而 DeepSeek 等国内主流模型提供的是 OpenAI Chat Completions API两者协议不兼容直接配置会报错。CC Switch 这个工具本质上是一个本地代理和协议转换器它解决了这个“语言不通”的问题。很多人一上来就去找 Codex 或者各种离线安装包这其实走偏了。Codex 是一个非官方的修改版而 CC Switch 是一个独立的、更通用的路由工具。对于只想稳定使用 DeepSeek 等国产模型的人来说CC Switch 是更稳妥、更接近官方体验的方案。它不需要你修改 Codex 的代码而是通过一个本地服务在请求发出去之前和收到响应之后完成协议格式的转换。所以整个流程的核心链路是Codex发出 Responses 请求 - CC Switch 本地路由转换为 Chat 请求发给 DeepSeek - DeepSeek API处理并返回 Chat 响应 - CC Switch 本地路由转换回 Responses 格式 - Codex正常接收并显示。理解了这一点后面所有的配置和排错就都有了方向。2. 环境准备别急着下载先确认这三样东西在动手之前确保你的环境已经具备了最基础的条件。很多“无法获取模型列表”或“Local Proxy Failed”的错误根源都在于前置步骤没做对。2.1 安装并运行过 Codex CLI这是最容易被忽略的一步。CC Switch 需要读取和修改 Codex 的配置文件通常是~/.codex/config.toml。如果 Codex CLI 从未在你的机器上运行过这个目录和配置文件可能根本不存在。你需要做的确保已经通过官方渠道如pip install codex-cli安装了 Codex CLI。在终端中至少运行一次codex命令。即使没有有效的 API 配置它也会初始化配置文件目录。确认~/.codex/目录在 Windows 上是C:\Users\你的用户名\.codex\已经生成。2.2 获取一个有效的 DeepSeek API Key没有 API Key一切免谈。你需要去 DeepSeek 的官方平台注册并获取。注意点Base URLDeepSeek 官方的 OpenAI 兼容接口地址是https://api.deepseek.com。记住这个但在 CC Switch 里你通常不需要手动填写因为内置预设已经包含了。额度确认你的账户有可用的额度或免费额度。网络可达性确保你的网络环境能够正常访问api.deepseek.com。这是后续所有“无需良好网络”方案的前提因为最终请求还是要发到 DeepSeek 服务器的。2.3 下载并安装 CC Switch这是关键一步。不要去搜那些来路不明的“CC Switch Windows 安装包”或“codex离线安装包”最安全的方式是从其官方 GitHub 仓库发布页下载。操作步骤访问 CC Switch 的 GitHub 仓库例如farion1231/cc-switch。进入Releases页面。根据你的操作系统Windows/macOS/Linux下载最新的稳定版安装包或可执行文件。完成安装。Windows 通常是.exe安装程序macOS 是.dmgLinux 可能是.AppImage或压缩包。安装完成后先打开 CC Switch 应用确保它能正常启动界面能加载出来。如果这一步就卡住可能是系统权限或运行库问题。3. 核心配置四步打通 Codex 到 DeepSeek 的链路环境就绪后按照下面的顺序配置不要跳步。我建议你关闭其他可能占用本地端口的程序比如其他代理工具避免冲突。3.1 第一步在 CC Switch 中添加 DeepSeek 作为提供商打开 CC Switch 应用界面顶部通常会有多个标签页找到并切换到“Codex”标签页。点击界面右上角的“”或“Add Provider”按钮。在弹出的提供商列表中寻找并选择“DeepSeek”预设Preset。这是最重要的一步使用预设能避免绝大多数因 URL 格式错误导致的问题。在配置界面中唯一需要你手动输入的就是你的DeepSeek API Key。其他如 Base URL、API 格式等预设已经帮你填好并且会自动勾选“Needs Local Routing”需要本地路由。保存这个提供商配置。注意不要自己手动拼接一个https://api.deepseek.com/chat/completions这样的地址填到别的地方。CC Switch 的 DeepSeek 预设知道正确的地址格式手动填写反而容易出错。3.2 第二步启用并配置本地路由服务在 CC Switch 中找到设置Settings然后进入路由Routing页面。找到“本地路由Local Routing”板块打开主开关启动本地路由服务。默认它会监听127.0.0.1:15721。如果这个端口被占用你需要先解决冲突或修改端口。在路由服务下方你会看到一个应用列表如 Codex, Claude, Gemini 等。确保Codex 旁边的开关是打开状态。这意味着 CC Switch 会接管 Codex 的请求将其导向本地路由。启用后CC Switch 会自动修改你的~/.codex/config.toml文件将 Codex 的 API 端点指向http://127.0.0.1:15721/v1。你的真实 API Key 保存在 CC Switch 内部不会直接暴露在这个配置文件里更安全。3.3 第三步切换提供商并重启 Codex回到 CC Switch 的“Codex”标签页在你刚刚添加的 DeepSeek 提供商卡片上点击“启用Enable”。如果配置正确你可能会看到“Needs Routing”的标记这说明该提供商必须依赖正在运行的路由服务。关键操作重启你的 Codex 终端会话。无论是你正在运行codex命令的终端窗口还是集成在 VSCode 等编辑器中的 Codex都需要重启。因为 Codex 进程在启动时读取了旧的配置需要重启以加载新的路由地址和模型目录。3.4 第四步验证连接是否成功重启 Codex 后进行快速验证在 Codex 交互界面尝试使用/model命令。你应该能看到可用的模型列表其中包含来自 DeepSeek 的模型如deepseek-chat。Codex 应用可能默认选中列表中的第一个模型。发送一个简单的测试提示例如“Hello”。观察 CC Switch 的界面。通常在“路由”页面或“请求日志”中你应该能看到刚刚发出的请求记录状态码应为 200。同时DeepSeek 平台上的 API 使用量也应该相应增加。如果/model命令看不到 DeepSeek 模型或者发送请求后 CC Switch 没有日志说明链路还没通需要进入排查环节。4. 高频错误排查从报错信息定位问题根源当事情不按预期发展时别慌。根据错误信息按以下顺序检查。4.1 错误“Unexpected status 404 Not Found” 或 “/responses endpoint not found”这个错误直接指向路由配置问题。可能原因 1本地路由服务未运行。回到 CC Switch 的设置 路由页面确认“本地路由”的主开关是绿色的运行中。可能原因 2Codex 的路由开关未启用。在同一页面确认 Codex 应用旁边的开关已打开。可能原因 3Codex 配置文件未被正确修改。手动检查~/.codex/config.toml文件看其中live_config相关的url字段是否指向http://127.0.0.1:15721/v1。如果不是可能是 CC Switch 没有写入权限或者配置文件被其他程序锁定。可能原因 4端口冲突。确认15721端口没有被其他程序如另一个 CC Switch 实例、其他本地代理占用。可以在终端用netstat -ano | findstr :15721(Windows) 或lsof -i :15721(macOS/Linux) 命令检查。4.2 错误“Unexpected status 502 Bad Gateway”502 错误通常意味着本地路由服务运行正常但它转发请求到上游 DeepSeek 时失败了。可能原因 1DeepSeek API Key 错误或过期。在 CC Switch 的 DeepSeek 提供商设置中仔细检查并重新输入 API Key。去 DeepSeek 后台确认密钥有效且有余量。可能原因 2网络问题。本地路由服务无法访问api.deepseek.com。尝试在终端用curl https://api.deepseek.com测试连通性。如果被阻断你需要解决你的网络出口问题。CC Switch 本身不提供网络加速功能它只是一个本地协议转换器。可能原因 3CC Switch 中的 Base URL 配置错误。如果你没有使用 DeepSeek 预设而是手动创建了自定义提供商请确保“Base URL”填写的是https://api.deepseek.com而不是https://api.deepseek.com/chat/completions。后者是错误的。4.3 问题/model命令不显示 DeepSeek 模型列表首要操作重启 Codex。在 CC Switch 中保存提供商配置后CC Switch 会生成一个cc-switch-model-catalog.json文件并更新 Codex 配置指向它。但已经运行的 Codex 进程不会自动重新加载这个目录必须重启。检查 CC Switch 中的提供商状态确保 DeepSeek 提供商是“已启用”状态并且没有报错提示。查看 CC Switch 日志CC Switch 应用通常有日志窗口或日志文件查看里面是否有关于生成模型目录的错误信息。4.4 问题请求看起来成功了但 Codex 回复异常或空白检查流式响应DeepSeek 默认可能返回流式响应SSE而 CC Switch 的路由需要正确转换这些流事件。确保 CC Switch 是最新版本以兼容最佳的协议转换。测试简单提示先用一个非常简单的非代码提示如“写一首诗”测试排除因复杂代码上下文导致的问题。查看原始响应在 CC Switch 的高级设置或调试模式中有时可以查看转发前后的请求和响应体确认转换过程是否正常。5. 进阶与替代方案关于 Codex 和其他模型你可能也听说过 Codex。这里明确一下区别和选择建议CC Switch vs CodexCC Switch是一个独立的中介路由工具。它保持 Codex 官方客户端不变通过外部代理实现协议兼容。优点是相对稳定不影响 Codex 本体升级同时支持将路由功能用于其他类似应用如 Claude CLI。缺点是多了一个需要常驻运行的服务。Codex是一个修改了官方 Codex CLI 源代码的分支版本直接集成了对多种 API 格式包括 Chat Completions的支持。优点是可能更一体化无需额外运行路由服务。缺点是依赖于特定分支的维护可能滞后于官方更新且安装可能需要从特定渠道下载安全性需自行甄别。选择建议如果你是追求稳定、最小化变动的用户或者希望一个路由工具管理多个 AI 助手客户端选择 CC Switch。如果你不介意使用非官方修改版且希望最简化的部署一个二进制文件搞定可以尝试寻找Codex的可靠发布渠道但务必注意安全风险。配置其他国产模型CC Switch 的魅力在于其通用性。除了 DeepSeek对于 Kimi、MiniMax、SiliconFlow 等同样提供 OpenAI Chat Completions 格式的国产模型配置流程完全一样在 CC Switch 的 Codex 提供商列表里点击“添加”。寻找对应的模型预设如 Kimi、MiniMax。如果没有预设选择“自定义”。在自定义配置中填写正确的API Key、Base URL例如 Kimi 是https://api.moonshot.cn/v1并在API Format下拉菜单中选择“OpenAI Chat Completions (requires routing)”。保存并启用后续步骤与 DeepSeek 完全相同。6. 生产环境下的注意事项与优化思路如果你打算长期使用此方案或者用于稍正式的场景有几个点需要额外关注。6.1 稳定性与守护进程CC Switch 的本地路由服务是一个需要长期运行的后台进程。在个人电脑上你可以设置为开机自启。在生产服务器上你需要用系统级服务如 systemd 或 supervisor来守护这个进程确保它崩溃后能自动重启并能记录日志。6.2 模型切换与管理Codex 官方应用对多模型切换的支持可能比较弱。CC Switch 虽然能提供模型目录但最终在 Codex 里使用哪个模型可能取决于配置。一种常见的做法是在 CC Switch 中为不同用途创建多个提供商如deepseek-coder用于代码deepseek-chat用于对话然后在 CC Switch 中切换启用哪个提供商并重启 Codex 来生效。6.3 监控与日志CC Switch 日志定期查看 CC Switch 的日志关注是否有频繁的认证失败401、速率限制429或网关错误502这有助于提前发现密钥问题或网络波动。DeepSeek 控制台定期登录 DeepSeek 平台查看 API 使用量和费用情况设置用量告警。网络监控如果部署在服务器监控服务器到api.deepseek.com的网络延迟和丢包率。6.4 关于“无需良好网络”这个说法需要辩证看待。CC Switch 作为本地软件其运行和与 Codex 的通信127.0.0.1不依赖外部网络这很稳定。但是它最终发出的请求必须要能到达 DeepSeek 的服务器。如果你的网络环境对api.deepseek.com的访问不稳定或被限制那么问题依然存在。CC Switch 本身不解决国际网络连通性问题。在这种情况下你需要自行确保本地到目标 API 服务器的网络通道是可靠的。整个配置的核心其实就是理解“协议转换”这个中间层的作用。一旦把 CC Switch 这个本地路由服务配置好它就像一个透明的翻译官让只懂 OpenAI Responses 方言的 Codex能和讲 OpenAI Chat 方言的 DeepSeek 流畅对话。剩下的问题大多就是检查这个“翻译官”是否在岗服务运行、沟通渠道是否畅通网络和端口、以及翻译所需的“词典”是否正确API Key 和 Base URL。按照上面的步骤和排查思路大部分问题都能定位解决。 30款热门AI模型一站整合DeepSeek/GLM/Qwen 随心用限时 5 折。 点击领海量免费额度