cc-haha/docs/desktop/04-installation.md
程序员阿江(Relakkes) 338c931962 docs(release): simplify macOS install back to a single xattr command
Real-world testing showed the unsigned app just needs the original 0.3.2
one-liner after the "damaged" prompt (System Settings "Open Anyway" also
works). Drop the Sequoia / "don't trash it" / clear-DMG-first / script
walkthrough noise and match the historical release-note style.

- release-notes/v0.4.0.md: macOS = drag in + `xattr -cr ...`, Windows one
  line, Linux kept short.
- docs/desktop/04-installation.md: same trim, remove duplicated FAQ entry.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-03 23:53:13 +08:00

2.4 KiB
Raw Blame History

安装指南

桌面端基于 Electron,提供 macOS / Windows / Linux 安装包。当前版本暂未进行 Apple / Windows 代码签名,首次安装需要手动放行一次(不是文件损坏,按下方步骤操作即可)。

下载

前往 GitHub Releases 下载对应平台的安装包:

平台 文件
macOS (Apple Silicon / M 系列) Claude-Code-Haha-<版本>-mac-arm64.dmg
macOS (Intel) Claude-Code-Haha-<版本>-mac-x64.dmg
Windows (x64) Claude-Code-Haha-<版本>-win-x64.exe
Linux (x64) Claude-Code-Haha-<版本>-linux-x86_64.AppImage...-linux-amd64.deb
Linux (ARM64) Claude-Code-Haha-<版本>-linux-arm64.AppImage...-linux-arm64.deb

不确定 Mac 架构?点击左上角 → 关于本机芯片为「Apple M…」选 arm64「Intel」选 x64。

macOS 安装

双击 DMG 把应用拖入 Applications。首次打开如果提示**"已损坏""无法验证开发者"**,在终端执行:

xattr -cr /Applications/Claude\ Code\ Haha.app

也可以在「系统设置 → 隐私与安全性」里点"仍要打开"。

Windows 安装

双击 .exe 安装。首次运行如果 SmartScreen 弹出 "Windows 已保护你的电脑",点击 「更多信息」「仍要运行」

Linux 安装

AppImage

chmod +x Claude-Code-Haha-<版本>-linux-x86_64.AppImage
./Claude-Code-Haha-<版本>-linux-x86_64.AppImage

提示缺少 FUSEUbuntu 22.04 及更早 sudo apt install libfuse224.04+ sudo apt install libfuse2t64

deb

sudo apt install ./Claude-Code-Haha-<版本>-linux-amd64.deb

Web UI 模式

如果桌面端安装遇到问题,可以直接通过浏览器使用 Web UI。在项目根目录下分别启动服务端和前端

# 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)。