# Решение проблем

> Частые проблемы и как их решить.

Source: https://docs.neurosquad.ai/ru/help/troubleshooting

### При запуске установщика Windows пишет «Windows protected your PC»

Установщик пока не подписан, поэтому SmartScreen о нём предупреждает. Нажмите **More info**,
убедитесь, что это `NeuroSquad-Installer.exe`, затем нажмите **Run anyway**. Скачивайте установщик
только с нашей [страницы загрузки](https://neurosquad.ai/ru/download/). См.
[Установка](https://docs.neurosquad.ai/ru/getting-started/installation).

### Веб-установщик пишет, что не удалось скачать NeuroSquad

`NeuroSquad-Installer.exe` нужен доступ к github.com, где публикуется NeuroSquad. Проверьте
подключение или прокси и нажмите **Повторить**. Если GitHub ограничивает запросы из вашей сети,
подождите несколько минут — или скачайте полный установщик напрямую:
`https://neurosquad.ai/downloads/NeuroSquad-Setup.exe`. Файл, контрольная сумма SHA-256 которого не
совпала, веб-установщик никогда не запускает. Его журнал — `%TEMP%\NeuroSquad-Installer-<дата>.log`.

### Установка не удалась или установщик пишет, что NeuroSquad ещё работает

Закройте NeuroSquad (в том числе из трея) или дайте установщику завершить его процессы кнопкой
**Завершить и продолжить**. В остальных случаях страница ошибки объясняет, что пошло не так, а
полный журнал лежит в `%TEMP%\NeuroSquad-Setup-<дата>.log` (и в `install.log` в папке установки).
Неудачное обновление оставляет прежнюю версию рабочей. См.
[Если что-то пошло не так](https://docs.neurosquad.ai/ru/getting-started/installation#if-something-goes-wrong).

### Установленный агент показан как «Not found»

Откройте **Settings → Harnesses** и нажмите **Check again**. Всё ещё не видно? Полностью закройте
NeuroSquad (в том числе из трея) и запустите снова или установите агента через **Settings → Setup**.

### Карточка агента сразу закрывается

Попробуйте запустить того же агента в своём терминале, в той же папке. Сообщение, которое он там
покажет, обычно и есть ответ — чаще всего агент просто ещё не вошёл в аккаунт.

### Я провёл стрелку, а агент говорит, что инструментов у него нет

- Проверьте, что агент — Claude Code, Codex CLI или Qwen Code.
- Для стрелок между агентами проверьте направление: **от** ведущего **к** помощнику.
- Попросите агента «проверить свои подключения в NeuroSquad».

### Агент запустил команду в своём окне, а не в моей карточке терминала

Скажите это в промпте: *«запускай все команды в подключённом терминале»*. Или включите
[режим карточек](https://docs.neurosquad.ai/ru/squads/canvas-mode).

### Карточка браузера не запускается

В первый раз ей нужно скачать браузер. Если загрузка прервалась, откройте **Settings → Browser** и
нажмите **Resume download**.

### Диктовка ничего не делает

- Возможно, модель распознавания речи ещё не скачана — тогда в строке состояния написано
**Dictation: download the model**. Скачайте её в **Settings → Dictation**.
- Возможно, та же горячая клавиша занята другим приложением — поменяйте её в **Settings → Dictation**.
- Проверьте, что Windows разрешает настольным приложениям пользоваться микрофоном (**Параметры
Windows → Конфиденциальность и защита → Микрофон**).
- Если текст попал в буфер обмена, но не в агента, значит, окно NeuroSquad не было активным — просто
вставьте его.

### Телефон не подключается

- В режиме **Local network** телефон должен быть в той же сети Wi-Fi. Попробуйте выбрать другой
**Network address** в **Settings → Remote access**.
- В режиме **quick internet tunnel** адрес меняется при каждом запуске NeuroSquad — отсканируйте код
заново.

### В разделе Usage ничего нет

Расход читается из журналов Claude Code, Codex CLI, OpenCode, Hermes Agent, Pi и omp; остальные агенты не
учитываются. Попробуйте период подлиннее или нажмите **Refresh**.

### Карточка Telegram не подключается

Вставьте целиком токен, который прислал BotFather, затем отправьте своему боту `/start` и нажмите
**Allow** в карточке. Сообщения из чатов, которые вы не разрешили, игнорируются.

### Агент на OpenRouter входит под моим обычным аккаунтом

Ключ не сохранён — плашка модели у агента становится янтарной. Добавьте ключ в **Settings →
Providers** и перезапустите агента.

### С большим количеством карточек всё тормозит

Каждая карточка агента — это работающая программа. Закройте те, что больше не нужны, и отдалите
холст — карточки превратятся в лёгкие [плитки обзора](https://docs.neurosquad.ai/ru/canvas/moving-around).

## Не помогло?

Напишите в [Discord-сервер NeuroSquad](https://discord.gg/DyKn8cGTc): что вы делали, чего ожидали и что произошло на самом
деле. Скриншот очень поможет.

## «… не установлен» на карточке агента

CLI агента этой карточки нет на компьютере (или его нет в PATH) — например, ведущий агент создал
помощника на агенте, которого у вас нет. Карточка предлагает **Установить…** (мастер установки),
**Выбрать другой харнесс** (переключает карточку на установленный, сохраняя её место и стрелки) и
**Повторить** (если вы поставили его сами — перезапуск не нужен).