This repository provides build scripts for packaging the Claude Desktop application for Debian-based Linux distributions, offering both .deb packages and self-contained AppImages. It targets Linux users who want to run Claude Desktop natively, simplifying installation and integration with desktop environments.

How It Works

The build process unpacks the official Windows Electron application, replaces Windows-specific native modules with Linux-compatible stubs, and then repackages the application into either a .deb file or an AppImage. This approach leverages the cross-platform nature of Electron, addressing the primary challenge of a missing native Linux client.

Quick Start & Requirements

• Install via git clone and running ./build.sh (defaults to .deb, cleans build files).
• Requires a Debian-based Linux distribution (Debian, Ubuntu, Mint, etc.).
• Dependencies are automatically installed by the script.
• See: GitHub Releases

Highlighted Details

• Supports MCP (My Claude Preferences) configuration.
• Supports Ctrl+Alt+Space popup and tray menu functionality.
• Builds .deb packages for standard installation and AppImages for portability.
• Includes a --no-sandbox flag for Electron, with discussion on alternatives.

Maintenance & Community

• Uses GitHub Actions for automated releases upon tagged commits.
• Encourages feedback and issue reporting for build process problems.
• Mentions inspiration from NixOS implementations and an alternative Debian fork.

Licensing & Compatibility

• Build scripts are dual-licensed under MIT and Apache License 2.0.
• The Claude Desktop application itself is subject to Anthropic's Consumer Terms.
• Compatible with commercial use for the build scripts; application terms may vary.

Limitations & Caveats

The AppImage login functionality requires manual setup or tools like AppImageLauncher due to the --no-sandbox flag. The project relies on a title bar fix from another repository.