AI导哈

AppImage构建工具

用于为Claude Desktop创建便携式AppImage包的工具，包含完整的Electron运行时和Node.js支持。

  • by mboman
  • Shell
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 mboman/claude-desktop-appimage

使用说明

克劳德桌面应用程序映像生成器

非官方构建工具

该项目提供了一个构建脚本，用于创建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服务器

先决条件

在构建之前，您需要：

  1. 这 emsi/claude桌面 项目建成于 $HOME/src/claude-desktop
  2. 基本构建工具： 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

运作原理

构建脚本：

  1. 验证来源：检查Claude Desktop是否已在同级目录中构建
  2. 下载依赖关系：获取Electron和Node.js二进制文件（缓存以供后续构建）
  3. 创建AppDir结构：构建标准AppImage目录布局
  4. 捆绑组件:
    • 副本 app.asar 和 app.asar.unpacked 来自克劳德桌面
    • 提取电子运行时
    • 提取Node.js运行时（用于MCP服务器）
  5. 创建启动器：使用适当的环境设置AppRun和包装器脚本
  6. 构建应用程序映像：使用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的新版本发布时：

  1. 更新父项目：

    cd $HOME/src/claude-desktop
git pull
./install-claude-desktop.sh

  2. 更新此项目中的版本：

    # Edit claude_appimage_builder.sh
# Update CLAUDE_VERSION="x.x.x"

  3. 重建：

    ./claude_appimage_builder.sh

故障排除

“未找到Claude源”错误

确保您首先构建了父项目：

cd $HOME/src/claude-desktop
./install-claude-desktop.sh

AppImage无法运行

尝试：

chmod +x Claude-0.14.10-x86_64.AppImage
./Claude-0.14.10-x86_64.AppImage --no-sandbox

MCP服务器不工作

验证Node.js是否可访问：

# Extract AppImage to inspect
./Claude-0.14.10-x86_64.AppImage --appimage-extract
./squashfs-root/usr/bin/node --version

贡献

欢迎投稿！请确保：

  1. 该脚本保持可移植性，适用于主要的Linux发行版
  2. 构建工件未提交（它们在 .gitignore)
  3. 更改与现有配置向后兼容

许可证

此存储库中的构建脚本根据MIT许可证和Apache许可证（2.0版）的条款获得双重许可。

看 许可证-麻省理工学院 和 特许通行证 了解详情。

Claude Desktop应用程序包含在 Anthropic的消费者术语.

致谢

免责声明

这是一个非官方的构建工具。有关此脚本的问题，请在此处提交。有关Claude Desktop应用程序问题，请联系Anthropic支持。

相关 MCP