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