Claude Desktop 国内安装教程(Windows,2026)

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/

安装器会自动做的事

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

操作步骤

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

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

常用参数

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

验证是否装好

  1. 打开 Claude Desktop,能正常进入对话界面,不再提示Host Claude Code binary not available
  2. 若配置过推理端点,检查配置是否写入:
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 的网络环境
  • 第三方推理端点属于自备基础设施或自选服务,安全、合规、费用自行评估