aaddrick/claude-desktop-debian
GitHub: aaddrick/claude-desktop-debian
将 Claude Desktop 客户端打包为多种 Linux 发行版可用的原生应用，支持 MCP 协议和系统深度集成。
Stars: 2238 | Forks: 295
# Claude Desktop Linux 版
本项目提供了用于在 Linux 系统上原生运行 Claude Desktop 的构建脚本。它将官方 Windows 应用程序重新打包为 Linux 发行版可用格式，生成 `.deb` 包、`.rpm` 包 (Fedora/RHEL)、发行版无关的 AppImage、Arch Linux 的 [AUR 包](https://aur.archlinux.org/packages/claude-desktop-appimage)以及 NixOS 的 Nix flake。
**注意：** 这是一个非官方的构建脚本。如需官方支持，请访问 [Anthropic 的网站](https://www.anthropic.com)。如果遇到构建脚本或 Linux 实现相关的问题，请在本仓库中 [提交 issue](https://github.com/aaddrick/claude-desktop-debian/issues)。
## 功能特性
- **原生 Linux 支持**：无需虚拟化或 Wine 即可运行 Claude Desktop
- **MCP 支持**：完整的 Model Context Protocol 集成
配置文件位置：`~/.config/Claude/claude_desktop_config.json`
- **系统集成**：
- 全局热键支持 (Ctrl+Alt+Space) - 适用于 X11 和 Wayland (通过 XWayland)
- 系统托盘集成
- 桌面环境集成
### 截图
## 安装
### 使用 APT 仓库 (Debian/Ubuntu - 推荐)
添加仓库以通过 `apt` 获取自动更新：
```
# 添加 GPG key
curl -fsSL https://aaddrick.github.io/claude-desktop-debian/KEY.gpg | sudo gpg --dearmor -o /usr/share/keyrings/claude-desktop.gpg
# 添加 repository
echo "deb [signed-by=/usr/share/keyrings/claude-desktop.gpg arch=amd64,arm64] https://aaddrick.github.io/claude-desktop-debian stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
# 更新并安装
sudo apt update
sudo apt install claude-desktop
```
后续更新将随常规系统更新 (`sudo apt upgrade`) 自动安装。
### 使用 DNF 仓库 (Fedora/RHEL - 推荐)
添加仓库以通过 `dnf` 获取自动更新：
```
# 添加 repository
sudo curl -fsSL https://aaddrick.github.io/claude-desktop-debian/rpm/claude-desktop.repo -o /etc/yum.repos.d/claude-desktop.repo
# 安装
sudo dnf install claude-desktop
```
后续更新将随常规系统更新 (`sudo dnf upgrade`) 自动安装。
### 使用 AUR (Arch Linux)
[`claude-desktop-appimage`](https://aur.archlinux.org/packages/claude-desktop-appimage) 包已在 AUR 上线，并会随每次发布自动更新。
```
# 使用 yay
yay -S claude-desktop-appimage
# 或使用 paru
paru -S claude-desktop-appimage
```
AUR 包会安装 Claude Desktop 的 AppImage 版本。
### 使用 Nix Flake (NixOS)
直接从 flake 安装：
```
# 基本安装
nix profile install github:aaddrick/claude-desktop-debian
# 支持 MCP server（FHS 环境）
nix profile install github:aaddrick/claude-desktop-debian#claude-desktop-fhs
```
或添加到你的 NixOS 配置中：
```
# flake.nix
{
inputs.claude-desktop.url = "github:aaddrick/claude-desktop-debian";
outputs = { nixpkgs, claude-desktop, ... }: {
nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
modules = [
({ pkgs, ... }: {
nixpkgs.overlays = [ claude-desktop.overlays.default ];
environment.systemPackages = [ pkgs.claude-desktop ];
})
];
};
};
}
```
### 使用预构建版本
从 [Releases 页面](https://github.com/aaddrick/claude-desktop-debian/releases)下载最新的 `.deb`、`.rpm` 或 `.AppImage` 文件。
### 从源码构建
详细的构建说明请参阅 [docs/BUILDING.md](docs/BUILDING.md)。
## 配置
Model Context Protocol 设置存储在：
```
~/.config/Claude/claude_desktop_config.json
```
有关包括环境变量和 Wayland 支持在内的更多配置选项，请参阅 [docs/CONFIGURATION.md](docs/CONFIGURATION.md)。
## 故障排除
运行 `claude-desktop --doctor` 进行内置诊断，检查常见问题（显示服务器、沙箱权限、MCP 配置、过期锁等）。它还会报告 cowork 模式的就绪状态 —— 将使用哪个隔离后端，以及哪些依赖项（KVM、QEMU、vsock、socat、virtiofsd、bubblewrap）已安装或缺失。
有关更多故障排除、卸载说明和日志位置，请参阅 [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)。
## 致谢
本项目的灵感来源于 [k3d3 的 claude-desktop-linux-flake](https://github.com/k3d3/claude-desktop-linux-flake) 以及他关于在 Linux 上原生运行 Claude Desktop 的 [Reddit 帖子](https://www.reddit.com/r/ClaudeAI/comments/1hgsmpq/i_successfully_ran_claude_desktop_natively_on/)。
特别感谢：
- **k3d3** 提供了原始 NixOS 实现和原生绑定见解
- **[emsi](https://github.com/emsi/claude-desktop)** 提供了标题栏修复和替代实现方案
- **[leobuskin](https://github.com/leobuskin/unofficial-claude-desktop-linux)** 提供了基于 Playwright 的 URL 解析方案
- **[yarikoptic](https://github.com/yarikoptic)** 提供了 codespell 支持和 shellcheck 合规性
- **[IamGianluca](https://github.com/IamGianluca)** 改进了构建依赖检查
- **[ing03201](https://github.com/ing03201)** 提供了 IBus/Fcitx5 输入法支持
- **[ajescudero](https://github.com/ajescudero)** 固定了 @electron/asar 以确保 Node 兼容性
- **[delorenj](https://github.com/delorenj)** 提供了 Wayland 兼容性支持
- **[Regen-forest](https://github.com/Regen-forest)** 建议将 Gear Lever 作为 AppImageLauncher 的替代品
- **[niekvugteveen](https://github.com/niekvugteveen)** 修复了 Debian 打包权限问题
- **[speleoalex](https://github.com/speleoalex)** 提供了原生窗口装饰支持
- **[imaginalnika](https://github.com/imaginalnika)** 将日志移动到 `~/.cache/`
- **[richardspicer](https://github.com/richardspicer)** 修复了 Linux 上的菜单栏可见性问题
- **[jacobfrantz1](https://github.com/jacobfrantz1)** 提供了 Claude Desktop 代码预览支持和快速窗口提交修复
- **[janfrederik](https://github.com/janfrederik)** 提供了 `--exe` 标志以使用本地安装程序
- **[MrEdwards007](https://github.com/MrEdwards007)** 发现了 OAuth token 缓存修复
- **[lizthegrey](https://github.com/lizthegrey)** 贡献了版本更新
- **[mathys-lopinto](https://github.com/mathys-lopinto)** 提供了 AUR 包和自动化部署
- **[pkuijpers](https://github.com/pkuijpers)** 对 RPM 仓库 GPG 签名问题进行了根本原因分析
- **[dlepold](https://github.com/dlepold)** 发现了托盘图标变量名 bug 并提供了有效修复
- **[Voork1144](https://github.com/Voork1144)** 对托盘图标压缩器 bug 进行了详细分析、Chromium 布局缓存 bug 的根本原因分析，以及直接子级 `setBounds()` 修复方案
- **[sabiut](https://github.com/sabiut)** 提供了 `--doctor` 诊断命令
- **[milog1994](https://github.com/milog1994)** 改进了 Linux UX，包括弹窗检测、功能 stub 和 Wayland 合成器支持
- **[jarrodcolburn](https://github.com/jarrodcolburn)** 提供了容器/CI 环境中的无密码 sudo 支持
- **[chukfinley](https://github.com/chukfinley)** 提供了 Linux 上实验性的 Cowork 模式支持
- **[IliyaBrook](https://github.com/IliyaBrook)** 修复了 Claude Desktop >= 1.1.3541 arm64 重构的平台补丁
- **[MichaelMKenny](https://github.com/MichaelMKenny)** 诊断了带 `$` 前缀的 electron 变量 bug，提供了根本原因分析和变通方案
- **[daa25209](https://github.com/daa25209)** 对 cowork 平关崩溃进行了详细的根本原因分析并提供了补丁脚本
- **[noctuum](https://github.com/noctuum)** 提供了用于配置菜单栏可见性的 `CLAUDE_MENU_BAR` 环境变量
- **[typedrat](https://github.com/typedrat)** 提供了 NixOS flake 集成，包括 build.sh、node-pty derivation 和 CI 自动更新
## 赞助
Anthropic 不发布 Claude Desktop 的发布说明。此处的每次发布都包含通过分析版本间代码变更生成的 AI 说明。如果你好奇的话，我写了一篇关于该过程如何运作的文章：[从混淆的 Electron 应用生成真实发布说明](https://nonconvexlabs.com/blog/generating-real-release-notes-from-minified-electron-apps)。
分析工作调用 Claude 的 API 运行。成本因更新大小而异。最近的几次发布成本在 **$3.36 到 $76.16 之间**。
如果这个项目对你有帮助，请考虑 [在 GitHub 上赞助](https://github.com/sponsors/aaddrick) 以帮助分担这些费用。
## 许可证
本仓库中的构建脚本采用双重许可：
- MIT 许可证 (见 [LICENSE-MIT](LICENSE-MIT))
- Apache 许可证 2.0 (见 [LICENSE-APACHE](LICENSE-APACHE))
Claude Desktop 应用程序本身受 [Anthropic 消费者条款](https://www.anthropic.com/legal/consumer-terms)约束。
## 贡献
欢迎贡献代码！提交贡献即表示你同意按照本项目的双重许可条款对其进行许可。
标签：AI 助手, Anthropic, AppImage, Arch Linux, AUR, CIS基准, Claude Desktop, Cutter, Debian, deb 打包, DLL 劫持, DNS解析, Fedora, LLM, MCP, MITM代理, Model Context Protocol, Nix Flake, NixOS, rpm 打包, Unmanaged PE, Wayland, Web应用防火墙, X11, 全局快捷键, 大语言模型, 安装脚本, 开源项目, 桌面应用, 生产力工具, 移植工具, 系统托盘