1. 适用范围与推荐理由

本指南适用于 Windows 电脑,目标是把 Claude Desktop 配置为可直接使用 DeepSeek V4 的桌面开发助手。完成后,日常使用时可以在 Claude Desktop 中选择 Cowork 或 Code 模式,使用 DeepSeek V4 Pro/Flash 执行文档处理、代码开发和定时任务等功能。

推荐这套方案的核心原因是:DeepSeek V4 是 DeepSeek 当前最新一代旗舰模型系列,官方发布说明明确提到 1M 超长上下文、V4-Pro 的 Agentic Coding 能力提升,以及对 Claude Code 等 Agent 产品的适配优化;同时 DeepSeek API 支持 Anthropic 接口,适合接入 Claude 生态。

组成 作用
Claude Desktop Anthropic 官方桌面应用,界面中集成任务、项目、Code 模式、Diff 审查、终端、用量统计等能力。对新用户更友好,不需要一开始就掌握大量命令行操作
DeepSeek V4 DeepSeek 当前最新一代旗舰模型系列,官方说明 V4 支持 1M 上下文;V4-Pro 面向 Agentic Coding 能力增强,并对 Claude Code 等 Agent 产品进行了适配和优化。详见 DeepSeek-V4 预览版发布说明
Claude 生态适配 DeepSeek API 新增对 Anthropic API 格式的支持,可通过 CC Desktop Switch 把 DeepSeek 接入 Claude Desktop
价格优势 DeepSeek 性价比极高,并且在多轮开发任务中,缓存命中比例通常较高,实际成本会进一步降低。详见 DeepSeek 模型与价格官方页面

本次部署需要的内容:

需提前准备 VPN/代理 主要用于下载和首次安装 Claude Desktop;完成 Gateway 配置后,日常使用通常不需要一直开启
见以下部署流程 Claude Desktop 安装包 从 Claude 官方下载页获取 Windows 安装程序

| | CC Desktop Switch 安装包 | 用于把 DeepSeek 的 Anthropic 兼容接口写入 Claude Desktop Gateway 配置 | | | DeepSeek 平台账号 | 用于申请 API Key、充值和查看用量 | | | DeepSeek API Key | API Key 用于接入模型;账户余额用于支付实际 token 消耗 | | | Git for Windows(可选) | 如果 Code 选项卡提示 Git 错误,或需要更完整的 Diff / 版本管理体验,再安装 Git for Windows |

2. 安装 Claude Desktop

下载安装阶段需 开启 VPN/代理 。完成 CC Desktop Switch 配置后,日常使用不需要开启 VPN/代理。

2.1 下载 Windows 安装程序

打开 Claude 官方下载页 ,点击 Download for Windows 。下载完成后,文件名一般为 Claude Setup.exe

图 1:Claude 官方下载页,点击 Download for Windows。

图 1:Claude 官方下载页,点击 Download for Windows

图 2:下载得到 Claude Setup.exe 安装程序。

图 2:下载得到 Claude Setup.exe 安装程序

2.2 运行安装并完成首次启动

双击 Claude Setup.exe 后,安装程序会继续下载和配置组件。如果出现人机验证,按页面提示完成即可。看到 Claude for WindowsGet started 页面,即说明桌面应用安装完成;本流程不需要继续点 Get started。

图 3:Claude Setup 安装过程中会继续下载和配置组件。

图 3:Claude Setup 安装过程中会继续下载和配置组件

图 4:如果出现人机验证,按页面提示完成即可。

图 4:如果出现人机验证,按页面提示完成即可

图 5:看到 Claude for Windows / Get started 页面说明安装已完成。

图 5:看到 Claude for Windows / Get started 页面说明安装已完成

2.3 完全退出 Claude Desktop

安装完成后先关闭 Claude Desktop,并从系统托盘右键 Claude 图标选择 Quit ,确保后续配置写入时应用已经完全退出。

图 6:从系统托盘右键 Claude 图标,选择 Quit 完全退出。

图 6:从系统托盘右键 Claude 图标,选择 Quit 完全退出

3. 安装并配置 CC Desktop Switch

CC Desktop Switch 用于把第三方模型提供商写入 Claude Desktop 配置。通过以下链接 获取 Windows 安装包

3.1 下载 CC Desktop Switch

进入 Releases 页面,下滑到 Assets 区域,下载 Windows Setup 版本。

图 7:CC Desktop Switch GitHub Releases 的 Assets 区域。

图 7:CC Desktop Switch GitHub Releases 的 Assets 区域

图 8:下载 Windows Setup 安装包。

图 8:下载 Windows Setup 安装包

3.2 安装 CC Desktop Switch

双击安装包,按安装向导继续下一步即可。

图 9:CC Desktop Switch 安装向导。

图 9:CC Desktop Switch 安装向导

3.3 添加 DeepSeek 提供商

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

图 10:在提供商列表中添加 DeepSeek,地址为 https://api.deepseek.com/anthropic。

图 10:在提供商列表中添加 DeepSeek,地址为 https://api.deepseek.com/anthropic

3.4 填写 API Key

只需要填写 DeepSeek API Key ,其他不需要更改。API Key 的申请和充值请跳转查看 4. 申请 DeepSeek API Key 与充值

图 11:添加提供商时填写 API Key。

图 11:添加提供商时填写 API Key

3.5 选择 1M 上下文与 Max 思考选项

按需要勾选 解锁 1M 上下文DeepSeek Max 思维

图 12:模型映射与 DeepSeek 1M 上下文、Max 思考相关选项。

图 12:模型映射与 DeepSeek 1M 上下文、Max 思考相关选项

3.6 一键应用到 Claude Desktop

点击 一键应用到 Claude 桌面版 。出现确认弹窗后点击确认,随后根据提示重启 Claude Desktop。

图 13:点击一键应用到 Claude 桌面版。

图 13:点击一键应用到 Claude 桌面版

图 14:确认将配置写入 Claude Desktop。

图 14:确认将配置写入 Claude Desktop

图 15:应用提示需要重启 Claude Desktop。

图 15:应用提示需要重启 Claude Desktop

3.7 使用 Gateway 打开 Claude Desktop

重新打开 Claude Desktop。登录页选择 Continue with Gateway ;不需要使用 Anthropic 账号登录。首次打开时可能会出现 Virtual Machine Platform not available 提醒,处理方法见 6.1 Virtual Machine Platform not available

图 16:Claude Desktop 中选择 Continue with Gateway,无需 Anthropic 账号登录。

图 16:Claude Desktop 中选择 Continue with Gateway,无需 Anthropic 账号登录

图 17:配置完成后的 Claude Desktop 主界面。

图 17:配置完成后的 Claude Desktop 主界面

配置完成后的使用方式

如果只是日常使用 Claude Desktop,不需要一直打开 CC Desktop Switch。只有在切换提供商、修改 API Key、调整模型映射或重新应用 Gateway 配置时,再打开操作即可。

4. 申请 DeepSeek API Key 与充值

DeepSeek API Key 相当于账户密码。任何拿到 Key 的人都可以消耗你的账户额度,因此不要把真实 Key 发到聊天、截图、公开文档或代码仓库中。

4.1 登录 DeepSeek 开放平台

打开 DeepSeek 开放平台登录页: https://platform.deepseek.com/sign_in

图 18:DeepSeek 开放平台登录页面。

图 18:DeepSeek 开放平台登录页面

4.2 充值并查看价格

登录后进入用量/余额页面。如果余额不足,先充值。价格详情请查看官方页面: DeepSeek 模型与价格

图 19:DeepSeek 平台用量与余额页面,可查看余额并充值。

图 19:DeepSeek 平台用量与余额页面,可查看余额并充值

图 20:DeepSeek 官方价格页面。

图 20:DeepSeek 官方价格页面

4.3 创建 API Key

进入 API keys ,也可以直接访问 https://platform.deepseek.com/api_keys 。点击 创建 API key ,名称可以随意填写,例如 cc-desktop

图 21:DeepSeek 控制台左侧 API keys 入口。

图 21:DeepSeek 控制台左侧 API keys 入口

图 22:API keys 页面,点击创建 API key。

图 22:API keys 页面,点击创建 API key

图 23:创建 API key 时填写名称。

图 23:创建 API key 时填写名称

4.4 保存并填入 API Key

创建完成后 立即复制并妥善保存 。平台只显示一次,忘记后无法再次查看,只能重新创建新的 Key。把复制的 Key 粘贴到 CC Desktop Switch 的 API Key 输入框中。

图 24:API key 创建后只显示一次,发布文档时已脱敏处理。

图 24:API key 创建后只显示一次,发布文档时已脱敏处理

5. 日常使用

Claude Desktop 里的两类模式是 Cowork 和 Code。可以简单理解为:Cowork 模式类似 Openclaw(龙虾)具有较高自主性,并在沙盒中隔离运行无法访问本机文件;Code 模式则为本地开发工作台,可以按需访问本机文件和应用。

5.1 Cowork 模式

Cowork 适合资料整理、调研和定时任务等长时间无人值守的任务。

图 25:Cowork 模式界面,包含 New task、Projects、Scheduled、Customize。

图 25:Cowork 模式界面

5.2 Code 模式

Code 适合软件开发、改代码、运行测试、查看 Diff、操作项目目录、调用终端命令和本地工具。它能访问你授权的工作目录,因此更适合有人值守的开发任务。

图 26:Code 模式界面,面向本地项目开发、终端和代码变更。

图 26:Code 模式界面,面向本地项目开发、终端和代码变更

5.3 选择工作目录

开发任务建议先创建一个独立工作文件夹。这样 Claude 的文件读写范围更清晰,也便于后续查看输出文件和改动。

在 Cowork 中可点击 Work in a project 绑定项目目录。

图 27:在 Cowork 中选择 Work in a project,把任务绑定到项目目录。

图 27:在 Cowork 中选择 Work in a project,把任务绑定到项目目录

首次授权目录时,Claude 会提示它可能读取、编辑并永久删除该目录及子目录文件,也可能把文件内容提供给连接的第三方工具。只对可信目录点击 AllowAlways allow

图 28:Claude 请求访问工作目录时会提示可读、可改、可删除文件。

图 28:Claude 请求访问工作目录时会提示可读、可改、可删除文件

在 Code 中可选择本地工作目录,后续代码、图片、日志和验证脚本都放在该目录下。

图 29:选择本地工作目录。

图 29:选择本地工作目录

5.4 模型选择与思考等级

在 Code 模式中,可以从模型菜单选择 DeepSeek V4 Pro、DeepSeek V4 Pro 1M、DeepSeek V4 Flash、DeepSeek V4 Flash 1M,并在 Effort 中选择 Low、Medium、High 等思考等级。

图 30:模型与思考等级选择菜单。

图 30:模型与思考等级选择菜单

DeepSeek 官方说明,V4-Pro 与 V4-Flash 最大上下文长度为 1M,均支持非思考模式与思考模式;思考模式支持通过 reasoning_effort 设置思考强度(high/max)。对于复杂 Agent 场景,官方建议使用思考模式,并将强度设置为 max。详见 DeepSeek-V4 预览版发布说明

个人推荐

日常使用一般推荐至少选择 DeepSeek V4 Pro + High 。除非已经非常了解 DeepSeek V4 各模型在不同思考等级下的性能表现,并且明确知道当前任务需要的思考等级,否则建议默认使用 Pro + High。对于感觉非常难、链路很长、需要反复调试或推理强度很高的任务,再开启到 Max。 如果是简单任务,直接用DeepSeek V4 Flash 就行

5.5 权限模式怎么选

模式 说明
Ask permissions 默认/保守模式。Claude 在编辑文件或运行命令前询问,适合新用户和敏感项目
Accept edits 自动接受文件编辑和常见文件系统操作,但更高风险的终端命令仍会询问。适合信任当前方向、希望加快迭代时使用
Plan mode 先读取文件、分析和提出计划,不直接改代码。适合复杂任务先审方案
Bypass permissions 跳过权限提示,等同于更高自主权模式。只建议在隔离目录、虚拟机或明确可重建的环境中使用;不要对重要生产目录无脑开启

图 31:Code 模式中的权限模式选择菜单。

图 31:Code 模式中的权限模式选择菜单

新手推荐

第一次做项目时使用 Ask permissionsPlan mode 。确认任务方向和工作目录安全后,再考虑 Accept edits。Bypass permissions 只用于你能接受自动改动和自动执行命令的安全隔离环境。

6. 补充说明

6.1 Virtual Machine Platform not available

如果 Claude Desktop 提示 Virtual Machine Platform not available ,说明 Windows 上的虚拟机平台功能未开启。

图 42:Virtual Machine Platform not available 提示。

图 42:Virtual Machine Platform not available 提示

处理方式:以管理员身份打开 PowerShell,执行下面命令,等待安装完成后重启电脑。

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

图 43:管理员 PowerShell 中启用 VirtualMachinePlatform。

图 43:管理员 PowerShell 中启用 VirtualMachinePlatform

6.2 开启 Bypass permissions

如果确实需要让 Claude 自动执行操作,可以进入 Claude Desktop → Settings → Claude Code

图 44:Claude Desktop 设置入口,进入 Claude Code 配置。

图 44:Claude Desktop 设置入口,进入 Claude Code 配置

在 Claude Code 设置中启用允许 Bypass permissions 的选项,然后回到 Code 对话,在发送按钮旁的权限模式菜单中选择 Bypass permissions。

图 45:在 Claude Code 设置中启用 Bypass permissions 模式。

图 45:在 Claude Code 设置中启用 Bypass permissions 模式

风险提醒

Bypass permissions 会显著降低人工确认环节。只在可重建、可回滚、没有敏感文件的工作目录中使用。

6.3 常用 Commands

在 Code 对话框里输入 / 可以查看可用命令,完整说明见 Claude Code Commands 官方文档

命令 用途
/usage 查看用量统计
/init 使用 CLAUDE.md 指南初始化项目,让 Claude 记录项目约定、运行方式和注意事项
/compact 总结当前对话以释放上下文,适合长会话继续推进
/btw <question> 提出一个快速附加问题,不把问题加入主对话上下文
/model 选择或更改模型;支持的模型可调整工作量/思考等级
/clear 用空上下文开始新对话,之前的对话仍可通过 resume 恢复
/insights 生成会话分析报告,包括项目领域、交互模式和摩擦点

6.4 Git 集成与 Diff 审查

不需要先系统学习 Git 才能使用 Code 模式。Claude Desktop 的 Code 模式可以通过界面查看文件差异,帮助你在接受或提交之前判断改动是否合理。

点击界面菜单中的 Diff 可以打开差异视图。

图 46:从界面菜单进入 Diff。

图 46:从界面菜单进入 Diff

Diff 视图中,绿色区域表示新增或替换后的内容,红色区域表示删除或替换前的内容。可以按文件查看改动,也可以围绕当前工作树或某轮 Claude 修改进行审查。

Windows 上如果 Code 选项卡提示 Git 错误,需要先参考 Windows 系统 Git 安装教程 安装 Git for Windows,并重启 Claude Desktop;但日常查看 Diff 不要求你熟练掌握 Git 命令。

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐