# Установка

> Скачайте установщик NeuroSquad для Windows, выберите, куда установить, — остальное подготовит мастер первого запуска.

Source: https://docs.neurosquad.ai/ru/getting-started/installation

NeuroSquad поставляется готовым установщиком для **Windows 10 и 11 (64-бит)**. Скачивается
маленький веб-установщик (160 КБ): он загружает последнюю версию (около 100 МБ), сверяет её
контрольную сумму SHA-256 и запускает установку. Ничего не нужно собирать, и терминал не понадобится. Для Mac —
[Установка на macOS](https://docs.neurosquad.ai/ru/getting-started/macos); версия для Linux появится позже.

[Перейти на страницу загрузки](https://neurosquad.ai/ru/download/)

**1. Скачайте NeuroSquad-Installer.exe**

Откройте [страницу загрузки](https://neurosquad.ai/ru/download/) на нашем сайте и нажмите
**Скачать для Windows**. При запуске он скачает последнюю версию NeuroSquad, проверит её и
откроет установку.

**2. Запустите его — и пройдите SmartScreen**

У установщика пока нет цифровой подписи, поэтому Windows может показать синее окно **Windows
protected your PC** («Система Windows защитила ваш компьютер»). Нажмите **More info**
(«Подробнее»), проверьте, что приложение называется `NeuroSquad-Installer.exe`, и нажмите **Run
anyway** («Выполнить в любом случае»).

**3. Выберите, куда установить**

**Папка установки** уже заполнена: `%LOCALAPPDATA%\Programs\NeuroSquad`. Оставьте её или
выберите другую кнопкой **Обзор…** — строка под полем показывает, сколько места нужно
NeuroSquad (369 МБ) и сколько свободно на диске. Переключатель **Ярлык на рабочем столе**
оставьте включённым, если хотите значок NeuroSquad на рабочем столе.

В папку по умолчанию NeuroSquad ставится только для вашей учётной записи Windows, и внизу окна
написано **права администратора не нужны**. Для папки вроде Program Files там будет **нужны
права администратора · Windows спросит разрешение** — и после нажатия «Установить» Windows
действительно спросит.

**4. Нажмите «Установить»**

Окно показывает текущий шаг, сколько файлов уже распаковано, и полосу прогресса. **Показать
журнал** открывает журнал установки: каждый файл с размером и контрольной суммой, с отметками
времени. **Отмена** работает, пока идёт распаковка, и убирает всё, что успело скопироваться.

**5. Запустите NeuroSquad**

Когда появится **NeuroSquad установлен**, нажмите **Запустить NeuroSquad**. Дальше приложение
есть в меню «Пуск» (и на рабочем столе, если вы оставили ярлык).

> SmartScreen показывает это предупреждение для любого нового приложения, ещё не подписанного
> сертификатом. Скачивайте установщик только с нашей
> [страницы загрузки](https://neurosquad.ai/ru/download/).

## Установка из терминала

Тот же установщик, без окон: для вашей учётной записи Windows, без прав администратора. Каждый
способ сверяет загрузку с контрольной суммой SHA-256, прежде чем её запустить, а дальше NeuroSquad
обновляется сам — как бы вы его ни установили.

**winget** — диспетчер пакетов Windows, встроен в Windows 10 и 11:

```powershell
winget install NeuroSquad.NeuroSquad
```

**Scoop** — добавляет бакет NeuroSquad и устанавливает в папку приложений Scoop:

```powershell
scoop bucket add neurosquad https://github.com/glmn-ai/scoop-neurosquad
scoop install neurosquad
```

**PowerShell** — скачивает последнюю версию, ставит её в `%LOCALAPPDATA%\Programs\NeuroSquad` и
запускает NeuroSquad (Windows PowerShell 5.1 или PowerShell 7):

```powershell
irm https://neurosquad.ai/install.ps1 | iex
```

## Вход

При первом запуске NeuroSquad просит войти в аккаунт NeuroSquad — он бесплатный. Откроется браузер
с app.neurosquad.ai: войдите по коду из письма или через Google, нажмите **Connect**, и приложение
это подхватит. До этого приложение показывает только экран входа. По шагам, и что приложение
отправляет, пока вы вошли: [Аккаунт и вход](https://docs.neurosquad.ai/ru/getting-started/account).

## Мастер первого запуска

После входа NeuroSquad проверяет, что уже есть на компьютере, и предлагает поставить
недостающее. Ничего не меняется, пока вы не нажмёте кнопку, и любой шаг можно пропустить — единственное
исключение Node.js (ниже).

**1. CLI агента**

ИИ-агент, которого будут запускать ваши карточки. Если он уже есть, мастер так и скажет. Если
нет — выберите Claude Code, Codex CLI, OpenCode или Kilo Code и нажмите **Install it for me**: мастер
установит его через npm и покажет, какая именно команда выполняется. Нет npm? Без него CLI агентов
не поставить, поэтому мастер сам устанавливает Node.js LTS: официальный архив с nodejs.org с проверкой
опубликованного SHA-256, только для вашей учётной записи — без прав администратора. На Windows это
уже делает установщик, если Node.js нет; уже установленный Node.js никогда не трогается.

**2. Терминал и Git**

Git for Windows приносит с собой Git Bash — им пользуются карточки терминала и изолированные
worktree. Мастер ставит его через `winget` — и всегда сначала спрашивает.

**3. Диктовка**

Модели распознавания речи в установщике нет — она скачивается отдельно. Выберите модель и
нажмите **Download** или пропустите шаг: диктовка необязательна, и от неё больше ничего не
зависит. Скачать модель можно и позже, в **Settings → Dictation**; до тех пор в строке состояния
написано **Dictation: download the model**. См. [Модели распознавания речи](https://docs.neurosquad.ai/ru/dictation/models).

**4. Готово**

Нажмите **Start working**. Вернуться к этим шагам можно в любой момент в **Settings → Setup**.

> Во все агенты вы входите как обычно — запустите агента один раз в карточке и следуйте его
> собственному приглашению ко входу. NeuroSquad никогда не спрашивает ваши ключи.

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

NeuroSquad обновляется сам. Чтобы обновиться вручную, снова запустите `NeuroSquad-Installer.exe` со
[страницы загрузки](https://neurosquad.ai/ru/download/) — он всегда скачивает самую новую версию.
Установленную версию установщик находит сам: в поле папки уже стоит папка прежней установки,
кнопка называется **Обновить**, а заметка обещает, что воркспейсы, агенты и настройки сохранятся —
они лежат в `%APPDATA%\NeuroSquad`, а не в папке самого приложения.

Если NeuroSquad ещё запущен, установщик покажет **NeuroSquad ещё работает** со списком процессов,
которые держат его файлы, — само приложение и терминалы его карточек, с именем и PID. Закройте
NeuroSquad сами и нажмите **Проверить ещё раз** или нажмите **Завершить и продолжить** (терминалы
в карточках NeuroSquad остановятся).

Новая версия распаковывается рядом со старой и подменяет её, только когда распакована целиком.
Если обновление не удалось или вы его отменили, прежняя версия остаётся нетронутой.

## Удаление

Откройте **Параметры Windows → Приложения**, найдите **NeuroSquad** и выберите **Удалить** (или
запустите `Uninstall NeuroSquad.exe` в папке установки). Удаляются ровно те файлы, которые
поставил установщик, ярлыки и запись в списке приложений. Файлы, которые вы сами положили в папку
установки, остаются.

Ваши данные тоже остаются — если не включить **Удалить и мои данные NeuroSquad** (по умолчанию
выключено). Этот переключатель удаляет `%APPDATA%\NeuroSquad`: список воркспейсов, агентов,
настройки, модели диктовки и изолированные worktree агентов — незакоммиченная работа в этих
worktree пропадёт. Папки ваших проектов не затрагиваются никогда. См.
[Где хранятся ваши данные](https://docs.neurosquad.ai/ru/help/data).

## Установка без участия пользователя

Для администраторов и скриптов установщик умеет работать без окна. Полный установщик последней
версии лежит по адресу `https://neurosquad.ai/downloads/NeuroSquad-Setup.exe`; веб-установщик
передаёт ему те же параметры.

```text
NeuroSquad-Setup.exe --silent [--dir <папка>] [--no-desktop] [--launch] [--close-app]
```

- `--dir` — папка установки (по умолчанию `%LOCALAPPDATA%\Programs\NeuroSquad` или папка
существующей установки)
- `--no-desktop` — без ярлыка на рабочем столе
- `--launch` — запустить NeuroSquad после установки
- `--close-app` — завершить запущенные процессы NeuroSquad, а не отказаться от установки

Коды выхода: `0` — установлено, `1` — ошибка, `2` — файлы заняты (NeuroSquad запущен, а
`--close-app` не передан). Удаление без окна:

```text
"Uninstall NeuroSquad.exe" --silent [--delete-data]
```

## Если что-то пошло не так

Страница ошибки простыми словами объясняет, что случилось, показывает подробности и журнал и
предлагает **Повторить**. Если установка сорвалась до замены файлов, прежняя версия продолжает
работать.

Полный журнал каждого запуска установщик сохраняет в `%TEMP%\NeuroSquad-Setup-<дата>.log`, а его
копию — как `install.log` в папке установки. Кнопки **Скопировать журнал** и **Открыть файл
журнала** есть в панели журнала — приложите журнал, когда сообщаете о проблеме.

## Дальше

  - **[Ваш первый воркспейс](https://docs.neurosquad.ai/ru/getting-started/first-workspace)**: Покажите NeuroSquad папку проекта — или изучите демо.
