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

> Что-то не работает. Начните с проверок, потом найдите свой случай.

# Устранение неполадок

Что-то не работает. Начните с проверок, потом найдите свой случай.

## Работает ли?

Shell

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

**Вы увидите:** `ok`. Потом проверьте свою сборку и откройте дашборд на `http://127.0.0.1:7788`:

Shell

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

> Примечание
> 
> Команды `harnsy doctor` нет. Помогают эти: `harnsy config` (ваши настройки и откуда каждая), `harnsy net check` (может ли этот компьютер достучаться до нужных сервисов через ваш прокси), `harnsy license` (состояние ключа). Страница настроек «Диагностика» собирает данные за выбранное время; архив рассчитан на то, чтобы в нём не было ключей и токенов; откройте его и просмотрите перед отправкой.

**Журналы.**

**Linux**

```bash
journalctl --user -u harnsy
```

**macOS**

```bash
ls ~/Library/Logs/harnsy/
```

**Windows и везде ещё**

```bash
~/.harnsy/logs/serve.log
```

Файл `serve.log` вмещает 10 МБ, плюс 3 старых файла.

**Перезапустить harnsy.**

**Linux**

```bash
systemctl --user restart harnsy.service
```

**macOS**

```bash
launchctl kickstart -k gui/$(id -u)/com.github.butschster.harnsy
```

> Примечание
> 
> Во время перезапуска отправка на несколько секунд не проходит: повторите.

## Пять частых случаев

1. **«harnsy: command not found» после установки.** `~/.local/bin` нет в вашем PATH. Установщик предупреждает об этом и не правит ваши профили оболочки. В Windows установщик добавляет свою папку в PATH пользователя; терминал, открытый раньше, нужно открыть заново.
2. **Дашборд не открывается, `healthz` молчит.** Служба остановлена. Проверьте её и журнал выше:
   Shell
   
   ```bash
   systemctl --user status harnsy.service
   ```
   Сломанный `config.yaml` останавливает службу, а журнал называет файл, строку и ключ. Без пользовательского systemd установщик печатает, как запустить `harnsy serve` вручную.
3. **Агенты не открываются.** Терминал не выбран (`terminal.driver` не задан) или tmux нет, либо он старше 3.1. Поставьте tmux и задайте драйвер в `~/.harnsy/config.yaml` (или используйте `conpty`), затем перезапустите:
   YAML
   
   ```yaml
   terminal:
     driver: tmux
   ```
   Сообщения, команды и дашборд работают и без него; запуски сообщают `no_terminal`.
4. **Агент не получает сообщения или не знает про harnsy.** Хук сообщает только сессиям, начатым после установки. Дайте уже работающей сессии и каждому агенту OpenCode эту строку:
   ```text
   Read http://127.0.0.1:7788/llms.txt and use harnsy to communicate with the other agents.
   ```
   Агент OpenCode работает, только когда его запускает harnsy. Хуку нужно, чтобы `~/.claude` или `~/.codex` существовали во время установки.
5. **Вопросы о разрешениях Claude Code не появляются на дашборде.** Нет ответного хука (вы отказались при установке или использовали `--no-answer-hook`). Запустите установщик снова и ответьте «да». Щит подсказывает, где вы: янтарный — вы не выбрали, зелёный — проверки включены, красный — проверок нет.

**Windows Security помечает harnsy.exe.** Мы считаем это ложным срабатыванием; имя, которое показывает Windows Security, — `Trojan:Win32/Gracing.I`. Скачанное можно проверить самому, прежде чем что-то исключать. Скачайте zip `harnsy_<версия>_windows_<amd64|arm64>.zip` и `SHA256SUMS` с одной и той же страницы выпуска: [github.com/harnesy/app/releases](https://github.com/harnesy/app/releases), страницы вашей версии. В PowerShell выполните:

PowerShell

```powershell
Get-FileHash .\harnsy_<версия>_windows_<arch>.zip -Algorithm SHA256
```

Сравните Hash (заглавные и строчные буквы не важны) со строкой этого zip в `SHA256SUMS`. Считайте хеш zip, а не распакованного `harnsy.exe` и не установленного файла. Так файл сравнивается со списком из того же выпуска; это не доказывает, кто сделал выпуск. Если совпало, в Windows Security › Защита от вирусов и угроз › Управление настройками › Исключения › Добавить исключение › Папка добавьте `%LOCALAPPDATA%\harnsy` и запустите установщик снова.

> Предупреждение
> 
> Никогда не выключайте Defender и не исключайте `%TEMP%` или весь диск.

Позже исключение можно убрать:

PowerShell

```powershell
Remove-MpPreference -ExclusionPath "$env:LOCALAPPDATA\harnsy"
```

**За корпоративным прокси.** См. раздел о прокси в руководстве по установке и выполните `harnsy net check`.

**Известные ограничения.**

- Простаивающий терминал Codex не виден проверке, которая не даёт открыть сессию дважды, поэтому сессия Codex может открыться второй раз.
- Вопросы Codex приходят в конце его хода.
- Установка на macOS ещё не проверена на настоящем Mac.
- Релей harnsy — бета.

С 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. Логотипов нет.