首页 > 教程攻略 > ai教程 >Claude Desktop 国内安装教程(Windows,2026)

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

来源:互联网 时间:2026-08-11 07:32:58

为什么官网装不上

官网下载安装按钮提供的 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.aiSHA256 校验:按来源比对官方校验值,确认 MSIX 是官方签名包、未二次重打包安装 MSIX:优先机器范围注册(所有用户可用),失败自动回退用户级补全组件:检测到无 Node.js 时从 npm 镜像安装,然后安装 @anthropic-ai/claude-code,把 claude.exe 复制到桌面端期望目录并创建 .verified 标记,修复 Host Claude Code binary not a vailable 报错创建桌面快捷方式(可选)配置推理端点:交互式提示,可跳过下载缓存:MSIX 与 Node 安装包缓存到本地,重复运行秒过

操作步骤

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

安装过程示意

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 a vailable若配置过推理端点,检查配置是否写入:
reg query HKCUSOFTWAREPoliciesClaude

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

常见问题

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

如果提示无法探测 claude-code 版本,可以改为

手动指定

-ClaudeCodeVersion 参数。
版本号可直接从 Claude-3plogsmain.log 中查看后再填写。

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

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

注意事项

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