来源: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访问异常;- 引导程序本身没有正确走系统代理。
解决方案#
方案一:基础排查#
先尝试以下简单处理:
- 关闭 VPN / 代理后重新安装;
- 如果在国内环境,反过来尝试开启代理;
- 暂时关闭杀毒软件和防火墙;
- 右键安装程序,选择「以管理员身份运行」。
如果仍然失败,建议直接使用方案二。
推荐方案:直接下载 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