安装指南
桌面端基于 Electron，提供 macOS / Windows / Linux 安装包。当前版本暂未进行 Apple / Windows 代码签名，首次安装需要手动放行一次（不是文件损坏，按下方步骤操作即可）。
下载
前往 GitHub Releases 下载对应平台的安装包：
| 平台 | 文件 |
|---|---|
| macOS (Apple Silicon / M 系列) | EchoFlowAI-Claude-Code-<版本>-mac-arm64.dmg |
| macOS (Intel) | EchoFlowAI-Claude-Code-<版本>-mac-x64.dmg |
| Windows (x64) | EchoFlowAI-Claude-Code-<版本>-win-x64.exe |
| Linux (x64) | EchoFlowAI-Claude-Code-<版本>-linux-x86_64.AppImage 或 ...-linux-amd64.deb |
| Linux (ARM64) | EchoFlowAI-Claude-Code-<版本>-linux-arm64.AppImage 或 ...-linux-arm64.deb |
不确定 Mac 架构？点击左上角 → 关于本机，芯片为「Apple M…」选 arm64，「Intel」选 x64。
macOS 安装
双击 DMG 把应用拖入 Applications。首次打开如果提示**"已损坏"或"无法验证开发者"**，在终端执行：
bash
xattr -cr /Applications/Claude\ Code\ Haha.app也可以在「系统设置 → 隐私与安全性」里点"仍要打开"。
Windows 安装
双击 .exe 安装。首次运行如果 SmartScreen 弹出 "Windows 已保护你的电脑"，点击 「更多信息」 → 「仍要运行」。
Linux 安装
AppImage：
bash
chmod +x EchoFlowAI-Claude-Code-<版本>-linux-x86_64.AppImage
./EchoFlowAI-Claude-Code-<版本>-linux-x86_64.AppImage提示缺少 FUSE：Ubuntu 22.04 及更早
sudo apt install libfuse2，24.04+sudo apt install libfuse2t64。
deb：
bash
sudo apt install ./EchoFlowAI-Claude-Code-<版本>-linux-amd64.debWeb UI 模式
如果桌面端安装遇到问题，可以直接通过浏览器使用 Web UI。在项目根目录下分别启动服务端和前端：
bash
# 1. 启动服务端（在项目根目录）
SERVER_PORT=3456 bun run src/server/index.ts
# 2. 启动前端（在 desktop 目录）
cd desktop
bun run dev --host 127.0.0.1 --port 2024启动后浏览器访问 http://127.0.0.1:2024 即可。
常见问题
Q: 这个版本会自动更新吗？
暂时不会。在拿到苹果签名前，请每次到 GitHub Releases 手动下载新版本覆盖安装。覆盖安装不会删除本地配置和会话数据（~/.claude）。