claude-desktop-debian: the unofficial packaging layer under Claude Desktop for Linux

Who serves which package format

This repository does not build a Linux port of Claude Desktop. It takes the Linux build Anthropic publishes and repackages it into the formats Anthropic does not ship. The scope is stated in the first line: `.rpm` for Fedora and RHEL, distribution-agnostic AppImages, a Nix flake for NixOS, and an AUR package for Arch that is currently unavailable. The project calls itself an unofficial repackaging project and sends support questions to Anthropic.

The README settles who serves what in a table. Anthropic serves the `.deb` for Debian and Ubuntu on amd64 and arm64 through their own APT repository. This project serves the `.rpm`, the AppImage, the AUR entry and the Nix flake. Its own `.deb` mirrors the official one with extras added and is published under the package name `claude-desktop-unofficial` since v3.0.0, so it can sit beside Anthropic's `claude-desktop`. That coexistence has a catch worth knowing before installing both: the two packages share `~/.config/Claude`, so only one of them can run at a time.

What changed when Anthropic shipped its own Linux build

On 2026-06-30 Anthropic shipped a first-party Claude Desktop for Linux beta, distributed as a `.deb` for both amd64 and arm64 from their own APT repository. Before that date, this project existed because there was no official Linux build to wrap. Since v3.0.0 it repackages that official `.deb`, and it no longer repackages the Windows installer.

That event narrowed the job rather than ending it. An official APT repository covers one packaging target properly. What it leaves out is a long tail of distributions, desktop environments and session types, which the project catalogued from its own issue history in a survey of reported environments kept at `docs/reports/CDL-ANT-0009_patch-suite-history/reported-environments/grouped-families.md`. Covering that tail is the reason the project still exists, alongside a launcher and a `--doctor` for the Linux quirks the official package leaves alone. The README points at `docs/index.md` for the full documentation, with `CHANGELOG.md`, `CONTRIBUTING.md` and `SECURITY.md` beside it.

The launcher and the doctor flag

Every format the project builds carries the same two additions. The launcher handles Linux-specific failure modes: opt-in native Wayland through `CLAUDE_USE_WAYLAND=1`, GPU-crash auto-recovery, XRDP detection, an IM-module override, and healing of broken autostart entries. Each of those is opt-in or reactive rather than a change to default behaviour.

`claude-desktop-unofficial --doctor` is the other half. It checks the display server, sandbox permissions, the MCP config, stale locks, the KVM and Cowork stack, and drift between the packaged app and the official release. Cowork on Linux is gated on KVM hardware virtualization being available, and the doctor reports host readiness for it. Model Context Protocol support comes from the official application, with config at `~/.config/Claude/claude_desktop_config.json`. Desktop integration is listed alongside: a global hotkey on Ctrl+Alt+Space for X11 and Wayland, a system tray icon, and desktop-environment integration.

The five patches that survived

The app itself is the official `app.asar`, and the project holds patches to one rule: a patch has to justify itself against the official bytes or get deleted. Most of the pre-v3.0.0 patch suite was deleted when Anthropic shipped official Linux builds. Five remain.

The virtiofsd patch fixes Cowork detection. Upstream probes only `/usr/libexec/virtiofsd` and `/usr/bin/virtiofsd`, falling back to its bundled copy only when `/etc/os-release` reports Ubuntu 22.x, so Arch at `/usr/lib/virtiofsd` and Debian at `/usr/lib/qemu/virtiofsd` draw a false requires-QEMU message on a complete KVM stack; dropping the os-release gate fixes it while still preferring system paths. The org-plugins patch adds a `linux` case to a platform switch whose default returns null, resolving `/etc/claude/org-plugins` so the feature stops being silently dead. The tray patch threads `CLAUDE_TRAY_USE_DARK_ICON` into upstream's own selector so Cinnamon, which can pair a dark panel with a light GTK colour scheme, gets the right glyph. Quick Entry focus adds a `blur()` before `hide()` on the pop-up window to work around an Electron focus bug on KDE. The fifth is opt-in: a Cowork bubblewrap backend selected with `COWORK_VM_BACKEND=bwrap` for hosts without KVM or vhost-vsock, with every branch gated so an unflagged launch runs the upstream path unchanged. The first three have been filed upstream.

A maintainer handover on a personal account

Maintainership changed without the repository moving. As of September 2026, @sabiut leads the project and has final say on direction, releases and what lands. @aaddrick, the original author and current account owner, is stepping back to focus on other work. The repository stays at `aaddrick/claude-desktop-debian` at @sabiut's request, so existing APT and DNF sources, issue links and clone remotes keep working. Publishing surfaces list both people in `CODEOWNERS`.

The interesting constraint is what a repository on a personal account cannot hand over. Such an account has only two access levels, owner and collaborator, so repository settings, branch protection, Actions secrets and security advisories all still need the outgoing owner to act. Releases are automatic, and version variables are settable by any collaborator through `gh variable set`, so day-to-day publishing does not route through one person. A `worker/` directory at the top of the tree suggests the packages are served through a Cloudflare Worker, and those credentials remain with the original owner. How much that matters depends on how available he stays rather than on anything technical.

Release tags and the split between wrapper and app version

Tags use a two-part scheme that says exactly what moved. `v3.2.4+claude2.2553.1`, published 2026-09-19, packages Claude Desktop 2.2553.1. `v3.2.4+claude2.110.0` on 2026-09-16 packages 2.110.0. The wrapper version sat at 3.2.4 across both, which is the clearest signal available that the packaging layer is stable and the churn is upstream. A third release on 2026-09-14, `v3.2.4+claude1.52386.6`, shows the app version moving again, consistent with a beta channel in motion. Each release body repeats the same install block covering APT, DNF, AUR and manual download.

The repository is Apache-2.0 licensed and written mostly in Shell, with `build.sh`, `scripts/`, `tests/`, `tools/`, `nix/` and `worker/` at the top level. It is not archived and the last push was on 2026-09-21, so work is landing. It has 5,401 stars, 525 forks and 16 open issues, which for a packaging project is a wide audience and a short issue list.

The fair summary is that this is a distribution shim rather than a port. On Debian or Ubuntu you can add Anthropic's APT repository yourself and decide whether a launcher and a doctor are worth a second package. On Fedora, NixOS, or a distro where AppImage is the only workable option, this repository is the reason it works, and the five surviving patches are the reason it works properly.

Editorial conclusion

claude-desktop-debian is worth reading because its scope is narrow and stated plainly: it takes Anthropic's official Linux .deb and repackages it, adds a launcher and a doctor flag, and keeps five patches alive that each have a concrete upstream bug behind them. What it does not do is own the application. Every release is an upstream version bump with the wrapper version pinned, so the packaging layer stays quiet while the app itself moves. The documentation split is settled as well: the README settles who serves which format and what each patch fixes, while install detail and the environment survey live under docs/. Start by deciding whether your distribution is in the long tail at all, then read the patch list before turning anything on, since each of the five changes is opt-in or reactive rather than a default behaviour change.

Frequently asked questions

Official sources

1. aaddrick/claude-desktop-debian on GitHub
2. Issues
3. License: Apache-2.0
4. README
5. Releases