Claude Desktop 国内一键安装教程（Windows，2026）

VirtualHotBar

为什么官网装不上

官网下载按钮给的 ClaudeSetup.exe 只有约 7MB，它是在线引导器，运行后还要从 downloads.claude.ai 二次拉取真正的 MSIX 安装包。这个域名在部分网络下不可达，所以安装会卡在"正在下载"。

解决办法：用开源的 Claude Desktop 安装器，直接拿到可离线安装的官方签名 MSIX 装上，并自动补全缺失组件。

安装前准备

• Windows 10/11 64 位
• 管理员权限（MSIX 安装需要）
• 网络：能访问镜像源或官方源之一即可
  

用开源安装器安装（全程自动）

安装器项目（GitHub 开源，附源码与构建脚本）：

• 项目仓库：https://github.com/l1i1/ClaudeDesktop-Installer
• 使用说明与下载：https://l1i1.github.io/ClaudeDesktop-Installer/
  

安装器会自动做的事

• 多源回退下载：依次尝试 GitHub 镜像 → Cloudflare R2 → 官方 redirect，直接下载自包含的 .msix，不经过被墙的 downloads.claude.ai
• SHA256 校验：按来源比对官方校验值，确认 MSIX 是官方签名包、未二次重打包
• 安装 MSIX：优先机器范围注册（所有用户可用），失败自动回退用户级
• 补全组件：检测到无 Node.js 时从 npm 镜像安装，然后安装 @anthropic-ai/claude-code，把 claude.exe 复制到桌面端期望目录并创建 .verified 标记，修复 Host Claude Code binary not available 报错
• 创建桌面快捷方式
• （可选）配置推理端点：交互式提示，可跳过
• 下载缓存：MSIX 与 Node 安装包缓存到本地，重复运行秒过
  

操作步骤

• 从上面的仓库页下载 ClaudeDesktop-Installer.exe
• 双击运行，UAC 弹窗点"是"
• 安装器自动执行：下载 MSIX → 校验 SHA256 → 静默安装 → 检测 Node.js → 安装 claude-code 并修复 → 创建桌面快捷方式
• 若提示配置推理端点，按提示回车或填你自己的端点（不需要可直接跳过）
• 完全退出 Claude Desktop（含系统托盘图标）再重新打开，开始使用
  

已安装过的环境重复运行会命中缓存并跳过已完成步骤，可以安全重复执行。

常用参数

-SkipClaudeCode     只装桌面端，跳过组件修复
-SkipNodeJs         使用系统已有 Node.js
-NodeVersion vX.Y.Z 指定 Node 版本
-ClaudeCodeVersion .  手动指定 claude-code 版本
-Mirror ...         指定下载源优先级（github / r2 / official）
-SkipChecksum       跳过校验（不建议）
-SkipApi            跳过推理端点配置复制
验证是否装好

• 打开 Claude Desktop，能正常进入对话界面，不再提示 Host Claude Code binary not available
• 若配置过推理端点，检查配置是否写入：
  

reg query HKCU\SOFTWARE\Policies\Claude

正常情况下应能看到 inferenceProvider 等键值。

常见问题

所有下载源都失败？
检查系统代理与 DNS；可在可访问网络的环境下载 MSIX 后交给安装器离线安装，或挂代理后 -Mirror official 直连官方。

提示无法探测 claude-code 版本？
手动指定 -ClaudeCodeVersion 参数（版本可从 Claude-3p\logs\main.log 查看）。

npm install 失败？
检查 npm 镜像连通性，确认 Node 已进 PATH，必要时清理全局缓存重试。

安装后部分高级能力不可用？
若组策略限制 MSIX 侧载，机器范围注册会失败并回退用户级，这属于系统策略限制。

注意事项

• 任何镜像包都必须做 SHA256 校验，安装器已内置；不要使用来源不明、无法校验的改包
• 需要 Windows 10/11 64 位与管理员权限
• 本教程只覆盖安装与组件补全；登录账号与日常使用仍需能访问 Anthropic 的网络环境
• 第三方推理端点属于自备基础设施或自选服务，安全、合规、费用自行评估