Skip to content

Claude Desktop 接入 DeepSeek-V4 完整教程:CC Desktop Switch 一行配置都不用改

适用版本:Claude Desktop(Windows) · 关键词:Claude Cowork 配置、CC Desktop Switch、第三方模型接入

Claude Desktop 原生不直接支持第三方模型,需要借助 CC Desktop Switch 做本地代理桥接。本文用 DeepSeek-V4 为例,演示完整 Claude Cowork 配置流程——从下载到排错,每一步都有截图。

你真正需要这篇文章的原因:Claude Cowork 配置过程中最常见的问题是 CC Switch 接管不生效——URL 仍然是 DeepSeek 官方地址而非本地 127.0.0.1。本文最后一节专讲这个坑怎么填。


📑 本文目录


前置准备

开始 Claude Cowork 配置前,请准备好以下两项:


第一步:安装 Claude Desktop

Claude Desktop 下载安装界面截图

安装完成后启动,点击「Get Started」进入主界面。安装过程此处略过。


第二步:完全退出 Claude Desktop

⚠️ 关键步骤:在配置 CC Desktop Switch 之前,必须确保 Claude Desktop 已完全退出。否则后续配置写入可能被运行中的进程覆盖或忽略。

右键系统托盘中的 Claude 图标,选择「退出」,或在任务管理器中确认 Claude 进程已结束。


第三步:用 CC Desktop Switch 配置 DeepSeek

CC Desktop Switch 是 Claude Cowork 配置的核心工具。它的作用是:将第三方模型提供商(如 DeepSeek)的配置写入 Claude Desktop,并通过本地代理(127.0.0.1)接管请求路由——这样 Claude Desktop 就能通过本地回程访问 DeepSeek 模型,无需手动编辑任何配置文件。

3.1 添加 DeepSeek 提供商

打开 CC Desktop Switch,在提供商列表中选择或添加 DeepSeek

CC Desktop Switch 提供商列表,选择 DeepSeek

确认添加 DeepSeek 为第三方模型提供商

3.2 填写 API Key

填入你在 DeepSeek 控制台创建的 API Key,其余字段保持默认值即可。

填写 DeepSeek API Key,其他字段保持默认

3.3 开启本地路由并接管 Claude Desktop

选择 DeepSeek 并启动。然后打开 CC Desktop Switch 左上角设置菜单,开启「Claude 路由」开关——这一步会让 CC Switch 接管 Claude Desktop 的模型请求,通过 127.0.0.1 本地代理转发到 DeepSeek。

选择 DeepSeek 并启动 CC Switch

在设置中开启 Claude 路由功能

Claude 路由开启成功后的界面状态


第四步:验证配置并排错

4.1 正常情况

重新打开 Claude Desktop,此时 URL 与 API Key 已由 CC Desktop Switch 自动配置完成,无需手动填写。在 Claude Desktop 的模型选择菜单中应能看到 DeepSeek-V4,即可正常使用。

Claude Desktop 重新打开后 DeepSeek 配置成功的界面

4.2 ⚠️ 常见问题:CC Switch 接管未生效

这是 Claude Cowork 配置中最容易踩的坑。 打开 Claude Desktop 后,如果发现模型配置中的 URL 仍显示为 DeepSeek 官方地址(如 api.deepseek.com),而非 127.0.0.1 本地回程路由,说明 CC Desktop Switch 的代理接管未生效。

根本原因:Claude Desktop 在 CC Switch 写入配置之前已经生成过第三方配置缓存;CC Switch 写入的新配置未能覆盖旧缓存。

解决方法:重置 Claude Desktop

  1. 打开 Windows 设置
  2. 搜索「Claude」
  3. 点击「高级选项」→ 选择「重置」

Windows 设置中搜索 Claude,进入高级选项执行重置

重置完成后重新打开 Claude Desktop,此时 URL 应显示为 127.0.0.1,表示 CC Switch 本地代理已成功接管,DeepSeek-V4 配置完成。

重置后 Claude Desktop 中 DeepSeek 配置成功的最终状态


FAQ:Claude Cowork 配置常见问题

Q:Claude Desktop 和 Claude Code 的第三方模型配置方式一样吗?

不一样。Claude Code CLI 用 CC Switch 命令切换模型;Claude Desktop 需要通过 CC Desktop Switch 工具做本地代理桥接。本文针对的是 Claude Desktop

Q:CC Desktop Switch 是否支持 DeepSeek 以外的模型?

支持。CC Desktop Switch 的提供商列表包含多个第三方模型,操作流程与本文一致——选择提供商 → 填 API Key → 开启本地路由。

Q:Mac 版本的 Claude Desktop 能用这个方法吗?

操作流程一致,但重置 Claude Desktop 的步骤不同:Mac 上需要在「访达 → 应用程序」中删除 Claude Desktop 后重新安装,或通过 ~/Library/Application Support/Claude/ 手动清理配置文件。

Q:配置成功后切换回 Claude 原生模型需要重新设置吗?

不需要。CC Switch 的本地路由只影响第三方模型的请求路径,Claude 原生模型不受影响,二者可以随时切换。


总结

环节要点
安装 Claude Desktop官网下载,正常安装
退出 Claude Desktop配置前必须完全退出,否则配置可能被覆盖
CC Desktop Switch 配置选择 DeepSeek → 填 API Key → 开启本地路由
验证与排错确认 URL 显示为 127.0.0.1;若不是,重置 Claude Desktop

下一步:配置完成后,在 Claude Desktop 中切换到 DeepSeek-V4,尝试一次对话,确认模型响应正常。

Released under the MIT License.