全库搜索 Markdown 图册
Paper Analysis · 2 分钟阅读

Claude Desktop Windows 安装失败解决

站内编号 KB-000104
ClaudeClaude-DesktopClaude-CodeWindows安装问题troubleshooting
板块与文章导航

来源:Claude Desktop app安装错误解决,Windows下安装Claude Cowork、Claude Codex
相关官方文档:Claude Code Desktop app

问题现象#

在 Windows 上安装 Claude Desktop,用于配合 Claude Cowork / Claude Code 时,官方安装程序可能报错:

Download failed. Check your internet connection and try again.

Diagnostic log saved to:
C:\Users\winston\AppData\Local\Temp\ClaudeSetup.log

原因理解#

Claude Desktop 的 Windows 安装程序采用的是:

引导程序 + 在线下载

也就是说,官网下载到的小体积 .exe 本身并不包含完整应用。运行时它会联网去服务器拉取完整安装包。

因此,如果当前网络环境存在以下情况,就可能导致安装失败:

  • 代理或 VPN 配置不稳定;
  • 防火墙或杀毒软件拦截;
  • 无法访问安装包所在 CDN;
  • storage.googleapis.com 访问异常;
  • 引导程序本身没有正确走系统代理。

解决方案#

方案一:基础排查#

先尝试以下简单处理:

  1. 关闭 VPN / 代理后重新安装;
  2. 如果在国内环境,反过来尝试开启代理;
  3. 暂时关闭杀毒软件和防火墙;
  4. 右键安装程序,选择「以管理员身份运行」。

如果仍然失败,建议直接使用方案二。

推荐方案:直接下载 MSIX 手动安装#

这是原教程中推荐、也更稳定的方式:绕过有问题的 .exe 引导安装程序,直接下载完整的 MSIX 安装包。

步骤 1:下载 MSIX 安装包#

用浏览器访问:

https://claude.ai/api/desktop/win32/x64/msix/latest/redirect

浏览器会自动跳转并下载最新版 Claude Desktop 的 Windows MSIX 包。

注意:下载完成后,不要直接双击打开。

步骤 2:用管理员 PowerShell 安装#

在 Windows 搜索栏输入 PowerShell,右键选择:

以管理员身份运行

然后执行:

Add-AppxPackage -Path "C:\Users\你的用户名\Downloads\Claude.msix"

需要把路径替换成你实际下载的 MSIX 文件路径。

例如,如果文件在下载目录,且用户名是 Han,可能是:

Add-AppxPackage -Path "C:\Users\Han\Downloads\Claude.msix"

如果命令执行后没有报错,只是光标回到新行,通常说明安装成功。

如果提示需要开发者模式#

安装 MSIX 时如果遇到权限错误,可以打开 Windows 开发者模式:

Windows 设置 → 系统 → 开发者选项 → 开发人员模式

打开后,重新执行:

Add-AppxPackage -Path "C:\Users\你的用户名\Downloads\Claude.msix"

关键结论#

  • 官方 .exe 安装失败,不一定是 Claude Desktop 不能安装;
  • 常见原因是引导程序联网下载完整包失败;
  • 直接下载 MSIX 并用 PowerShell 安装,通常更可靠;
  • 国内网络环境下,浏览器下载往往比安装器更容易正确处理代理。

相关链接#

关联笔记#

  • API/Claudecode/简单将任意模型接入Claude Code.md