# 小白都能看懂的 Claude Desktop + DeepSeek V4 部署指南

面向 Windows 新手用户的 Claude Desktop、CC Desktop Switch 与 DeepSeek V4 API 配置、使用与示例说明。

# 小白都能看懂的 Claude Desktop + DeepSeek V4 部署指南

## 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 生态。

<table id="bkmrk-%E7%BB%84%E6%88%90%E4%BD%9C%E7%94%A8claude-desktopan" style="width:100%;border-collapse:collapse;"><thead><tr><th style="border:1px solid rgb(208,215,222);padding:8px;text-align:left;background:rgb(246,248,250);width:19.6786%;">组成</th><th style="border:1px solid rgb(208,215,222);padding:8px;text-align:left;background:rgb(246,248,250);width:80.3929%;">作用</th></tr></thead><tbody><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:19.6786%;">Claude Desktop</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:80.3929%;">Anthropic 官方桌面应用，界面中集成任务、项目、Code 模式、Diff 审查、终端、用量统计等能力。**对新用户更友好，不需要一开始就掌握大量命令行操作**</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:19.6786%;">DeepSeek V4</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:80.3929%;">DeepSeek 当前最新一代旗舰模型系列，官方说明 V4 支持 1M 上下文；V4-Pro 面向 Agentic Coding 能力增强，并对 Claude Code 等 Agent 产品进行了适配和优化。详见 [DeepSeek-V4 预览版发布说明](https://api-docs.deepseek.com/zh-cn/news/news260424)</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:19.6786%;">Claude 生态适配</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:80.3929%;">DeepSeek API 新增对 Anthropic API 格式的支持，可通过 CC Desktop Switch 把 DeepSeek 接入 Claude Desktop</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:19.6786%;">价格优势</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:80.3929%;">DeepSeek 性价比极高，并且在多轮开发任务中，缓存命中比例通常较高，实际成本会进一步降低。详见 [DeepSeek 模型与价格官方页面](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/)</td></tr></tbody></table>

**本次部署需要的内容：**

<table id="bkmrk-windows-%E7%94%B5%E8%84%91%E7%94%A8%E4%BA%8E%E5%AE%89%E8%A3%85-claud" style="width:100%;border-collapse:collapse;margin:14px 0;"><tbody><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:14.8919%;">**需提前准备**</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:24.1836%;">VPN/代理</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:60.996%;">主要用于下载和首次安装 Claude Desktop；完成 Gateway 配置后，日常使用通常不需要一直开启</td></tr><tr><td rowspan="5" style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:middle;width:14.8919%;">**见以下部署流程**</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:24.1836%;">Claude Desktop 安装包</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:60.996%;">从 Claude 官方下载页获取 Windows 安装程序</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:24.1836%;">CC Desktop Switch 安装包</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:60.996%;">用于把 DeepSeek 的 Anthropic 兼容接口写入 Claude Desktop Gateway 配置</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:24.1836%;">DeepSeek 平台账号</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:60.996%;">用于申请 API Key、充值和查看用量</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:24.1836%;">DeepSeek API Key</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:60.996%;">API Key 用于接入模型；账户余额用于支付实际 token 消耗</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:24.1836%;">Git for Windows（可选）</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:60.996%;">如果 Code 选项卡提示 Git 错误，或需要更完整的 Diff / 版本管理体验，再安装 [Git for Windows](https://www.cnblogs.com/xueweisuoyong/p/11914045.html)</td></tr></tbody></table>

## 2. 安装 Claude Desktop

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

### 2.1 下载 Windows 安装程序

打开 [Claude 官方下载页](https://claude.com/download)，点击 **Download for Windows**。下载完成后，文件名一般为 **Claude Setup.exe**。

<figure id="bkmrk-%E5%9B%BE-1%EF%BC%9Aclaude-%E5%AE%98%E6%96%B9%E4%B8%8B%E8%BD%BD%E9%A1%B5%EF%BC%8C%E7%82%B9%E5%87%BB-" style="margin:14px auto 22px auto;text-align:center;">[![图 1：Claude 官方下载页，点击 Download for Windows。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/1.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/1.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 1：Claude 官方下载页，点击 Download for Windows</figcaption></figure><figure id="bkmrk-%E5%9B%BE-2%EF%BC%9A%E4%B8%8B%E8%BD%BD%E5%BE%97%E5%88%B0-claude-setu" style="margin:14px auto 22px auto;text-align:center;">[![图 2：下载得到 Claude Setup.exe 安装程序。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/2.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/2.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 2：下载得到 Claude Setup.exe 安装程序</figcaption></figure>### 2.2 运行安装并完成首次启动

双击 **Claude Setup.exe** 后，安装程序会继续下载和配置组件。如果出现人机验证，按页面提示完成即可。看到 **Claude for Windows** 与 **Get started** 页面，即说明桌面应用安装完成；<span style="color:rgb(224,62,45);">**本流程不需要继续点 Get started**</span>。

<figure id="bkmrk-%E5%9B%BE-3%EF%BC%9Aclaude-setup-%E5%AE%89%E8%A3%85%E8%BF%87" style="margin:14px auto 22px auto;text-align:center;">[![图 3：Claude Setup 安装过程中会继续下载和配置组件。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/3.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/3.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 3：Claude Setup 安装过程中会继续下载和配置组件</figcaption></figure><figure id="bkmrk-%E5%9B%BE-4%EF%BC%9A%E5%A6%82%E6%9E%9C%E5%87%BA%E7%8E%B0%E4%BA%BA%E6%9C%BA%E9%AA%8C%E8%AF%81%EF%BC%8C%E6%8C%89%E9%A1%B5%E9%9D%A2%E6%8F%90%E7%A4%BA%E5%AE%8C%E6%88%90" style="margin:14px auto 22px auto;text-align:center;">[![图 4：如果出现人机验证，按页面提示完成即可。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/4.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/4.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 4：如果出现人机验证，按页面提示完成即可</figcaption></figure><figure id="bkmrk-%E5%9B%BE-5%EF%BC%9A%E7%9C%8B%E5%88%B0-claude-for-wi" style="margin:14px auto 22px auto;text-align:center;">[![图 5：看到 Claude for Windows / Get started 页面说明安装已完成。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/5.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/5.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 5：看到 Claude for Windows / Get started 页面说明安装已完成</figcaption></figure>### 2.3 完全退出 Claude Desktop

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

<figure id="bkmrk-%E5%9B%BE-6%EF%BC%9A%E4%BB%8E%E7%B3%BB%E7%BB%9F%E6%89%98%E7%9B%98%E5%8F%B3%E9%94%AE-claude-%E5%9B%BE" style="margin:14px auto 22px auto;text-align:center;">[![图 6：从系统托盘右键 Claude 图标，选择 Quit 完全退出。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/12.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/12.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 6：从系统托盘右键 Claude 图标，选择 Quit 完全退出</figcaption></figure>## 3. 安装并配置 CC Desktop Switch

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

- GitHub Releases：[https://github.com/lonr-6/cc-desktop-switch/releases](https://github.com/lonr-6/cc-desktop-switch/releases)
- Windows 安装包示例：`CC-Desktop-Switch-v1.0.17-Windows-Setup.exe`

### 3.1 下载 CC Desktop Switch

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

<figure id="bkmrk-%E5%9B%BE-7%EF%BC%9Acc-desktop-switc" style="margin:14px auto 22px auto;text-align:center;">[![图 7：CC Desktop Switch GitHub Releases 的 Assets 区域。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/6.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/6.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 7：CC Desktop Switch GitHub Releases 的 Assets 区域</figcaption></figure><figure id="bkmrk-%E5%9B%BE-8%EF%BC%9A%E4%B8%8B%E8%BD%BD-windows-setup" style="margin:14px auto 22px auto;text-align:center;">[![图 8：下载 Windows Setup 安装包。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/7.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/7.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 8：下载 Windows Setup 安装包</figcaption></figure>### 3.2 安装 CC Desktop Switch

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

<figure id="bkmrk-%E5%9B%BE-9%EF%BC%9Acc-desktop-switc" style="margin:14px auto 22px auto;text-align:center;">[![图 9：CC Desktop Switch 安装向导。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/8.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/8.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 9：CC Desktop Switch 安装向导</figcaption></figure>### 3.3 添加 DeepSeek 提供商

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

<figure id="bkmrk-%E5%9B%BE-10%EF%BC%9A%E5%9C%A8%E6%8F%90%E4%BE%9B%E5%95%86%E5%88%97%E8%A1%A8%E4%B8%AD%E6%B7%BB%E5%8A%A0-deeps" style="margin:14px auto 22px auto;text-align:center;">[![图 10：在提供商列表中添加 DeepSeek，地址为 https://api.deepseek.com/anthropic。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/9.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/9.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 10：在提供商列表中添加 DeepSeek，地址为 https://api.deepseek.com/anthropic</figcaption></figure>### 3.4 填写 API Key

只需要填写 **DeepSeek API Key**，其他不需要更改。API Key 的申请和充值请跳转查看 [4. 申请 DeepSeek API Key 与充值](#bkmrk-4.-%E7%94%B3%E8%AF%B7-deepseek-api-k)。

<figure id="bkmrk-%E5%9B%BE-11%EF%BC%9A%E6%B7%BB%E5%8A%A0%E6%8F%90%E4%BE%9B%E5%95%86%E6%97%B6%E5%A1%AB%E5%86%99-api-ke" style="margin:14px auto 22px auto;text-align:center;">[![图 11：添加提供商时填写 API Key。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/10.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/10.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 11：添加提供商时填写 API Key</figcaption></figure>### 3.5 选择 1M 上下文与 Max 思考选项

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

<figure id="bkmrk-%E5%9B%BE-12%EF%BC%9A%E6%A8%A1%E5%9E%8B%E6%98%A0%E5%B0%84%E4%B8%8E-deepseek-" style="margin:14px auto 22px auto;text-align:center;">[![图 12：模型映射与 DeepSeek 1M 上下文、Max 思考相关选项。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/11.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/11.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 12：模型映射与 DeepSeek 1M 上下文、Max 思考相关选项</figcaption></figure>### 3.6 一键应用到 Claude Desktop

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

<figure id="bkmrk-%E5%9B%BE-13%EF%BC%9A%E7%82%B9%E5%87%BB%E4%B8%80%E9%94%AE%E5%BA%94%E7%94%A8%E5%88%B0-claude-" style="margin:14px auto 22px auto;text-align:center;">[![图 13：点击一键应用到 Claude 桌面版。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/13.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/13.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 13：点击一键应用到 Claude 桌面版</figcaption></figure><figure id="bkmrk-%E5%9B%BE-14%EF%BC%9A%E7%A1%AE%E8%AE%A4%E5%B0%86%E9%85%8D%E7%BD%AE%E5%86%99%E5%85%A5-claude-" style="margin:14px auto 22px auto;text-align:center;">[![图 14：确认将配置写入 Claude Desktop。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/21.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/21.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 14：确认将配置写入 Claude Desktop</figcaption></figure><figure id="bkmrk-%E5%9B%BE-15%EF%BC%9A%E5%BA%94%E7%94%A8%E6%8F%90%E7%A4%BA%E9%9C%80%E8%A6%81%E9%87%8D%E5%90%AF-claude" style="margin:14px auto 22px auto;text-align:center;">[![图 15：应用提示需要重启 Claude Desktop。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/22.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/22.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 15：应用提示需要重启 Claude Desktop</figcaption></figure>### 3.7 使用 Gateway 打开 Claude Desktop

重新打开 Claude Desktop。登录页选择 **Continue with Gateway**；不需要使用 Anthropic 账号登录。首次打开时可能会出现 **Virtual Machine Platform not available** 提醒，处理方法见 [6.1 Virtual Machine Platform not available](#bkmrk-7.1-virtual-machine-)。

<figure id="bkmrk-%E5%9B%BE-16%EF%BC%9Aclaude-desktop-" style="margin:14px auto 22px auto;text-align:center;">[![图 16：Claude Desktop 中选择 Continue with Gateway，无需 Anthropic 账号登录。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/23.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/23.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 16：Claude Desktop 中选择 Continue with Gateway，无需 Anthropic 账号登录</figcaption></figure><figure id="bkmrk-%E5%9B%BE-17%EF%BC%9A%E9%85%8D%E7%BD%AE%E5%AE%8C%E6%88%90%E5%90%8E%E7%9A%84-claude-d" style="margin:14px auto 22px auto;text-align:center;">[![图 17：配置完成后的 Claude Desktop 主界面。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/26.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/26.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 17：配置完成后的 Claude Desktop 主界面</figcaption></figure><table id="bkmrk-%E9%85%8D%E7%BD%AE%E5%AE%8C%E6%88%90%E5%90%8E%E7%9A%84%E4%BD%BF%E7%94%A8%E6%96%B9%E5%BC%8F%E5%A6%82%E6%9E%9C%E5%8F%AA%E6%98%AF%E6%97%A5%E5%B8%B8%E4%BD%BF%E7%94%A8-c" style="width:100%;border-collapse:collapse;margin:14px 0;"><tbody><tr><td style="border-left:4px solid #d0d7de;background:#f6f8fa;padding:12px 14px;">**配置完成后的使用方式**

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

</td></tr></tbody></table>

## 4. 申请 DeepSeek API Key 与充值

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

### 4.1 登录 DeepSeek 开放平台

打开 DeepSeek 开放平台登录页：[https://platform.deepseek.com/sign\_in](https://platform.deepseek.com/sign_in)。

<figure id="bkmrk-%E5%9B%BE-18%EF%BC%9Adeepseek-%E5%BC%80%E6%94%BE%E5%B9%B3%E5%8F%B0%E7%99%BB%E5%BD%95" style="margin:14px auto 22px auto;text-align:center;">[![图 18：DeepSeek 开放平台登录页面。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/14.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/14.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 18：DeepSeek 开放平台登录页面</figcaption></figure>### 4.2 充值并查看价格

登录后进入用量/余额页面。如果余额不足，先充值。价格详情请查看官方页面：[DeepSeek 模型与价格](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/)。

<figure id="bkmrk-%E5%9B%BE-19%EF%BC%9Adeepseek-%E5%B9%B3%E5%8F%B0%E7%94%A8%E9%87%8F%E4%B8%8E%E4%BD%99" style="margin:14px auto 22px auto;text-align:center;">[![图 19：DeepSeek 平台用量与余额页面，可查看余额并充值。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/15.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/15.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 19：DeepSeek 平台用量与余额页面，可查看余额并充值</figcaption></figure><figure id="bkmrk-%E5%9B%BE-20%EF%BC%9Adeepseek-%E5%AE%98%E6%96%B9%E4%BB%B7%E6%A0%BC%E9%A1%B5%E9%9D%A2" style="margin:14px auto 22px auto;text-align:center;">[![图 20：DeepSeek 官方价格页面。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/16.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/16.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 20：DeepSeek 官方价格页面</figcaption></figure>### 4.3 创建 API Key

进入 **API keys**，也可以直接访问 [https://platform.deepseek.com/api\_keys](https://platform.deepseek.com/api_keys)。点击 **创建 API key**，名称可以随意填写，例如 `cc-desktop`。

<figure id="bkmrk-%E5%9B%BE-21%EF%BC%9Adeepseek-%E6%8E%A7%E5%88%B6%E5%8F%B0%E5%B7%A6%E4%BE%A7-" style="margin:14px auto 22px auto;text-align:center;">[![图 21：DeepSeek 控制台左侧 API keys 入口。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/17.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/17.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 21：DeepSeek 控制台左侧 API keys 入口</figcaption></figure><figure id="bkmrk-%E5%9B%BE-22%EF%BC%9Aapi-keys-%E9%A1%B5%E9%9D%A2%EF%BC%8C%E7%82%B9%E5%87%BB%E5%88%9B" style="margin:14px auto 22px auto;text-align:center;">[![图 22：API keys 页面，点击创建 API key。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/18.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/18.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 22：API keys 页面，点击创建 API key</figcaption></figure><figure id="bkmrk-%E5%9B%BE-23%EF%BC%9A%E5%88%9B%E5%BB%BA-api-key-%E6%97%B6%E5%A1%AB%E5%86%99%E5%90%8D" style="margin:14px auto 22px auto;text-align:center;">[![图 23：创建 API key 时填写名称。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/19.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/19.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 23：创建 API key 时填写名称</figcaption></figure>### 4.4 保存并填入 API Key

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

<figure id="bkmrk-%E5%9B%BE-24%EF%BC%9Aapi-key-%E5%88%9B%E5%BB%BA%E5%90%8E%E5%8F%AA%E6%98%BE%E7%A4%BA%E4%B8%80" style="margin:14px auto 22px auto;text-align:center;">[![图 24：API key 创建后只显示一次，发布文档时已脱敏处理。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/20-redacted.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/20-redacted.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 24：API key 创建后只显示一次，发布文档时已脱敏处理</figcaption></figure>## 5. 日常使用

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

### 5.1 Cowork 模式

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

<figure id="bkmrk-%E5%9B%BE-25%EF%BC%9Acowork-%E6%A8%A1%E5%BC%8F%E7%95%8C%E9%9D%A2%EF%BC%8C%E5%8C%85%E5%90%AB-" style="margin:14px auto 22px auto;text-align:center;">[![图 25：Cowork 模式界面，包含 New task、Projects、Scheduled、Customize。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/29.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/29.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 25：Cowork 模式界面</figcaption></figure>### 5.2 Code 模式

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

<figure id="bkmrk-%E5%9B%BE-26%EF%BC%9Acode-%E6%A8%A1%E5%BC%8F%E7%95%8C%E9%9D%A2%EF%BC%8C%E9%9D%A2%E5%90%91%E6%9C%AC%E5%9C%B0%E9%A1%B9" style="margin:14px auto 22px auto;text-align:center;">[![图 26：Code 模式界面，面向本地项目开发、终端和代码变更。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/30.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/30.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 26：Code 模式界面，面向本地项目开发、终端和代码变更</figcaption></figure>### 5.3 选择工作目录

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

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

<figure id="bkmrk-%E5%9B%BE-27%EF%BC%9A%E5%9C%A8-cowork-%E4%B8%AD%E9%80%89%E6%8B%A9-wo" style="margin:14px auto 22px auto;text-align:center;">[![图 27：在 Cowork 中选择 Work in a project，把任务绑定到项目目录。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/27.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/27.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 27：在 Cowork 中选择 Work in a project，把任务绑定到项目目录</figcaption></figure>首次授权目录时，Claude 会提示它可能读取、编辑并永久删除该目录及子目录文件，也可能把文件内容提供给连接的第三方工具。只对可信目录点击 **Allow** 或 **Always allow**。

<figure id="bkmrk-%E5%9B%BE-28%EF%BC%9Aclaude-%E8%AF%B7%E6%B1%82%E8%AE%BF%E9%97%AE%E5%B7%A5%E4%BD%9C%E7%9B%AE%E5%BD%95" style="margin:14px auto 22px auto;text-align:center;">[![图 28：Claude 请求访问工作目录时会提示可读、可改、可删除文件。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/28.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/28.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 28：Claude 请求访问工作目录时会提示可读、可改、可删除文件</figcaption></figure>在 Code 中可选择本地工作目录，后续代码、图片、日志和验证脚本都放在该目录下。

<figure id="bkmrk-%E5%9B%BE-29%EF%BC%9A%E9%80%89%E6%8B%A9%E6%9C%AC%E5%9C%B0%E5%B7%A5%E4%BD%9C%E7%9B%AE%E5%BD%95%E3%80%82" style="margin:14px auto 22px auto;text-align:center;">[![图 29：选择本地工作目录。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/31.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/31.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 29：选择本地工作目录</figcaption></figure>### 5.4 模型选择与思考等级

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

<figure id="bkmrk-%E5%9B%BE-30%EF%BC%9A%E6%A8%A1%E5%9E%8B%E4%B8%8E%E6%80%9D%E8%80%83%E7%AD%89%E7%BA%A7%E9%80%89%E6%8B%A9%E8%8F%9C%E5%8D%95%E3%80%82" style="margin:14px auto 22px auto;text-align:center;">[![图 30：模型与思考等级选择菜单。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/1777826001774-d.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/1777826001774-d.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 30：模型与思考等级选择菜单</figcaption></figure>DeepSeek 官方说明，V4-Pro 与 V4-Flash 最大上下文长度为 1M，均支持非思考模式与思考模式；思考模式支持通过 `reasoning_effort` 设置思考强度（high/max）。对于复杂 Agent 场景，官方建议使用思考模式，并将强度设置为 max。详见 [DeepSeek-V4 预览版发布说明](https://api-docs.deepseek.com/zh-cn/news/news260424)。

<table id="bkmrk-%E4%B8%AA%E4%BA%BA%E6%8E%A8%E8%8D%90%E6%97%A5%E5%B8%B8%E4%BD%BF%E7%94%A8%E4%B8%80%E8%88%AC%E6%8E%A8%E8%8D%90%E8%87%B3%E5%B0%91%E9%80%89%E6%8B%A9-dee" style="width:100%;border-collapse:collapse;margin:14px 0;"><tbody><tr><td style="border-left:4px solid #d4a72c;background:#fff8c5;padding:12px 14px;">**个人推荐**

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

</td></tr></tbody></table>

### 5.5 权限模式怎么选

<table id="bkmrk-%E6%A8%A1%E5%BC%8F%E8%AF%B4%E6%98%8Eask-permissions%E9%BB%98" style="width:100%;border-collapse:collapse;"><thead><tr><th style="border:1px solid rgb(208,215,222);padding:8px;text-align:left;background:rgb(246,248,250);width:18.1133%;">模式</th><th style="border:1px solid rgb(208,215,222);padding:8px;text-align:left;background:rgb(246,248,250);width:81.8391%;">说明</th></tr></thead><tbody><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:18.1133%;">Ask permissions</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:81.8391%;">默认/保守模式。Claude 在编辑文件或运行命令前询问，适合新用户和敏感项目</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:18.1133%;">Accept edits</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:81.8391%;">自动接受文件编辑和常见文件系统操作，但更高风险的终端命令仍会询问。适合信任当前方向、希望加快迭代时使用</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:18.1133%;">Plan mode</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:81.8391%;">先读取文件、分析和提出计划，不直接改代码。适合复杂任务先审方案</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:18.1133%;">Bypass permissions</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:81.8391%;">跳过权限提示，等同于更高自主权模式。只建议在隔离目录、虚拟机或明确可重建的环境中使用；不要对重要生产目录无脑开启</td></tr></tbody></table>

<figure id="bkmrk-%E5%9B%BE-30%EF%BC%9Acode-%E6%A8%A1%E5%BC%8F%E4%B8%AD%E7%9A%84%E6%9D%83%E9%99%90%E6%A8%A1%E5%BC%8F%E9%80%89%E6%8B%A9" style="margin:14px auto 22px auto;text-align:center;">[![图 31：Code 模式中的权限模式选择菜单。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/34.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/34.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 31：Code 模式中的权限模式选择菜单</figcaption></figure><table id="bkmrk-%E6%96%B0%E6%89%8B%E6%8E%A8%E8%8D%90%E7%AC%AC%E4%B8%80%E6%AC%A1%E5%81%9A%E9%A1%B9%E7%9B%AE%E6%97%B6%E4%BD%BF%E7%94%A8-ask-pe" style="width:100%;border-collapse:collapse;margin:14px 0;"><tbody><tr><td style="border-left:4px solid #d4a72c;background:#fff8c5;padding:12px 14px;">**新手推荐**

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

</td></tr></tbody></table>

### 5.6 Code 模式使用示例

下面示例展示了一个较复杂的开发任务：自主构建、运行并调试<span style="color:rgb(53,152,219);">**基于共旋梁单元的 MATLAB 几何非线性有限元求解器，以计算悬臂梁的大变形与后屈曲响应**</span>。

本示例全程使用 **DeepSeek V4 Pro 1M 上下文 + Max 思考等级**，并使用 **Bypass permissions** 权限模式，运行过程中**<span style="color:rgb(224,62,45);">不做任何人工干预</span>**。

#### 5.6.1 输入任务提示词

在 Code 模式中说明目标、参考标准、希望生成的程序和验证方式，然后回车运行。

提示词全文：[https://files.20020519.xyz/api/public/dl/kS6zCxPC?inline=true](https://files.20020519.xyz/api/public/dl/kS6zCxPC?inline=true)

<figure id="bkmrk-%E5%9B%BE-31%EF%BC%9Acode-%E6%A8%A1%E5%BC%8F%E4%B8%AD%E8%BE%93%E5%85%A5-matl" style="margin:14px auto 22px auto;text-align:center;">[![图 32：Code 模式中输入 MATLAB 有限元求解器任务提示词。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/36.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/36.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 32：Code 模式中输入 MATLAB 有限元求解器任务提示词</figcaption></figure>#### 5.6.2 查看完成结果

任务完成后，Claude 汇总计算结果、误差对比、验证过程和输出文件。本次示例开始时间为 2026-05-03 9:03:56 PM，结束时间为 2026-05-03 9:55:44 PM，<span style="color:rgb(224,62,45);">**耗时约 52 分钟**</span>。

<figure id="bkmrk-%E5%9B%BE-32%EF%BC%9A%E4%BB%BB%E5%8A%A1%E5%AE%8C%E6%88%90%E5%90%8E%EF%BC%8Cclaude-%E6%B1%87%E6%80%BB" style="margin:14px auto 22px auto;text-align:center;">[![图 33：任务完成后，Claude 汇总验证结果与输出文件。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/37.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/37.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 33：任务完成后，Claude 汇总验证结果与输出文件</figcaption></figure>#### 5.6.3 输出文件

工作目录中生成了 MATLAB 主程序、切线刚度验证脚本和三张结果图。

<figure id="bkmrk-%E5%9B%BE-33%EF%BC%9A%E7%A4%BA%E4%BE%8B%E4%BB%BB%E5%8A%A1%E7%94%9F%E6%88%90%E7%9A%84%E5%B7%A5%E4%BD%9C%E7%9B%AE%E5%BD%95%E6%96%87%E4%BB%B6%E3%80%82" style="margin:14px auto 22px auto;text-align:center;">[![图 34：示例任务生成的工作目录文件。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/40.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/40.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 34：示例任务生成的工作目录文件</figcaption></figure><table id="bkmrk-%E6%96%87%E4%BB%B6%E8%AF%B4%E6%98%8Enafems_cantileve" style="width:100%;border-collapse:collapse;"><thead><tr><th style="border:1px solid #d0d7de;padding:8px;text-align:left;background:#f6f8fa;">文件</th><th style="border:1px solid #d0d7de;padding:8px;text-align:left;background:#f6f8fa;">说明</th></tr></thead><tbody><tr><td style="border:1px solid #d0d7de;padding:8px;vertical-align:top;">`NAFEMS_Cantilever_GNL.m`</td><td style="border:1px solid #d0d7de;padding:8px;vertical-align:top;">主 MATLAB 求解程序（[直接查看](https://files.20020519.xyz/api/public/dl/ooTkJzWK?inline=true)）</td></tr><tr><td style="border:1px solid #d0d7de;padding:8px;vertical-align:top;">`validate_tangent.m`</td><td style="border:1px solid #d0d7de;padding:8px;vertical-align:top;">切线刚度验证脚本（[直接查看](https://files.20020519.xyz/api/public/dl/mYi3VfwZ?inline=true)）</td></tr><tr><td style="border:1px solid #d0d7de;padding:8px;vertical-align:top;">全部附件</td><td style="border:1px solid #d0d7de;padding:8px;vertical-align:top;">包含提示词、MATLAB 文件和三张 PNG 输出图（[下载附件包](https://files.20020519.xyz/share/oyDmszvX)）</td></tr></tbody></table>

#### 5.6.4 结果图

图 35 展示一阶线性屈曲模态，图中可见临界载荷系数约为 4.2173e+05。

<figure id="bkmrk-%E5%9B%BE-34%EF%BC%9A%E7%BA%BF%E6%80%A7%E5%B1%88%E6%9B%B2%E6%A8%A1%E6%80%81%E5%9B%BE%EF%BC%8C%E4%B8%B4%E7%95%8C%E8%BD%BD%E8%8D%B7%E7%B3%BB%E6%95%B0%E7%BA%A6" style="margin:14px auto 22px auto;text-align:center;">[![图 35：线性屈曲模态图，临界载荷系数约 4.2173e+05。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/figure1-linearbucklingmode.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/figure1-linearbucklingmode.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 35：线性屈曲模态图，临界载荷系数约 4.2173e+05</figcaption></figure>图 36 展示端部水平位移、竖向位移随归一化载荷变化的曲线。

<figure id="bkmrk-%E5%9B%BE-35%EF%BC%9A%E7%AB%AF%E9%83%A8%E4%BD%8D%E7%A7%BB%E4%B8%8E%E5%BD%92%E4%B8%80%E5%8C%96%E8%BD%BD%E8%8D%B7%E6%9B%B2%E7%BA%BF%E3%80%82" style="margin:14px auto 22px auto;text-align:center;">[![图 36：端部位移与归一化载荷曲线。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/figure2-loaddisplacementcurve.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/figure2-loaddisplacementcurve.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 36：端部位移与归一化载荷曲线</figcaption></figure>图 37 展示大变形全过程；NCL=1.00 时， `u_tip=-5.050 m`、`v_tip=-1.351 m`，与 [COMSOL 参考解](https://cn.comsol.com/model/large-deformation-analysis-of-a-beam-204) 一致。

<figure id="bkmrk-%E5%9B%BE-36%EF%BC%9A%E5%A4%A7%E5%8F%98%E5%BD%A2%E8%BF%87%E7%A8%8B%EF%BC%8Cncl%3D1.00-" style="margin:14px auto 22px auto;text-align:center;">[![图 37：大变形过程，NCL=1.00 时 u_tip=-5.050 m、v_tip=-1.351 m。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/figure3-largedeformationprocess.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/figure3-largedeformationprocess.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 37：大变形过程，NCL=1.00 时 u\_tip=-5.050 m、v\_tip=-1.351 m</figcaption></figure>#### 5.6.5 运行用量与成本分析

**1. 运行前后余额变化**

图 38 显示：运行前，充值余额 ¥34.34，deepseek-v4-pro API 请求 97 次，Tokens 1,840,054。

<figure id="bkmrk-%E5%9B%BE-37%EF%BC%9Adeepseek-%E5%B9%B3%E5%8F%B0%E8%BF%90%E8%A1%8C%E5%89%8D%E4%BD%99" style="margin:14px auto 22px auto;text-align:center;">[![图 38：DeepSeek 平台运行前余额与用量。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/4mcNjxJWI9.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/4mcNjxJWI9.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 38：DeepSeek 平台运行前余额与用量</figcaption></figure>图 39 显示：运行后，充值余额 ¥33.19，deepseek-v4-pro API 请求 138 次，Tokens 5,521,013。本次示例从平台账单视角看**余额减少约 ¥1.15**，实际费用受模型、缓存命中、输出长度、优惠期和其他并发调用影响。

<figure id="bkmrk-%E5%9B%BE-38%EF%BC%9Adeepseek-%E5%B9%B3%E5%8F%B0%E8%BF%90%E8%A1%8C%E5%90%8E%E4%BD%99" style="margin:14px auto 22px auto;text-align:center;">[![图 39：DeepSeek 平台运行后余额与用量。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/FHQG8ghDoP.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/FHQG8ghDoP.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 39：DeepSeek 平台运行后余额与用量</figcaption></figure>**2. 缓存命中与成本**

图中明细显示当日 deepseek-v4-pro 用量约 5,351,955 tokens，其中输入缓存命中约 4,823,424 tokens、输入缓存未命中约 452,092 tokens、输出约 76,439 tokens。**输入缓存命中占输入 token 的比例约 91%**，结合 [DeepSeek 模型与价格官方页面](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/)中**“缓存命中输入 token 价格远低于缓存未命中输入 token”**的计费方式，长上下文、多轮开发任务在缓存命中率较高时会进一步降低实际成本。

<figure id="bkmrk-%E5%9B%BE-39%EF%BC%9Adeepseek-deepse" style="margin:14px auto 22px auto;text-align:center;">[![图 40：DeepSeek deepseek-v4-pro 用量明细，包含缓存命中、未命中和输出 token。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/39.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/39.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 40：DeepSeek deepseek-v4-pro 用量明细，包含缓存命中、未命中和输出 token</figcaption></figure>**3. Claude Desktop 内查看用量**

在 Claude Desktop 内可以使用 `/usage` 查看应用侧统计，辅助确认模型和输入/输出 token 情况。

<figure id="bkmrk-%E5%9B%BE-40%EF%BC%9Aclaude-desktop-" style="margin:14px auto 22px auto;text-align:center;">[![图 41：Claude Desktop 内 /usage 用量统计。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/38.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/38.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 41：Claude Desktop 内 /usage 用量统计</figcaption></figure>## 6. 补充说明

### 6.1 Virtual Machine Platform not available

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

<figure id="bkmrk-%E5%9B%BE-41%EF%BC%9Avirtual-machine" style="margin:14px auto 22px auto;text-align:center;">[![图 42：Virtual Machine Platform not available 提示。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/24.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/24.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 42：Virtual Machine Platform not available 提示</figcaption></figure>处理方式：以管理员身份打开 PowerShell，执行下面命令，等待安装完成后重启电脑。

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

<figure id="bkmrk-%E5%9B%BE-42%EF%BC%9A%E7%AE%A1%E7%90%86%E5%91%98-powershell-" style="margin:14px auto 22px auto;text-align:center;">[![图 43：管理员 PowerShell 中启用 VirtualMachinePlatform。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/25.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/25.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 43：管理员 PowerShell 中启用 VirtualMachinePlatform</figcaption></figure>### 6.2 开启 Bypass permissions

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

<figure id="bkmrk-%E5%9B%BE-43%EF%BC%9Aclaude-desktop-" style="margin:14px auto 22px auto;text-align:center;">[![图 44：Claude Desktop 设置入口，进入 Claude Code 配置。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/32.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/32.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 44：Claude Desktop 设置入口，进入 Claude Code 配置</figcaption></figure>在 Claude Code 设置中启用允许 Bypass permissions 的选项，然后回到 Code 对话，在发送按钮旁的权限模式菜单中选择 Bypass permissions。

<figure id="bkmrk-%E5%9B%BE-44%EF%BC%9A%E5%9C%A8-claude-code-%E8%AE%BE" style="margin:14px auto 22px auto;text-align:center;">[![图 45：在 Claude Code 设置中启用 Bypass permissions 模式。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/33.png)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/33.png)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 45：在 Claude Code 设置中启用 Bypass permissions 模式</figcaption></figure><table id="bkmrk-%E9%A3%8E%E9%99%A9%E6%8F%90%E9%86%92bypass-permissio" style="width:100%;border-collapse:collapse;margin:14px 0;"><tbody><tr><td style="border-left:4px solid #cf222e;background:#ffebe9;padding:12px 14px;">**风险提醒**

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

</td></tr></tbody></table>

### 6.3 常用 Commands

在 Code 对话框里输入 `/` 可以查看可用命令，完整说明见 [Claude Code Commands 官方文档](https://code.claude.com/docs/zh-CN/commands)。

<table id="bkmrk-%E5%91%BD%E4%BB%A4%E7%94%A8%E9%80%94%2Fusage%E6%9F%A5%E7%9C%8B%E7%94%A8%E9%87%8F%E7%BB%9F%E8%AE%A1%E3%80%82%E5%AE%98%E6%96%B9%E6%96%87" style="width:100%;border-collapse:collapse;"><thead><tr><th style="border:1px solid rgb(208,215,222);padding:8px;text-align:left;background:rgb(246,248,250);width:20.0172%;">命令</th><th style="border:1px solid rgb(208,215,222);padding:8px;text-align:left;background:rgb(246,248,250);width:79.9352%;">用途</th></tr></thead><tbody><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:20.0172%;">`/usage`</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:79.9352%;">查看用量统计</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:20.0172%;">`/init`</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:79.9352%;">使用 `CLAUDE.md` 指南初始化项目，让 Claude 记录项目约定、运行方式和注意事项</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:20.0172%;">`/compact`</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:79.9352%;">总结当前对话以释放上下文，适合长会话继续推进</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:20.0172%;">`/btw <question>`</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:79.9352%;">提出一个快速附加问题，不把问题加入主对话上下文</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:20.0172%;">`/model`</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:79.9352%;">选择或更改模型；支持的模型可调整工作量/思考等级</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:20.0172%;">`/clear`</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:79.9352%;">用空上下文开始新对话，之前的对话仍可通过 resume 恢复</td></tr><tr><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:20.0172%;">`/insights`</td><td style="border:1px solid rgb(208,215,222);padding:8px;vertical-align:top;width:79.9352%;">生成会话分析报告，包括项目领域、交互模式和摩擦点</td></tr></tbody></table>

### 6.4 Git 集成与 Diff 审查

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

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

<figure id="bkmrk-%E5%9B%BE-45%EF%BC%9A%E4%BB%8E%E7%95%8C%E9%9D%A2%E8%8F%9C%E5%8D%95%E8%BF%9B%E5%85%A5-diff%E3%80%82" style="margin:14px auto 22px auto;text-align:center;">[![图 46：从界面菜单进入 Diff。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/41.jpg)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/41.jpg)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 46：从界面菜单进入 Diff</figcaption></figure>Diff 视图中，绿色区域表示新增或替换后的内容，红色区域表示删除或替换前的内容。可以按文件查看改动，也可以围绕当前工作树或某轮 Claude 修改进行审查。

<figure id="bkmrk-%E5%9B%BE-46%EF%BC%9Adiff-%E8%A7%86%E5%9B%BE%E5%B1%95%E7%A4%BA%E6%96%87%E4%BB%B6%E6%94%B9%E5%8A%A8%E4%B8%8E%E6%96%B0" style="margin:14px auto 22px auto;text-align:center;">[![图 47：Diff 视图展示文件改动与新增代码。](https://docs.20020519.xyz/uploads/images/gallery/2026-05/scaled-1680-/42.jpg)](https://docs.20020519.xyz/uploads/images/gallery/2026-05/42.jpg)<figcaption style="text-align:center;color:#57606a;font-size:0.9em;margin-top:6px;">图 47：Diff 视图展示文件改动与新增代码</figcaption></figure>Windows 上如果 Code 选项卡提示 Git 错误，需要先参考 [Windows 系统 Git 安装教程](https://www.cnblogs.com/xueweisuoyong/p/11914045.html) 安装 Git for Windows，并重启 Claude Desktop；但日常查看 Diff 不要求你熟练掌握 Git 命令。

## 7. 参考资料

- [Claude 官方下载页](https://claude.com/download)
- [Claude Code Desktop 官方文档](https://code.claude.com/docs/zh-CN/desktop)
- [Claude Code 权限模式官方文档](https://code.claude.com/docs/zh-CN/permission-modes)
- [Claude Code Commands 官方文档](https://code.claude.com/docs/zh-CN/commands)
- [DeepSeek-V4 预览版发布说明](https://api-docs.deepseek.com/zh-cn/news/news260424)
- [DeepSeek Anthropic API 兼容说明](https://api-docs.deepseek.com/zh-cn/guides/anthropic_api)
- [DeepSeek 模型与价格官方页面](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/)

---

本文档允许非商业转载与分享，但需注明来源并保留作者署名。

```
来源：https://docs.20020519.xyz/books/claude-desktop-deepseek-v4
作者：zhiangxu1093@gmail.com
```