Claude Desktop 离线安装工具

一套 Windows 小脚本，帮你下载、安装、卸载 Claude 桌面版（Claude Desktop）。

不用懂命令行，双击 .bat 文件就能用。

---

这个工具是干什么的？

Claude Desktop 是 Anthropic 官方的 Windows 桌面应用。

从 Releases 下载的 zip 已自带 pkg\Claude.msix，解压即可离线安装，无需再下载。

你想做什么	双击这个文件
安装 Claude 桌面版	安装Claude桌面版.bat（根目录）
彻底卸载（含残留清理）	卸载Claude桌面版.bat（根目录）
更新 / 重新下载安装包（可选）	scripts\下载安装包.bat

---

目录结构

claude-code-desktop-offline/
├── 安装Claude桌面版.bat            # 安装入口（根目录，自动提权）
├── 卸载Claude桌面版.bat            # 卸载入口（根目录，自动提权）
├── scripts/                        # 脚本目录
│   ├── 下载安装包.bat              # 下载入口
│   ├── download-claude-msix.ps1    # 下载逻辑
│   ├── install-claude-desktop.ps1  # 安装逻辑
│   └── uninstall-claude-desktop.ps1# 卸载逻辑
├── pkg/                            # 安装包目录
│   └── Claude.msix                 # Release zip 已自带（约 200MB）
└── log/                            # 日志目录
    ├── download-claude-msix.log    # 下载日志（运行后自动生成）
    └── install-claude-desktop.log  # 安装日志（运行后自动生成）

• 根目录 .bat：日常用的入口，只有安装和卸载
• scripts/：PowerShell 脚本；下载安装包.bat 仅用于更新安装包
• pkg/：Claude.msix 安装包（Release zip 里已有）
• log/：运行日志，出问题时来这里查

---

快速开始（2 步）

适用于从 Releases 下载 zip 的用户。zip 里已包含 pkg\Claude.msix，不用先下载。

第 1 步：解压并安装

1. 解压 zip 到任意目录
2. 确认 pkg\Claude.msix 存在（Release 包自带）
3. 双击 安装Claude桌面版.bat
4. 弹出 UAC 提示时，点 「是」 授予管理员权限
5. 等待安装完成

第 2 步：重启电脑（很重要）

安装成功后，必须重启电脑，才能从开始菜单打开 Claude。

安装成功 ≠ 马上能用。MSIX 应用需要重启后才会完成注册。

---

需要更新安装包时（可选）

仅当 pkg\Claude.msix 缺失、损坏，或想升级到最新版时使用：

1. 双击 scripts\下载安装包.bat
2. 等待下载完成（需能访问 claude.ai）
3. 再运行 安装Claude桌面版.bat

若 pkg\Claude.msix 已存在，脚本会询问是否覆盖；输入 yes 才会重新下载。

---

系统要求

• 系统：Windows 10 / Windows 11（64 位）
• 权限：安装和卸载需要管理员权限（根目录 .bat 会自动申请）
• 磁盘：至少预留 500MB 空间（安装包约 200MB + 临时文件）
• 网络：Release zip 离线安装不需要联网；仅更新安装包时需要访问 https://claude.ai

---

卸载

想卸掉 Claude 桌面版（包括官方卸载器常留下的垃圾文件）：

1. 双击根目录的 卸载Claude桌面版.bat
2. 点「是」授予管理员权限
3. 看到确认提示后，输入 yes 并回车

默认会保留 C:\Users\你的用户名\.claude 目录（Claude Code 命令行工具的配置），不影响 CLI 使用。

高级卸载选项（PowerShell）

以管理员身份打开 PowerShell，进入 scripts 目录后：

# 跳过确认，直接卸载
.\uninstall-claude-desktop.ps1 -Force

# 同时删除 CLI 配置目录 ~/.claude
.\uninstall-claude-desktop.ps1 -Force -RemoveCliConfig

# 清理用户环境变量里的 ANTHROPIC_* 项
.\uninstall-claude-desktop.ps1 -Force -CleanEnvVars

---

常见问题

下载失败

可能原因：

1. 网络访问不了 claude.ai — 检查代理或 VPN
2. 公司防火墙拦截 — 联系 IT 放行 HTTPS 出站
3. 磁盘空间不够

解决办法：

• 查看 log\download-claude-msix.log 里的红字报错

• 或手动用浏览器打开下面链接，把文件保存为 pkg\Claude.msix：

  https://claude.ai/api/desktop/win32/x64/msix/latest/redirect
  

安装失败

可能原因：

1. pkg\Claude.msix 不存在或文件不完整（小于 150MB 多半有问题）
2. 旧版 Claude 残留（尤其是 CoworkVMService 幽灵服务）
3. 企业策略禁止侧载 MSIX

解决办法：

1. 先运行根目录的 卸载Claude桌面版.bat 彻底卸载
2. 重启电脑
3. 重新运行 scripts\下载安装包.bat 下载
4. 再运行 安装Claude桌面版.bat
5. 查看 log\install-claude-desktop.log

装好了但打不开 Claude

先重启电脑。如果重启后仍不行，运行卸载脚本清理后再重装。

安装和卸载有什么区别？

	安装脚本	卸载脚本
清理旧版 MSIX	会（为顺利安装）	会（彻底移除）
删除用户数据 / VM 残留	不会	会（含 Cowork 虚拟机数据，可能很大）
保留 CLI 配置	—	默认保留 ~/.claude

---

手动参数（可选）

在 scripts 目录下以 PowerShell 运行：

# 下载到 pkg 目录（默认）
.\download-claude-msix.ps1

# 下载到指定位置
.\download-claude-msix.ps1 -OutputPath "D:\Downloads\Claude.msix"

# 强制覆盖已有文件（不询问）
.\download-claude-msix.ps1 -Force

# 指定安装包路径
.\install-claude-desktop.ps1 -PackagePath "D:\Downloads\Claude.msix"

---

注意事项

• 本工具仅用于 Claude Desktop 桌面应用，不会卸载 claude-code-helper 托盘工具
• 安装包来自 Anthropic 官方 API，脚本只做下载和本地安装，不修改安装包内容
• 首次安装或升级后，重启是必要步骤，不是可选项
• 卸载脚本会清理 Cowork 虚拟机相关数据，可能释放数 GB 磁盘空间

---

典型使用场景

场景 A：Release 离线包安装（最常见）

解压 zip → 安装Claude桌面版.bat → 重启电脑 → 开始使用

场景 B：更新安装包后再装

scripts\下载安装包.bat → 安装Claude桌面版.bat → 重启电脑

场景 C：安装报错，想重来

卸载Claude桌面版.bat → 重启电脑 → 安装Claude桌面版.bat → 重启电脑

场景 D：只想卸载

卸载Claude桌面版.bat

---

许可说明

本仓库脚本以 CC BY-NC 4.0（署名-非商业性使用）协议发布，禁止商用。

Claude Desktop 软件本身由 Anthropic 提供，使用须遵守其服务条款。