mirror of
https://github.com/NanmiCoder/cc-haha
synced 2026-07-22 14:30:53 +08:00
99 lines
3.8 KiB
Markdown
99 lines
3.8 KiB
Markdown
# 安装指南
|
||
|
||
桌面端基于 **Electron**，提供 macOS / Windows / Linux 安装包。`v0.4.3` 起的正式 macOS Release 使用 Developer ID 签名和 notarization；更早版本或临时开发包仍可能需要手动放行。
|
||
|
||
## 下载
|
||
|
||
前往 [GitHub Releases](https://github.com/NanmiCoder/cc-haha/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` |
|
||
| Windows (ARM64) | `Claude-Code-Haha-<版本>-win-arm64.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`。`v0.4.3` 起的正式 Release 正常情况下只会出现 macOS 的标准下载来源确认，不需要执行 `xattr`。
|
||
|
||
如果安装的是旧版或 unsigned 临时包，首次打开可能提示**"已损坏"**或**"无法验证开发者"**，再在终端执行：
|
||
|
||
```bash
|
||
xattr -cr /Applications/Claude\ Code\ Haha.app
|
||
```
|
||
|
||
也可以在「系统设置 → 隐私与安全性」里点"仍要打开"。
|
||
|
||
## Windows 安装
|
||
|
||
双击 `.exe` 安装。首次运行如果 SmartScreen 弹出 **"Windows 已保护你的电脑"**，点击 **「更多信息」** → **「仍要运行」**。
|
||
|
||
## Linux 安装
|
||
|
||
AppImage：
|
||
|
||
```bash
|
||
chmod +x Claude-Code-Haha-<版本>-linux-x86_64.AppImage
|
||
./Claude-Code-Haha-<版本>-linux-x86_64.AppImage
|
||
```
|
||
|
||
> 提示缺少 FUSE：Ubuntu 22.04 及更早 `sudo apt install libfuse2`，24.04+ `sudo apt install libfuse2t64`。
|
||
|
||
deb：
|
||
|
||
```bash
|
||
sudo apt install ./Claude-Code-Haha-<版本>-linux-amd64.deb
|
||
```
|
||
|
||
## Web 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` 即可。
|
||
|
||
本机通过 `127.0.0.1` 使用 Web UI 时，不需要开启 H5 访问，也不需要填写 H5 Token。服务端会把真正的本机回环请求视为可信本地访问；这个豁免不会扩展到局域网地址或反向代理。
|
||
|
||
### 无界面 Linux 服务器
|
||
|
||
如果服务器没有桌面环境，推荐先使用 SSH 同时转发前端和后端端口：
|
||
|
||
```bash
|
||
# 在服务器上分别启动后端与前端，仍只监听回环地址
|
||
SERVER_PORT=3456 bun run src/server/index.ts
|
||
cd desktop
|
||
bun run dev --host 127.0.0.1 --port 2024
|
||
|
||
# 在自己的电脑上执行
|
||
ssh -L 2024:127.0.0.1:2024 -L 3456:127.0.0.1:3456 user@example.com
|
||
```
|
||
|
||
然后在自己的电脑上打开：
|
||
|
||
```text
|
||
http://127.0.0.1:2024/?serverUrl=http%3A%2F%2F127.0.0.1%3A3456
|
||
```
|
||
|
||
这条路径不把服务暴露到局域网，因此同样不需要 H5 Token。如果确实要从局域网或反向代理访问，请按 [H5 访问](./06-h5-access.md#无桌面界面时开启) 在服务器本机启用 Token、配置允许来源，再让服务监听外部接口。
|
||
|
||
## 常见问题
|
||
|
||
**Q: 这个版本会自动更新吗？**
|
||
|
||
`v0.4.3` 起的正式 Release 会通过 GitHub Releases 检查更新，并下载对应平台的更新包。覆盖安装或应用内更新不会删除本地配置和会话数据（`~/.claude`）。
|
||
|
||
正式公开的 macOS Release 需要签名和公证；draft/unsigned 临时包仍可能需要手动放行。Windows 签名不是发布阻塞项，未签名安装包仍可更新，但可能出现 SmartScreen 提示。
|