How to Use Claude on Linux | Complete Guide from .deb to Official CLI

Claude on Linux — Official Support Is CLI Only

Anthropic's official Claude Code desktop app documentation is explicit:

"The desktop app is not available on Linux; use the CLI instead."

The official desktop app supports only macOS (Universal / Intel + Apple Silicon) and Windows (x64 / ARM64). For Linux, Anthropic's official recommendation is to use the CLI.

Note that the CLI and the official desktop app share the same engine, and their configuration files — CLAUDE.md, MCP servers, hooks, skills, and settings — are interchangeable. Features exclusive to the desktop app GUI (Cowork tab, visual diff, live preview, etc.) are not available in the CLI, but all major coding assistance features work fully in the CLI.

Installing the Official CLI (All Linux Distributions)

The official CLI is installed via npm. Node.js 18 or higher is required.

# If Node.js is not installed (Ubuntu/Debian-based)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Install Claude Code CLI
npm install -g @anthropic-ai/claude-code

# Verify installation
claude --version

After installation, running the claude command triggers browser-based authentication — just log in to your Anthropic account to get started. Note that a Pro, Max, Team, or Enterprise plan is required; the Free plan does not support CLI access.

The CLI supports both interactive mode (claude) and one-shot mode (claude -p "..."), and can be embedded in scripts via pipes — a natural fit for Linux workflows.

Updating, Uninstalling, and Fixing PATH Issues

# Update
npm update -g @anthropic-ai/claude-code

# Uninstall
npm uninstall -g @anthropic-ai/claude-code

If you see claude: command not found, the npm global bin directory may not be in your PATH. Check and fix it as follows:

# Check npm global bin directory
npm config get prefix
# Example output: /home/user/.npm-global

# Add the bin/ path to PATH (append to .bashrc / .zshrc)
export PATH="$(npm config get prefix)/bin:$PATH"

After adding the line, reload your shell with source ~/.bashrc (or source ~/.zshrc).

What Is the Unofficial claude-desktop-debian?

aaddrick/claude-desktop-debian is a community project that downloads the official Windows Claude Desktop (an Electron app), replaces Windows-native modules with Linux-compatible ones, and repackages the result. No Wine or virtualization is required — it runs as a native Linux package.

Note: claude-desktop-debian is a Linux port of the chat-focused Claude Desktop (the app with conversation, Cowork, and MCP management UI) — it is separate from Claude Code (the coding agent CLI). For coding assistance, use the official CLI.

Specifications as of May 2026:

This unofficial package fills a gap left by the official offering, but use is entirely at your own risk and is not covered by Anthropic support.

Installation Instructions by Distribution

Debian / Ubuntu / Linux Mint (APT)

Adding the APT repository is the easiest approach.

# Add the GPG key
curl -fsSL https://pkg.claude-desktop-debian.dev/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/claude-desktop.gpg

# Add the repository
echo "deb [signed-by=/usr/share/keyrings/claude-desktop.gpg] https://pkg.claude-desktop-debian.dev/apt stable main" | \
  sudo tee /etc/apt/sources.list.d/claude-desktop.list

# Install
sudo apt update && sudo apt install claude-desktop

If you need to migrate from the old URL: In April 2026, the APT repository URL changed from aaddrick.github.io/claude-desktop-debian to pkg.claude-desktop-debian.dev. If you are using the old URL, update your sources.list entry.

Fedora / RHEL / CentOS (DNF)

# Add the repository file
sudo dnf config-manager --add-repo https://pkg.claude-desktop-debian.dev/rpm/claude-desktop.repo

# Install
sudo dnf install claude-desktop

DNF automatically redirects to the new URL, so the old configuration should still work in most cases — but updating to the new URL explicitly is recommended.

Arch Linux (AUR)

# Using yay
yay -S claude-desktop-appimage

The AUR package uses an AppImage-based build. Enabling the AppImage login feature may require a desktop integration tool such as Gear Lever.

NixOS (Nix Flake)

nix profile install github:aaddrick/claude-desktop-debian

When using MCP servers on NixOS, you need to use the claude-desktop-fhs FHS environment wrapper, since NixOS resolves package paths differently from standard Linux.

Manual Download (AppImage / .deb / .rpm)

You can also download the latest .deb / .rpm / AppImage directly from GitHub Releases (github.com/aaddrick/claude-desktop-debian/releases). This is useful for environments that do not rely on a particular package manager, or when you need to pin a specific version.

Configuring MCP, Global Hotkeys, and the System Tray

The unofficial Linux Desktop has full support for MCP (Model Context Protocol). Place the configuration file at the following path:

// ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]
    }
  }
}

The global hotkey Ctrl+Alt+Space brings Claude to the foreground from any window. Both X11 and Wayland (via XWayland) are supported.

System tray integration is available as well. The "minimize to tray" feature keeps MCP servers and schedulers running in the background even after closing the window — handy for long-running workflows.

A diagnostic command claude-desktop --doctor is provided to automatically check for issues with the display server, sandbox settings, and MCP configuration.

Known Limitations

Font Rendering Quality

As noted in a review on ludditus.com, font rendering on Linux may be lower quality compared to the macOS and Windows versions. This is a structural issue stemming from porting an Electron app to Linux and is difficult to resolve fundamentally at this time.

Token Usage Tracking

There is no way to monitor token usage in real time through the GUI. To track usage, you must check Anthropic's Console separately.

Wayland and Global Hotkeys

In a pure Wayland environment (without XWayland), global hotkeys may not work. Most major distributions ship XWayland by default, but minimal setups may require enabling it manually.

No Official Support

As long as you are using the unofficial package, Anthropic support is not available. File bug reports on the claude-desktop-debian GitHub Issues page.

Official CLI (Coding) vs. Unofficial Desktop (Chat) — Choosing by Use Case

The CLI excels at script and CI/CD integration, aligning well with Linux's design philosophy. The unofficial Desktop offers everyday convenience through GUI-based MCP management and system tray persistence. Using both depending on the situation is the best approach.

Summary

• Anthropic's official desktop app does not support Linux. The official recommendation is the CLI.
• The official CLI can be installed via npm on all distributions and covers all major features.
• The unofficial claude-desktop-debian provides a GUI via .deb / .rpm / AppImage / AUR / Nix (4,000+ stars).
• MCP, global hotkeys, and system tray integration are supported and functional at a practical level.
• Be aware of limitations around font quality, token tracking, and Wayland support before using.