claude-desktop-debian

Overview

claude-desktop-debian is an unofficial repackaging project for running Claude Desktop on Linux. Since v3.0.0 it repackages Anthropic's official Linux .deb rather than the Windows installer, and builds additional formats Anthropic does not ship: RPM for Fedora/RHEL, distribution-agnostic AppImages, and a Nix flake for NixOS. It also adds a launcher and --doctor diagnostics for Linux-specific environment issues.

Key Features

• Repackages Anthropic's official Linux .deb into RPM and AppImage builds, with a Nix flake for NixOS.
• MCP support, with configuration stored at ~/.config/Claude/claude_desktop_config.json.
• Launcher adds opt-in native Wayland via CLAUDE_USE_WAYLAND=1, GPU-crash auto-recovery, XRDP detection, IM-module override, and autostart-entry healing.
• -doctor diagnostics check the display server, sandbox permissions, MCP config, stale locks, KVM/Cowork stack, and official-version drift.
• Cowork on Linux runs when KVM hardware virtualization is available, and the doctor reports readiness.
• System integration includes a global hotkey (Ctrl+Alt+Space) on X11 and Wayland, a system tray, and desktop-environment integration.

Use Cases

• Running Claude Desktop on Fedora or RHEL using the project's RPM package.
• Running Claude Desktop on distributions without official packages using an AppImage.
• Installing Claude Desktop on NixOS from the Nix flake.
• Diagnosing Linux-specific launch, display, sandbox, MCP, lock, and Cowork issues with --doctor.

Getting Started

• On Debian or Ubuntu, add the project's APT repository and install claude-desktop-unofficial for automatic updates.
• On Fedora or RHEL, add the project's DNF repository and install claude-desktop-unofficial.
• On NixOS, install from the GitHub flake, optionally using the claude-desktop-fhs variant for MCP server support.
• Pre-built .deb, .rpm, and .AppImage files are available on the Releases page.

Deployment & Requirements

• Linux is required; builds target Debian/Ubuntu via APT, Fedora/RHEL via RPM/DNF, any distribution via AppImage, and NixOS via the Nix flake.
• Cowork on Linux requires a KVM-backed VM and depends on KVM, QEMU, OVMF firmware, vhost-vsock, and virtiofsd.
• The unofficial package can be installed alongside Anthropic's official package, but the two share ~/.config/Claude and only one can run at a time.

Before You Adopt

• License: Apache-2.0. Review its terms before using, modifying, or distributing the project.
• This is an unofficial repackaging project, so official support should be sought from Anthropic for the Claude Desktop application.
• The project no longer publishes to the AUR, and its former claude-desktop-appimage package was deleted.
• Cowork depends on a KVM-backed VM and related components; the doctor can report which dependencies are installed or missing.
• Issue reports are sent to Anthropic's API by an automated triage bot, so users should avoid including credentials, tokens, personal data, or other sensitive content.