Source: https://harnsy.dev/ru/docs/install

> harnsy ставится одной командой на Linux, macOS и Windows. Он запускается на вашем компьютере как фоновая служба. Для работы ему не нужен наш сервер; к чему он обращается и когда, написано в FAQ «Куда уходят мои данные?».

# Установка

harnsy ставится одной командой на Linux, macOS и Windows. Он запускается на вашем компьютере как фоновая служба. Для работы ему не нужен наш сервер; к чему он обращается и когда, написано в FAQ «Куда уходят мои данные?».

Полная страница — [Установка](https://harnsy.dev/ru/install); здесь краткая версия.

**Что нужно заранее.** Должна быть установлена хотя бы одна AI-программа: Claude Code, Codex или OpenCode. В Claude Code или Codex вы входите при первом запуске (страница 2); агент OpenCode работает, когда его запускает harnsy. Для терминалов harnsy использует tmux или собственный встроенный терминал (ставить ничего не нужно; Windows 10 1809 и новее). Установщик предложит один из них. Без них сообщения, команды и дашборд работают, но агентов harnsy сам не открывает.

### Шаги

**1. Сначала посмотрите план, ничего не меняя.**

**Linux и macOS**

```bash
curl -fsSL https://harnsy.dev/install.sh | sh -s -- --dry-run
```

**Windows**

```powershell
$env:HARNSY_INSTALL_ARGS = "--dry-run"; irm https://harnsy.dev/install.ps1 | iex
```

**Вы увидите:** каждый шаг и каждый diff, которые сделает установщик. Ничего не записывается.

**2. Установите.** Выполните ту же команду без `--dry-run`.

**Linux и macOS**

```bash
curl -fsSL https://harnsy.dev/install.sh | sh
```

**Windows**

```powershell
irm https://harnsy.dev/install.ps1 | iex
```

harnsy ставится в `~/.local/bin` (Windows: `%LOCALAPPDATA%\harnsy\bin`) и запускается как пользовательская служба. Загрузка сверяется с `SHA256SUMS` выпуска.

**3. Ответьте на вопросы установщика в терминале.** Он спрашивает перед каждым изменением ваших собственных файлов: выбор терминала, значок в трее (и запуск при входе), хук-справка и хук-ответ для Claude Code и Codex, записи «разрешить harnsy» для авторежима Claude Code, строка состояния Claude. Каждое изменение показывается как diff, ваше «да» запоминается для следующей установки.

> Совет
> 
> На компьютере, где harnsy ещё не было, `--first-run` отвечает «да» на главные вопросы и потом печатает «Что изменилось на этом компьютере» и как это отменить.

**Linux и macOS**

```bash
curl -fsSL https://harnsy.dev/install.sh | sh -s -- --first-run
```

**Windows**

```powershell
$env:HARNSY_INSTALL_ARGS = "--first-run"; irm https://harnsy.dev/install.ps1 | iex
```

**4. Проверьте, что он работает.**

Shell

```bash
curl -s http://127.0.0.1:7788/healthz
```

**Вы увидите:** `ok`. Потом откройте `http://127.0.0.1:7788` в браузере.

### Обновление

harnsy сам обновления не проверяет. Проверьте и обновите:

Shell

```bash
harnsy update --check
harnsy update
```

В дашборде то же делают кнопки «Проверить обновления» и «Обновить». Подойдёт и повторная команда установки. Ваши данные в `~/.harnsy` остаются. Узел перезапускается на несколько секунд, сессии агентов продолжают работать.

> Примечание
> 
> Сообщение, отправленное в эти секунды, не дойдёт: отправьте его ещё раз. В Windows установщик спрашивает перед перезапуском узла.

### Вернуться назад

После обновления:

Shell

```bash
harnsy update --rollback --yes
```

Или поставьте старый выпуск поверх нового (переменная идёт в `sh`, а не в `curl`):

Shell

```bash
curl -fsSL https://harnsy.dev/install.sh | HARNSY_VERSION=<тег> sh -s -- --allow-older
```

### Отмена

Shell

```bash
harnsy uninstall --dry-run
harnsy uninstall
```

Команда убирает службу, значок в трее, программу и только те записи в настройках, которые добавила сама установка (хуки, записи авторежима, строку состояния; ваша строка возвращается, если установка её обернула), показав diff и спросив.

> Примечание
> 
> Прежние резервные копии не восстанавливаются. Остаются ваши данные в `~/.harnsy`, резервные копии и выбор терминала, который вы сделали сами. Команда не отменяет разрешения и доверие к папкам, которые вы дали Claude Code. Без терминала она ничего не спрашивает и записи в настройках оставляет.

С harnsy 0.1.

Anthropic, Claude Code, OpenAI, ChatGPT, Codex, OpenCode, Telegram, Discord, GitHub, Apple, macOS, iOS, iPhone, Safari, Google, Android, Chrome, Microsoft, Windows, Windows Security, Defender и QR Code — названия продуктов их владельцев. harnsy не связан с ними и не одобрен ими. iOS — товарный знак Cisco, используемый Apple по лицензии; QR Code — зарегистрированный товарный знак DENSO WAVE INCORPORATED. Логотипов нет.