How to Install Claude Desktop on Linux (Ubuntu & Debian) — Complete Guide (2026)

Tested on: Claude Desktop for Linux (beta) — Last updated: July 2026

Anthropic released an official Claude Desktop app for Linux, currently in beta. It brings the same Chat, Cowork, and Code tabs available on macOS and Windows — parallel sessions, visual diff review, an integrated terminal and editor, and live app preview — to Linux for the first time as a first-party app.

Before you start: this beta only officially supports Debian-based distros. Ubuntu 22.04+ and Debian 12+ are supported; Fedora, RHEL, and Arch are not — yet. If you're on a non-Debian distro, skip to the community package section below, or use the Claude Code CLI instead, which supports a wider range of distros already.

Claude Desktop vs. Claude Code: What's the Difference

They run the same underlying Claude Code engine — the difference is entirely in interface and platform reach, not capability. If you already have Claude Code CLI set up and are happy in the terminal, there's no requirement to switch. Desktop adds value if you want visual diffs, a persistent GUI across sessions, or you're introducing Claude Code to someone less comfortable in a terminal.

Requirements

• Ubuntu 22.04 or later, or Debian 12 or later
• x86_64 or arm64 architecture
• A claude.ai subscription, or org SSO for enterprise deployments — a Console API key alone will not work with Desktop; use the CLI for API-key auth

Other Debian-based distros that meet these version requirements (Pop!_OS, Linux Mint, MX Linux, etc.) may work but aren't officially tested by Anthropic.

Step 1 — Add Anthropic's apt Repository

Installing through the repository means future updates arrive with your normal apt upgrade instead of manual reinstalls.

# If curl isn't installed yet
sudo apt install curl

# Download Anthropic's signing key
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc

# Register the repository
echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list

Optional — verify the key actually belongs to Anthropic before trusting it:

gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc
# Fingerprint should read: 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE

Step 2 — Install the Package

sudo apt update && sudo apt install claude-desktop

Step 3 — Launch and Sign In

Launch Claude from your application launcher, or run it directly:

claude-desktop

Sign in with your claude.ai account the same way you would on macOS or Windows. If your organization uses SSO, that flow works identically here.

Install From a Downloaded .deb Instead

If your network blocks downloads.claude.ai or you'd rather not add a new apt source, grab the package directly:

curl -fLO "https://downloads.claude.ai/claude-desktop/apt/stable/$(curl -s "https://downloads.claude.ai/claude-desktop/apt/stable/dists/stable/main/binary-$(dpkg --print-architecture)/Packages" | grep '^Filename: pool/main/c/claude-desktop/claude-desktop_' | sort -V | tail -n 1 | cut -d' ' -f2)"

sudo apt install ./claude-desktop_*.deb

A .deb installed this way won't receive updates through apt automatically. The package writes a commented-out repository entry to /etc/apt/sources.list.d/claude-desktop.list — uncomment its deb line if you want updates going forward, equivalent to doing Step 1 above.

Updating and Uninstalling

# Update — same as any other package
sudo apt update && sudo apt upgrade

# Uninstall
sudo apt remove claude-desktop
sudo rm /etc/apt/sources.list.d/claude-desktop.list

The desktop app has no self-update mechanism on Linux by design — everything goes through apt, same as the rest of your system.

Fedora, Arch, and Other Distros (Unofficial)

Anthropic's official beta is Debian-based only for now. For everyone else, aaddrick/claude-desktop-debian is a community project that repackages Anthropic's official .deb into formats for the rest of the ecosystem:

• Fedora / RHEL — .rpm via a DNF repository
• Arch Linux — available in the AUR as claude-desktop-appimage
• NixOS — a Nix flake with an FHS environment option
• Any distro — a distribution-agnostic AppImage

It's not affiliated with Anthropic, but it's actively maintained specifically to track the official releases — the project's own description is that Anthropic's package "covers one packaging target" while this fills in "a long tail of distros, desktops, and session types." It also adds a few things the official package doesn't ship on Linux yet: a launcher with better Wayland handling, GPU-crash recovery, and a --doctor diagnostic command for troubleshooting. Since this repackages Anthropic's binary rather than building Claude Desktop from scratch, you're still running the same app — just through a different install path.

What's Not in the Linux Beta Yet

• Computer Use — screen and app control isn't available on Linux
• Dictation — no voice input in the Linux desktop app; use voice dictation in the CLI instead
• Quick Entry global hotkey — works on X11. On native Wayland it needs your desktop environment's GlobalShortcuts portal, which not all DEs implement yet
• Fedora and RHEL — official support is coming, not available today (see the community packages above in the meantime)

For anything not yet in the desktop app, the Claude Code CLI runs the same underlying engine and already supports a wider range of distros.

Troubleshooting

apt reports "Unable to locate package claude-desktop"

The repository wasn't registered correctly. Check it directly:

cat /etc/apt/sources.list.d/claude-desktop.list
# Should show the deb line from Step 1 — if empty or missing, redo Step 1

dpkg --print-architecture
# Should print amd64 or arm64 — no other architecture is supported

If the file looks correct and apt update still fails, check its output for errors mentioning downloads.claude.ai — that points to a network or key verification issue rather than a missing repo entry.

The downloaded file command fails with "Remote file name has no length"

The package lookup returned nothing. Confirm your network can reach downloads.claude.ai and that dpkg --print-architecture prints amd64 or arm64 — the repository doesn't publish packages for anything else.

Desktop won't accept my Console API key

This is expected, not a bug — Claude Desktop only authenticates with a claude.ai subscription or organization SSO. If you're authenticating with an API key, you need the Claude Code CLI instead.

Frequently Asked Questions

Is Claude Desktop for Linux free?

The app itself is free to install. What you can do inside it depends on your claude.ai plan, same as the web and other desktop platforms.

Can I use Claude Desktop and Claude Code CLI at the same time?

Yes — they're separate installs with no conflict. Many developers use the CLI over SSH on remote servers and Desktop locally for visual diff review.

Does Claude Desktop work on Wayland?

Yes, the app itself runs fine on Wayland. The one feature that's affected is the Quick Entry global hotkey, which needs your desktop environment's GlobalShortcuts portal to work outside of X11.

When will Fedora and Arch be officially supported?

Anthropic hasn't published a timeline. Until then, the community-maintained aaddrick/claude-desktop-debian project covers both, repackaging the same official binary.