为什么官网装不上
官网下载按钮给的 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 的网络环境
- 第三方推理端点属于自备基础设施或自选服务，安全、合规、费用自行评估
