Anthropic 的 Claude Desktop Linux 测试版目前只以面向 Debian 和 Ubuntu 的 .deb 软件包发布。claude-desktop-rpm 是一个小型 Bash 脚本,用它在 Fedora 上安装同一个应用。本文说明脚本会在安装前校验什么、会在系统中留下什么,以及怎样把它移除。

开始之前:许可、账户与支持范围

  • 许可与来源:Claude Desktop 是 Anthropic 的专有软件,按 Anthropic 自己的条款发布。本文介绍的安装脚本采用 MIT 许可证,并非 Anthropic 制作,也不重新分发 Anthropic 的任何文件——每次安装都从 Anthropic 自己的仓库下载软件包。
  • 账户与付费方案:使用应用需要一个 Claude 账户。聊天功能在包括免费方案在内的所有方案中可用;Claude Code 和 Cowork 这两项多数人安装桌面应用所看重的功能,需要付费方案(Pro、Max、Ultra、Team 或 Enterprise)。Anthropic 的下载页面列出了当前方案和价格。
  • 权限:准备依赖时会用到 sudo;脚本自身的安装流程不使用 sudo。配置 Cowork 的步骤会使用 sudo,并修改 /etc、加载内核模块、把当前用户加入 kvm 组。
  • 支持范围:Anthropic 目前只为 Debian 和 Ubuntu 提供官方支持,Fedora 上的这条路径并非官方支持。

如果你更愿意用自由和开源软件完成这类工作,也有能在 Fedora 上运行的选择,例如 OpenCode 和 Hermes Agent。本文面向已经在使用 Claude、并希望在 Fedora 上使用官方应用的用户。

安装前的校验链

Anthropic 把 Linux 测试版发布为带签名的 APT 仓库。脚本会像 APT 那样读取该仓库,任何一项检查失败都会停止:

  1. Anthropic 的公钥必须与脚本中固定的指纹一致。
  2. 仓库索引(InRelease)必须由该密钥签名,且其 Valid-Until 日期不能已过。
  3. 软件包列表的校验和必须与已签名的索引一致。
  4. .deb 的校验和必须与软件包列表一致。

只有全部检查通过,脚本才会解包 .deb。Fedora Discussion 上的一位读者发现第一版存在一个缺口:索引可以由密钥文件中的任意密钥签名,而不必是固定的那一把。该问题已修复,测试套件现在会针对仓库的篡改副本逐项运行这些检查。

安装:准备依赖、校验并运行脚本

脚本需要四个软件包,多数 Fedora Workstation 系统已经具备。准备这四个软件包时会用到 sudo;可以先确认它们可用:

sudo dnf install curl gnupg2 binutils tar

接下来,把最新发行版中的 Claude 脚本下载到一个目录。脚本自身的安装流程不使用 sudo;它会把应用、启动器、菜单项和图标写入 ~/.local,把更新用的 systemd 用户定时器写入 ~/.config,并把自身复制到 ~/.local/bin/claude-desktop-rpm。以普通用户身份运行:

curl -fLO https://github.com/ajithakdev/claude-desktop-rpm/releases/latest/download/claude-desktop-rpm.sh
chmod +x claude-desktop-rpm.sh && ./claude-desktop-rpm.sh install

每个发行版还会发布校验和文件 SHA256SUMS。要在运行前检查下载的脚本,把该文件取到存放脚本的同一目录并比对:

curl -fLO https://github.com/ajithakdev/claude-desktop-rpm/releases/latest/download/SHA256SUMS
sha256sum -c SHA256SUMS

脚本是单个 Bash 文件,因此你也可以在运行前先读一遍。

安装完成后,从应用菜单打开 Claude 并登录。如果发现异常,运行:

claude-desktop-rpm doctor

它会检查安装、启动器、自动更新、托盘图标、保存登录信息的密钥环,以及 Cowork 的前置条件;每条警告都附带修复它的命令。

GNOME 下的深色模式与托盘图标

在 GNOME 上,即使桌面设为深色,应用仍保持浅色。Linux 上的 Electron 应用读取 GTK 主题名称,而 GNOME 的深色样式不会改变这个名称:它设置的是一个单独的 color-scheme 偏好,Electron 会忽略它。

脚本不会改动 Anthropic 的文件。它创建的启动器会在启动应用时检查 GNOME 的 color-scheme 设置,仅在深色下为 Claude 设置 GTK_THEME=Adwaita:dark。如果你自己设置了 GTK_THEME,启动器不会覆盖它。

GNOME 默认还会隐藏托盘图标,而 Claude 的托盘菜单正是“退出”所在之处。doctor 命令会告诉你在需要图标时如何启用 AppIndicator 扩展。

配置 Cowork:需要 sudo 和内核模块

Cowork 在一个小型虚拟机中运行任务,因此需要 KVM、QEMU、UEFI 固件和 virtiofsd。在 Fedora 上,这些全部来自 Fedora 自己的仓库。

配置 Cowork 会修改 /etc、加载内核模块并把当前用户加入 kvm 组,因此需要 sudo;脚本自身的安装流程不使用 sudo。下面这条命令只需运行一次:

claude-desktop-rpm cowork

它执行以下步骤:

  • 用 dnf 安装 qemu-system-x86-core、edk2-ovmf 和 virtiofsd
  • 写入 /etc/modules-load.d/vhost_vsock.conf 并加载 vhost_vsock 模块
  • 把你加入 kvm 组

注销并重新登录,组变更才会生效。该命令不会改动任何由软件包拥有的文件,因此 rpm -V 保持干净。较早的版本确实替换过 edk2-ovmf 附带的两个固件链接;那是个错误,当前版本如果发现旧链接,会恢复软件包自带的链接。

预留磁盘空间

应用的 Cowork 虚拟机文件在 ~/.config/Claude 中占用约 12 GB。

自动更新与每日检查

脚本会安装一个 systemd 用户定时器,每天检查一次 Anthropic 的仓库。每次更新都经过与首次安装相同的检查。如果更新到达时 Claude 正在运行,脚本会下载并验证更新,但会等待;启动器会在你下次启动应用时把它放到位。

要关闭或重新开启每日检查,使用以下命令:

claude-desktop-rpm auto-update off
claude-desktop-rpm auto-update on

注意:如果应用显示自己的“Update available”按钮,请忽略它,它的链接指向 APT。更新由定时器处理,或者你可以退出 Claude 并运行 claude-desktop-rpm update。

用账户配置区分工作与个人账号

有些人会为工作和个人使用保留不同的 Claude 账户。版本 1.2.0 为此增加了配置(profile):

claude-desktop-rpm profile add work

这会在应用菜单中添加“Claude (work)”。它使用自己的登录信息,聊天记录位于 ~/.config/Claude-work,并且可以与正常的 Claude 窗口同时运行。启动器通过传递 Chromium 的 --user-data-dir 标志来实现这一点。Anthropic 并未为 Claude Desktop 记录该标志,因此未来版本可能会忽略它;若真如此,两个菜单项都会打开你的正常账户,不会丢失任何内容。两个托盘图标的外观也相同;托盘菜单会显示每个账户的方案,可用来区分它们。

尚未支持的功能与测试范围

  • Computer Use 尚未出现在 Anthropic 面向任何发行版的 Linux 构建中。
  • 脚本在 Fedora 44 Workstation(GNOME、x86_64)上测试过,其自动化安装测试也在 Fedora 45 上通过。一位用户报告它在 Aurora(一个原子化 Fedora 变体)的 KDE Plasma 上可用。其他桌面环境和基于 RHEL 的系统尚未充分测试。
  • Anthropic 目前仅正式支持 Debian 和 Ubuntu。如果更新后出现问题,问题可能出在脚本上,因此请到项目的问题跟踪器报告,而不是报告给 Anthropic。(项目链接见下方“相关链接”一节。)

卸载与残留清理

下面的卸载命令会移除安装添加到 ~/.local 和 ~/.config 的所有内容,包括定时器和任何配置文件的菜单项,并重建菜单、文件类型和图标缓存;它不会删除聊天记录和登录信息。

claude-desktop-rpm uninstall

你在 ~/.config/Claude 中的聊天记录和登录信息会保留,以备重新安装。要一并删除,请删除该目录(以及任何 Claude-NAME 目录)。

卸载从不使用 sudo,因此 Cowork 那一步的配置会保留下来:如果不再需要,用 dnf 移除相关软件包,并删除 /etc/modules-load.d/vhost_vsock.conf。

相关链接

AI 使用说明

Assisted-by: Claude(为脚本和本文提供起草帮助;作者审阅了每一部分,并在 Fedora 44 上测试了每条命令)。