---
title: 下载与安装
nav_title: 下载与安装
description: macOS、Windows、Linux 三个平台的安装包，以及系统拦截时的处理办法。
order: 1
---

# 下载与安装

装完就能用，不需要另外安装 Node.js、Python 或 Claude Code——CLI 内核和文件搜索用的 ripgrep 都已经打进安装包里了。

## 挑对安装包

所有安装包都在 [GitHub Releases](https://github.com/NanmiCoder/cc-haha/releases/latest)，按系统和 CPU 架构选一个：

| 你的系统 | 下载 |
|---|---|
| macOS，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` |

不确定自己是哪种架构：macOS 看「关于本机」里的芯片型号，Windows 看「设置 → 系统 → 系统信息」里的系统类型。别只凭机器牌子猜。

`.blockmap` 和 `latest*.yml` 是应用自动更新用的，不用手动下载。

## macOS

1. 双击 DMG。
2. 把 Claude Code Haha 拖进「应用程序」。
3. 从「应用程序」打开。

### 如果提示「已损坏，无法打开」

这不是文件坏了。macOS 会给从网上下载的安装包打一个隔离标记（quarantine），遇到没有 Apple 签名的应用就直接拒绝启动，报错文案偏偏写成「已损坏」。经过签名和公证的正式版本不会有这一步；如果你拿到的是未签名构建，用下面两种办法之一放行。

**办法一：用官方脚本（推荐）**

从同一个 Release 里把 `install-macos-unsigned.sh` 下载到和 DMG **同一个文件夹**（比如「下载」），然后在终端里跑：

```bash
cd ~/Downloads
bash install-macos-unsigned.sh
```

脚本会自动挑对架构的 DMG、挂载、把应用装进 `/Applications`、清掉隔离标记再打开。已有的旧版本会先移到废纸篓，不会直接覆盖。

**办法二：手动清隔离标记**

已经把应用拖进「应用程序」了，就直接执行：

```bash
xattr -dr com.apple.quarantine "/Applications/Claude Code Haha.app"
```

只对你确认来自本仓库 Release 的安装包这么做。来路不明的应用不要绕过 Gatekeeper。

## Windows

1. 先把正在运行的旧版本完全退出，包括系统托盘里的图标。
2. 双击 `.exe` 安装。
3. **不要**右键选「以管理员身份运行」——安装器是给当前用户装的，用管理员身份反而会让数据目录对不上。

未签名的安装包会触发 SmartScreen 蓝屏提示。确认文件确实来自本仓库 Release 后，点「更多信息」→「仍要运行」。

覆盖升级时安装器会检查旧安装目录里的用户数据。如果它提示「程序仍在运行」，退出主窗口和托盘图标，等几秒让后台的 sidecar、终端和 IM adapter 退干净，再重新运行安装器。别先手动删掉旧安装目录。

## 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 及以后用 `libfuse2t64`。

**deb**（装进系统菜单）：

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

ARM64 机器换成对应的 `linux-arm64` 文件。

## 从源码跑

想改代码、调试内核，或者只想在终端里用 CLI，可以从源码起：

```bash
git clone https://github.com/NanmiCoder/cc-haha.git
cd cc-haha
bun install
cp .env.example .env
./bin/claude-haha
```

需要 [Bun](https://bun.sh) 和 Git。这条路只跑 CLI，桌面端的构建方式和本地服务参数见 [命令行](../cli/index.md)。

## 升级

**应用内更新（推荐）。** 打开「设置 → 关于 → 应用更新」，点「检查更新」。它会比对当前版本和 GitHub Releases 上的最新版本，有新版就下载，下载完提示「安装并重启」。

更新前先把正在跑的会话停掉，未提交的代码存好。

下载卡住不动，多半是网络到不了 GitHub。同一个面板里有「高级更新代理」，可以切成系统代理或填一个本地 HTTP 代理地址（例如 `http://127.0.0.1:7890`）。这个代理只管应用自己的更新下载，不影响模型请求。

**手动换包。** 从 Releases 下新版安装包，按上面各平台的步骤重装一遍即可。会话、服务商配置、技能、Agent、记忆都存在 `~/.claude` 下，不在应用目录里，覆盖安装不会动它们。

:::warning
安装器的数据保护不等于备份。真正重要的东西请自己另存一份。
:::

## 装完之后

去 [连接模型服务](./models.md)。没接模型之前，应用能打开，但发不出任何一条消息。

装不上或者打不开，看 [装不上 / 打不开 / 连不上](./troubleshooting.md)。