claude-desktop-debian

项目简介

claude-desktop-debian 是用于在 Linux 上运行 Claude Desktop 的非官方重新打包项目。自 v3.0.0 起，它重新打包 Anthropic 官方 Linux .deb，而不再打包 Windows 安装程序；同时构建 Anthropic 未提供的 RPM（Fedora/RHEL）、通用 AppImage 和 NixOS 的 Nix flake。项目还提供启动器和 --doctor 诊断，用于处理 Linux 特定环境问题。

核心功能

• 将 Anthropic 官方 Linux .deb 重新打包为 RPM 和 AppImage，并为 NixOS 提供 Nix flake。
• 支持 MCP，配置位于 ~/.config/Claude/claude_desktop_config.json。
• 启动器支持通过 CLAUDE_USE_WAYLAND=1 选择原生 Wayland，提供 GPU 崩溃自动恢复、XRDP 检测、IM 模块覆盖和自启动项修复。
• -doctor 诊断会检查显示服务器、沙箱权限、MCP 配置、过期锁、KVM/Cowork 栈和官方版本漂移。
• 当 KVM 硬件虚拟化可用时，Cowork 可在 Linux 上运行，doctor 会报告就绪情况。
• 系统集成包括 X11 和 Wayland 上的全局快捷键 Ctrl+Alt+Space、系统托盘和桌面环境集成。

适用场景

• 在 Fedora 或 RHEL 上通过项目的 RPM 包运行 Claude Desktop。
• 在没有官方包的发行版上通过 AppImage 运行 Claude Desktop。
• 在 NixOS 上通过 Nix flake 安装 Claude Desktop。
• 使用 --doctor 诊断 Linux 特有的启动、显示、沙箱、MCP、锁和 Cowork 问题。

快速开始

• 在 Debian 或 Ubuntu 上，添加项目的 APT 仓库并安装 claude-desktop-unofficial，以获得自动更新。
• 在 Fedora 或 RHEL 上，添加项目的 DNF 仓库并安装 claude-desktop-unofficial。
• 在 NixOS 上，从 GitHub flake 安装，可选择 claude-desktop-fhs 变体以支持 MCP 服务器。
• 预构建的 .deb、.rpm 和 .AppImage 文件可从 Releases 页面获取。

部署与要求

• 需要 Linux；构建目标包括通过 APT 的 Debian/Ubuntu、通过 RPM/DNF 的 Fedora/RHEL、通过 AppImage 的任意发行版，以及通过 Nix flake 的 NixOS。
• Linux 上的 Cowork 需要 KVM 支持的虚拟机，并依赖 KVM、QEMU、OVMF 固件、vhost-vsock 和 virtiofsd。
• 非官方包可与 Anthropic 官方包同时安装，但两者共享 ~/.config/Claude，因此同一时间只能运行一个。

采用前须知

• 许可证：Apache-2.0。在使用、修改或分发项目前，请确认其具体条款。