CC Switch 实现 Codex 无缝切换 DeepSeek：本地代理协议转换实战

这类工具最值得先看的不是功能列表，而是能不能在普通环境里稳定跑起来。如果你正在用 Codex，但不想折腾 OpenAI 的账号和付费，或者网络环境不稳定，想换成 DeepSeek 这类国内模型，那 CC Switch 这个“翻译官”就是关键。它解决的问题很具体：Codex 这类工具底层调用的是 OpenAI 的特定接口（Responses API），而 DeepSeek、智谱等国内模型提供的是通用的 Chat Completions API，两者协议不兼容，直接改配置会报 404 或刷不出模型列表。CC Switch 的作用就是在本地做一个协议转换代理，让 Codex 以为自己还在和 OpenAI 对话，实际上请求被转发到了你配置的国内模型。

整个过程听起来简单，但实测时最容易卡住的地方不是配置步骤，而是几个前置条件：Codex 桌面端能否正常安装启动、CC Switch 的路由开关是否打开、以及 DeepSeek 的 API Key 是否有效且账户有余额。很多人照着教程点完了，但 Codex 里还是显示旧模型或者请求无响应，问题往往出在这几个环节。

下面我会按实际落地顺序拆一遍，从环境准备、工具安装、关键配置到问题排查，把每个环节“为什么”要这么做、以及卡住了“先看哪里”讲清楚。这套方案适合想用 Codex 功能但希望降低成本、提升国内访问速度的开发者，操作本身不复杂，全是图形界面点击，但细节决定成败。

1. 先理清工具链：Codex、CC Switch 和 DeepSeek 各自扮演什么角色

在开始安装和点击之前，先花一分钟搞清楚这三个组件的关系和边界，能避免后面很多“为什么没反应”的困惑。这不是理论，而是为了出了问题你知道该查哪一层。

1.1 Codex：你最终要用的那个“智能体”

Codex 本身是一个 AI 智能体应用，主要面向编程和自动化任务。它最核心的特点是对小白友好，能读取本地文件、操作项目、甚至控制浏览器。但它的“固执”之处在于，其底层设计只认 OpenAI 的Responses API。这意味着，如果你不进行任何干预，Codex 会固执地尝试向api.openai.com发起特定格式的请求。你想让它直接调用api.deepseek.com是行不通的，因为请求路径、数据格式、流式输出方式全都对不上。

所以，我们的目标不是“改造”Codex，而是“欺骗”它。让它以为自己还在和 OpenAI 服务器通信，但实际上请求被我们拦截并转发了。

1.2 DeepSeek：提供算力和模型的“供应商”

DeepSeek 在这里的角色是模型服务提供商。你通过其官方平台获取 API Key，并为其充值。Codex 产生的所有计算请求，最终会由 DeepSeek 的服务器来处理并返回结果。选择 DeepSeek 的主要原因通常是两个：成本和网络。相比 OpenAI 的 GPT-4 系列，DeepSeek 的 API 调用费用要低得多；同时，服务器在国内，延迟更低，稳定性更好，不需要依赖特殊的网络环境。

你需要准备的就是一个有效的 DeepSeek API Key 以及账户里的一点余额（比如充10元就能用很久）。这是整个链路能跑通的“燃料”。

1.3 CC Switch：至关重要的本地“协议转换器”与“路由管理器”

这是整个方案的核心，也是最容易出问题的环节。CC Switch 是一个开源的桌面工具，它做了两件关键事：

1. 协议转换：它在本机（通常是127.0.0.1:15721）启动一个本地代理服务。这个服务会“听懂”Codex 发来的 OpenAI Responses API 请求，将其“翻译”成标准的 Chat Completions API 格式，然后转发给 DeepSeek。收到 DeepSeek 的回复后，再“翻译”回 Codex 能理解的格式。
2. 统一管理：它提供了一个图形界面，让你可以集中管理多个 AI 工具（如 Codex, Claude Code）和多个模型供应商（如 DeepSeek, Kimi, 智谱）。你不需要分别去修改每个工具的配置文件，在 CC Switch 里点选启用即可。

关键理解：CC Switch 不是 Codex 的插件，也不是 DeepSeek 的客户端。它是一个独立的、运行在你电脑后台的“中间层”。配置成功后，Codex 的所有网络请求都会被系统路由到这个本地代理，再由它决定转发给谁。

2. 环境准备与安装：按顺序来，别跳步

我建议严格按照以下顺序操作，并在每一步完成后进行简单的验证，确保当前环节是正常的，再进入下一步。很多问题都是因为前置步骤没成功，却去折腾后面的配置导致的。

2.1 第一步：确保能下载并安装 Codex 桌面端

这是基础。你需要从 Codex 的官方网站下载安装包。由于网络原因，这一步可能需要一些耐心。如果官方渠道下载缓慢或失败，可以尝试寻找可靠的第三方镜像或使用具备稳定国际网络访问能力的环境进行下载。

安装后验证：

1. 安装完成后，先不要登录或进行任何配置。
2. 尝试启动 Codex。如果它能正常打开，显示登录界面或初始化界面，就说明安装成功。如果卡在启动画面或报错，通常与网络访问openai.com或codex.openai.com有关。首次启动时，Codex 可能需要连接其服务进行一些初始化检查。
3. 如果首次启动失败：可以尝试完全退出 Codex（包括在系统任务管理器/活动监视器中结束相关进程），然后重启。有时多试一两次即可。这一步的目的仅仅是确认 Codex 客户端本身能在你的系统上运行起来。验证完成后，完全退出 Codex，我们将在配置好一切后再启动它。

2.2 第二步：下载并安装 CC Switch

前往 CC Switch 的 GitHub Releases 页面，下载对应你操作系统的最新版本安装包（如 Windows 的.msi文件， macOS 的.dmg文件）。

重要提醒：

• 务必下载最新版本：协议转换工具迭代较快，旧版本可能无法适配最新版 Codex 或 DeepSeek 的 API 变更。如果之前安装过旧版，建议卸载后安装新版。
• 注意安装路径权限：确保你有权限在安装目录写入文件。通常使用默认安装路径即可。
• 安装后验证：安装完成后，启动 CC Switch。你应该能看到一个简洁的界面，顶部有工具切换栏（如 Codex, Claude Code），中间是供应商列表区域（初始为空）。如果能正常打开，说明 CC Switch 安装成功。

2.3 第三步：获取并准备好 DeepSeek API Key

这一步需要在浏览器中完成，与本地安装无关，可以并行操作。

1. 访问 DeepSeek 官方平台 (platform.deepseek.com)。
2. 注册账号并完成实名认证（国内平台通常需要的步骤）。
3. 最关键的一步：充值。在平台内找到充值入口，充入少量金额，例如 10 元。没有余额的 API Key 是无法成功调用的，这将是后续测试失败的最常见原因之一。
4. 在平台内找到API Keys管理页面，创建一个新的 Key。创建后立即复制保存，因为它通常只显示一次。

安全提示：这个 Key 等同于你的密码，不要泄露。我们只在 CC Switch 配置中使用它。

3. 核心配置流程：图形界面点击，但开关顺序很重要

现在三个组件都已就位，开始连接它们。CC Switch 的配置逻辑是“先开启路由，再添加供应商”，这个顺序不能乱。

3.1 开启本地路由代理

这是让 CC Switch 开始工作的“总开关”。

1. 在 CC Switch 主界面，点击右上角的设置（齿轮）图标，进入设置页面。
2. 找到「路由」选项卡。
3. 你会看到两个关键开关：
   • 路由总开关：将其打开（启用）。这个开关控制 CC Switch 的本地代理服务是否运行。
   • 工具列表：在列表中找到CODEX，确保其前面的复选框被勾选。这表示 Codex 的请求会被这个代理服务处理。
4. 配置好后，返回 CC Switch 主界面。在主界面的醒目位置，你应该能看到一个大的路由开关。将其打开（通常显示为“已开启”或绿色状态）。

此时，CC Switch 的本地代理服务（默认在127.0.0.1:15721）应该已经启动。你可以打开系统任务管理器，查看是否有cc-switch或类似名称的进程在运行。

3.2 添加并启用 DeepSeek 供应商

现在告诉 CC Switch，要把请求转发到哪里。

1. 在 CC Switch 主界面，点击「添加供应商」按钮（通常是右上角的+号）。
2. 在弹出的供应商列表中，找到「DeepSeek」并选择它。CC Switch 很友好，它会自动填充 DeepSeek 的 API 请求地址（通常是https://api.deepseek.com），你不需要手动修改。
3. 在API Key输入框中，粘贴你从 DeepSeek 平台复制的 Key。
4. （可选）你可以给这个供应商设置一个别名，方便识别。
5. 点击保存。

添加成功后，你会在主界面的供应商列表中看到 “DeepSeek”。找到它，并点击其旁边的「启用」开关（或类似按钮），使其状态变为“已启用”或“运行中”。

3.3 最终验证：重启 Codex 并测试

所有配置都是在 CC Switch 中完成的，Codex 本身无需任何设置。但正因为如此，重启生效这一步至关重要。

1. 确保 Codex 完全退出：不仅仅是关闭窗口，最好在任务管理器里确认Codex进程已结束。
2. 重新启动 Codex。
3. 观察 Codex 启动后的界面。成功的关键标志是：在 Codex 的界面左上角或者模型选择区域，原本显示 “OpenAI” 或 “GPT-4” 的地方，现在应该显示为 “DeepSeek”。
4. 进行对话测试。在输入框里发送一条简单消息，例如：“你好，请告诉我你当前使用的模型是什么？”

如果能正常收到来自 DeepSeek 的回复，那么恭喜你，整个链路已经打通。Codex 以为自己还在和 OpenAI 对话，但实际上背后是 DeepSeek 在提供服务。

4. 问题排查：当配置不生效时，按这个顺序检查

如果按照上述步骤操作后，Codex 仍然显示旧模型、无法连接或报错，不要急着重装。按照以下排查链路，从最外层到最内层，通常能快速定位问题。

4.1 现象一：Codex 启动后模型未切换，仍显示 OpenAI/GPT

排查顺序：

1. 检查 CC Switch 路由开关：回到 CC Switch 主界面，确认那个大的路由总开关是绿色开启状态。这是最常被忽略的一步。
2. 检查 Codex 路由勾选：进入 CC Switch 设置 -> 路由页面，确认CODEX前面的复选框是勾选状态。
3. 彻底重启 Codex：确保 Codex 进程完全结束（任务管理器结束任务），然后重新启动。配置变更后，Codex 必须重启才能加载新的路由设置。
4. 检查 CC Switch 版本：确认你使用的是 CC Switch 的最新版本。旧版本可能不支持最新版 Codex 的通信协议。

4.2 现象二：Codex 中显示 DeepSeek，但发送消息后报错或无响应

排查顺序：

1. 检查 DeepSeek API Key 与余额：这是最高频的问题点。登录 DeepSeek 平台，确认：
   • API Key 状态是有效的（未删除或禁用）。
   • 账户余额大于 0。即使 Key 有效，余额为 0 也会导致所有请求失败，报错信息可能是“权限不足”或“计费失败”。
2. 检查 CC Switch 供应商状态：在 CC Switch 主界面的供应商列表中，确认 DeepSeek 的状态是“运行中”或“已启用”，而不是“已停止”或“错误”。
3. 检查网络连接：确认你的电脑可以正常访问api.deepseek.com。可以尝试在浏览器中打开https://api.deepseek.com，虽然会返回 404（因为缺少正确路径），但这至少证明域名可通。如果网络不通，可能是本地代理或防火墙设置问题。
4. 查看 CC Switch 日志：CC Switch 通常有日志功能（可能在设置里或通过托盘图标打开）。查看日志中是否有关于 DeepSeek 请求的错误信息，例如“Invalid API Key”、“Insufficient balance”或网络超时等。

4.3 现象三：遇到特定的错误代码（如 404, 502, 402）

这些错误码直接指明了问题方向：

• 404 Not Found：通常是请求路径错误。这恰恰说明了没有 CC Switch 时直接配置会失败。如果配置了 CC Switch 还报 404，请检查 CC Switch 的 DeepSeek 供应商配置中，基础 URL是否正确（应为https://api.deepseek.com），并且 CC Switch 路由服务是否正常运行。
• 502 Bad Gateway：网关错误。这通常是 CC Switch 的本地代理服务运行不正常，或者 DeepSeek 服务端暂时出现问题。重启 CC Switch，并检查其进程状态。也可以稍等片刻再试，可能是服务端波动。
• 402 Payment Required：几乎可以确定是 DeepSeek 账户余额不足。请立即登录平台充值。
• Local proxy failed：这是 CC Switch 代理本身报出的错误。需要检查 CC Switch 是否与其他本地代理（如某些开发工具代理、系统代理）端口冲突（默认 15721）。尝试重启 CC Switch，或在设置中更换一个本地端口。

5. 进阶使用与稳定性建议

当单次请求测试成功后，就可以考虑更稳定、更高效的使用方式了。

5.1 多模型管理与切换

CC Switch 的强大之处在于统一管理。你可以在供应商列表中添加多个模型，例如：

• DeepSeek：通用编程和对话，性价比高。
• 智谱 GLM或Kimi：可能在某些长上下文或中文理解场景有优势。
• 其他兼容 OpenAI API 的国内模型。

在 CC Switch 中，你可以随时点击启用或禁用某个供应商。切换后，记得完全退出并重启 Codex，新的模型才会生效。这让你可以很方便地根据任务需求（代码生成、文案创作、长文档分析）切换不同的“后端大脑”。

5.2 关注资源占用与长期运行

CC Switch 作为一个常驻后台的代理服务，本身资源占用极低，一般不会影响系统性能。但在长期使用中需要注意：

• DeepSeek 费用监控：虽然单价便宜，但高频使用下仍需关注消耗。定期在 DeepSeek 平台查看用量和余额。
• Codex 的上下文消耗：Codex 在处理复杂项目、保持长对话时，会消耗大量上下文 Token。DeepSeek 对不同模型有上下文长度限制和计价方式，了解这些限制有助于优化使用方式，避免因超出限制导致请求失败或费用激增。
• 任务队列与超时：对于自动化任务，如果 Codex 执行时间很长，需注意 DeepSeek API 可能有超时限制。复杂的任务可能需要拆解。

5.3 将配置方案迁移到其他机器

如果你需要在另一台电脑上也部署这套环境，流程是完全一样的：

1. 安装 Codex。
2. 安装 CC Switch。
3. 在 CC Switch 中开启路由，勾选 Codex。
4. 添加 DeepSeek 供应商，填入有效的 API Key。
5. 重启 Codex 验证。

你的 DeepSeek API Key 可以在多台设备上使用（注意平台可能有并发限制）。CC Switch 的配置是本地的，每台机器都需要单独设置。

6. 替代方案与边界探讨

CC Switch + DeepSeek 是一个优秀的平替方案，但它并非唯一，也有其适用边界。

6.1 如果 CC Switch 下载或安装失败怎么办？

如果因为网络或系统原因无法使用 CC Switch，还有另一条技术路径：使用其他通用的 OpenAI API 兼容代理工具。例如LocalAI、OpenAI-Forward或一些支持自定义转发的开源项目。这些工具同样可以在本地搭建一个代理，将 OpenAI 格式的请求转发到 DeepSeek。不过，这类方案通常需要一定的命令行操作和配置文件的编辑能力，不如 CC Switch 的图形化界面友好。对于绝大多数用户，优先解决 CC Switch 的下载安装问题是更直接的选择。

6.2 此方案的局限性

了解边界能避免不切实际的期望：

1. 功能完整性：CC Switch 主要解决协议转换和路由问题。但 Codex 某些深度依赖 OpenAI 特定功能或最新模型特性的高级功能（例如某些特定的工具调用格式），在转换后可能无法 100% 正常工作。对于核心的代码生成、问答、文件操作，体验基本一致。
2. 延迟与稳定性：虽然直连国内服务器延迟更低，但最终体验也取决于 DeepSeek 服务本身的稳定性和当前负载。高峰期可能出现响应变慢的情况。
3. 模型能力差异：DeepSeek 的能力与 GPT-4 等模型各有千秋。在极其复杂的逻辑推理或非常小众的技术领域，输出结果可能会有差异。但对于日常开发辅助、脚本编写、问题解答，DeepSeek 完全能够胜任。

6.3 什么时候应该考虑这个方案？

我建议在以下场景优先考虑此方案：

• 成本敏感：希望以更低成本使用 Codex 的自动化能力。
• 网络环境受限：访问国际服务不稳定或速度慢。
• 数据合规要求：希望代码、业务数据等在国内服务器流转。
• 多模型切换需求：需要灵活在 DeepSeek、GLM、Kimi 等模型间切换。

而对于追求与 OpenAI 官方生态完全一致、需要使用最新推出的专属功能、或对特定模型有强依赖的用户，直接使用原版 OpenAI 服务仍是更稳妥的选择。

我个人更建议先把单任务跑通，确保 Codex 能稳定连接 DeepSeek 并完成几次完整对话。之后，可以尝试用它处理一个本地小项目，观察其在真实工作流中的表现。这个方案真正落地时，最该盯住的不是功能列表，而是每次启动时 CC Switch 的路由开关、DeepSeek 的账户余额，以及 Codex 界面左上角那个小小的模型标识。