克劳德桌面应用程序映像生成器
非官方构建工具
该项目提供了一个构建脚本，用于创建Linux版Claude Desktop的AppImage包，并通过捆绑的Node.js提供完整的MCP（模型上下文协议）服务器支持。
这是什么？
这是一个配套项目 emsi/claude桌面 创建可移植的AppImage包。虽然父项目从Windows安装程序构建Debian软件包，但此项目采用了不同的方法：
- 使用来自的解压缩的Electron应用程序
claude-desktop作为来源 - 捆绑完整的Electron运行时
- 包含用于MCP服务器支持的Node.js
- 创建在任何Linux发行版上运行的自包含、可移植的AppImage
为什么选择AppImage？
AppImages提供了几个优点：
- 便携的：可在任何地方运行的单个可执行文件
- 无需安装：只需下载并运行
- 自足：包括所有依赖项（Electron+Node.js）
- 分布不可知：适用于任何Linux发行版
- MCP支持：捆绑的Node.js支持运行MCP服务器
先决条件
在构建之前，您需要：
- 这 emsi/claude桌面 项目建成于
$HOME/src/claude-desktop - 基本构建工具：
wget,unzip,tar
快速开始
# Clone this repository
git clone https://github.com/mboman/claude-desktop-appimage.git
cd claude-desktop-appimage
# Ensure claude-desktop is built first
cd $HOME/src/claude-desktop
./install-claude-desktop.sh
cd -
# Build the AppImage
./claude_appimage_builder.sh
# Run Claude
./Claude-0.14.10-x86_64.AppImage运作原理
构建脚本：
- 验证来源：检查Claude Desktop是否已在同级目录中构建
- 下载依赖关系：获取Electron和Node.js二进制文件（缓存以供后续构建）
- 创建AppDir结构：构建标准AppImage目录布局
- 捆绑组件:
- 副本 app.asar 和 app.asar.unpacked 来自克劳德桌面 - 提取电子运行时 - 提取Node.js运行时（用于MCP服务器）
- 创建启动器：使用适当的环境设置AppRun和包装器脚本
- 构建应用程序映像：使用appimagetool创建最终的可移植可执行文件
配置
在顶部编辑这些变量 claude_appimage_builder.sh 如果需要：
CLAUDE_VERSION="0.14.10"
ELECTRON_VERSION="39.0.0"
NODE_VERSION="24.11.0"
CLAUDE_SOURCE_DIR="$HOME/src/claude-desktop/build/electron-app"MCP服务器支持
捆绑的Node.js支持运行MCP服务器。在以下位置配置它们：
~/.config/Claude/claude_desktop_config.json配置示例：
{
"mcpServers": {
"filesystem": {
"command": "node",
"args": ["/path/to/mcp-server-filesystem/dist/index.js"]
}
}
}由于Node.js被捆绑在AppImage中 node 当Claude Desktop运行时，命令将可用。
与claude桌面的关系
该项目取决于 emsi/claude桌面 用于：
- 未打包的Electron应用程序(
app.asar和app.asar.unpacked) - 应用程序图标
- 与Linux兼容的本机绑定
父项目处理以下复杂工作：
- 从Windows安装程序中提取
- 创建与Linux兼容的本机绑定
- 提供基础应用程序结构
该项目侧重于：
- 打包成便携式AppImage格式
- 捆绑运行时依赖项（Electron+Node.js）
- 创建与分发无关的包
安装选项
全系统安装
sudo mv Claude-0.14.10-x86_64.AppImage /usr/local/bin/claude
sudo chmod +x /usr/local/bin/claude用户安装
mkdir -p ~/.local/bin
mv Claude-0.14.10-x86_64.AppImage ~/.local/bin/claude
chmod +x ~/.local/bin/claude
# Ensure ~/.local/bin is in your PATH桌面集成
大多数桌面环境在运行时会自动集成AppImages。您还可以使用 AppImageLauncher 以实现更好的桌面集成。
更新中
当Claude Desktop的新版本发布时：
- 更新父项目：
cd $HOME/src/claude-desktop
git pull
./install-claude-desktop.sh- 更新此项目中的版本：
# Edit claude_appimage_builder.sh
# Update CLAUDE_VERSION="x.x.x"- 重建：
./claude_appimage_builder.sh故障排除
“未找到Claude源”错误
确保您首先构建了父项目：
cd $HOME/src/claude-desktop
./install-claude-desktop.shAppImage无法运行
尝试：
chmod +x Claude-0.14.10-x86_64.AppImage
./Claude-0.14.10-x86_64.AppImage --no-sandboxMCP服务器不工作
验证Node.js是否可访问：
# Extract AppImage to inspect
./Claude-0.14.10-x86_64.AppImage --appimage-extract
./squashfs-root/usr/bin/node --version贡献
欢迎投稿！请确保：
- 该脚本保持可移植性，适用于主要的Linux发行版
- 构建工件未提交（它们在
.gitignore) - 更改与现有配置向后兼容
许可证
此存储库中的构建脚本根据MIT许可证和Apache许可证（2.0版）的条款获得双重许可。
看 许可证-麻省理工学院 和 特许通行证 了解详情。
Claude Desktop应用程序包含在 Anthropic的消费者术语.
致谢
- emsi/claude桌面 -提供Linux兼容的Claude Desktop基础的父项目
- aaddrick/claude桌面debian -原创灵感
- k3d3/claude桌面linux flake -早期Linux兼容性工作
- AppImage -通用Linux软件包格式
- Anthropic -Claude桌面应用程序
免责声明
这是一个非官方的构建工具。有关此脚本的问题，请在此处提交。有关Claude Desktop应用程序问题，请联系Anthropic支持。