# Установка на macOS

> Установите NeuroSquad на Mac с Apple silicon или Intel — одной строкой в Терминале или из .dmg — и что macOS спросит при первом запуске.

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

NeuroSquad работает на **macOS 12 Monterey и новее**; для **Apple silicon** (M1, M2, M3, M4 и новее)
и для Mac на **Intel** — отдельные сборки. Не знаете, какой у вас Mac? Меню Apple → **Об этом Mac**:
«Чип: Apple M…» — это Apple silicon, «Процессор: Intel» — Intel.

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

## Из Терминала (рекомендуем)

Одна строка выберет сборку для вашего Mac, сверит её с опубликованной контрольной суммой SHA-256,
положит **NeuroSquad.app** в **Программы** и откроет:

```bash
curl -fsSL https://neurosquad.ai/install.sh | bash
```

Если ваша учётная запись не может писать в `/Applications`, скрипт установит приложение в
`~/Applications` — пароль администратора не нужен ни в каком случае. Установленная так копия
открывается сразу, даже без вопроса при первом запуске, о котором ниже. Повторный запуск строки обновит
установленную версию.

## Через Homebrew

Если вы пользуетесь [Homebrew](https://brew.sh), установите NeuroSquad из нашего собственного tap:

```bash
brew install --cask glmn-ai/neurosquad/neurosquad
```

Он поставит сборку для вашего чипа, сверив её с контрольной суммой SHA-256, и снимет пометку о
загрузке, так что приложение откроется без вопроса при первом запуске. Дальше NeuroSquad обновляется
сам, поэтому `brew upgrade` его не трогает (`brew upgrade --greedy` обновит и его). `brew uninstall
--cask neurosquad` удаляет приложение; с `--zap` удалятся и ваши данные NeuroSquad.

## Из .dmg

**1. Скачайте .dmg для своего Mac**

На [странице загрузки](https://neurosquad.ai/ru/download/#macos) нажмите **Скачать .dmg** под
**Apple silicon** или **Intel** (страница подсвечивает тот, о котором сообщил браузер). Прямые
ссылки: [Apple silicon](https://neurosquad.ai/downloads/NeuroSquad-arm64.dmg),
[Intel](https://neurosquad.ai/downloads/NeuroSquad-x64.dmg); контрольные суммы —
[SHA256SUMS-mac.txt](https://neurosquad.ai/downloads/SHA256SUMS-mac.txt).

**2. Перетащите NeuroSquad в «Программы»**

Откройте .dmg и перетащите **NeuroSquad** на папку **Applications** рядом.

**3. Первый запуск: нажмите «Открыть»**

NeuroSquad подписан Apple Developer ID и нотаризован Apple. При первом открытии копии, скачанной
браузером, macOS задаст тот же вопрос, что и для любой программы из интернета: **«NeuroSquad» —
это приложение, загруженное из интернета. Вы действительно хотите его открыть?** — и добавит, что
Apple проверила его на вредоносное ПО и ничего не нашла. Нажмите **Открыть**. Больше macOS
спрашивать не будет.

> Вопрос касается способа загрузки, а не приложения: браузер помечает каждый скачанный файл как «из
> интернета». Установка из Терминала, Homebrew и обновления самого NeuroSquad скачивают без этой
> пометки, поэтому не будет даже этого вопроса.

### Если macOS всё равно не открывает приложение

Версии до 0.1.218 не были нотаризованы. Если macOS пишет, что **«NeuroSquad» не открыто**, что Apple
не может его проверить или что оно повреждено, скорее всего, у вас такая старая копия: переместите её
в Корзину и заново скачайте .dmg со [страницы загрузки](https://neurosquad.ai/ru/download/#macos) или
установите строкой в Терминале либо через Homebrew (см. выше). Ваши данные останутся на месте.

## Разрешения для диктовки

Голосовой диктовке нужны два разрешения macOS. **Настройки → Диктовка** показывают, чего не
хватает, с кнопкой **Разрешить** и переходом в нужный раздел Системных настроек:

- **Микрофон** — чтобы записывать голос. macOS спросит при первой диктовке.
- **Универсальный доступ** — для глобальной горячей клавиши диктовки, которая работает в любом
приложении. Включите **NeuroSquad** в **Системные настройки → Конфиденциальность и безопасность →
Универсальный доступ**; клавиша заработает сразу после разрешения.

После обновлений эти разрешения сохраняются. Одно исключение: если у вас стояла версия 0.1.214 —
первая сборка для Mac, — после обновления до 0.1.218 macOS ещё раз спросит Микрофон и Универсальный
доступ, потому что именно тогда подпись приложения сменилась на Apple Developer ID.

## Вход и мастер настройки

Дальше всё как на Windows — см. [Установка](https://docs.neurosquad.ai/ru/getting-started/installation), разделы про вход и мастер
настройки. На Mac мастер ставит CLI агентов через npm, а если npm нет — Node.js LTS в `~/.neurosquad/node`
(профиль shell не меняется); Git без участия пользователя он поставить не может и даёт ссылку на его
страницу загрузки (через Homebrew: `brew install git`).
Карточки терминала используют ваш login-shell (`$SHELL`, по умолчанию zsh), а NeuroSquad находит
CLI, установленные через Homebrew, npm, bun, cargo и т. п., хотя приложения, запущенные из Dock,
получают минимальный `PATH`.

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

NeuroSquad обновляется сам, как и на Windows: новая версия скачивается в фоне, сверяется с
контрольной суммой SHA-256 и устанавливается при перезапуске — приложение заменяется в своей папке и
открывается снова. **NeuroSquad → Проверить обновления…** в строке меню проверяет сразу.

Если NeuroSquad не может писать в свою папку (например, лежит в `/Applications`, а ваша учётная
запись — не администратор), он распакует обновление в **Загрузки** и покажет его в Finder: закройте
NeuroSquad и перетащите новую копию в «Программы» с заменой старой.

## Закрытие и выход

Красная кнопка закрытия прячет окно: NeuroSquad и его агенты продолжают работать, щелчок по значку в
Dock возвращает окно. Выход — **Cmd+Q** (или **NeuroSquad → Завершить NeuroSquad**), он останавливает
терминалы агентов.

## Удаление

Завершите NeuroSquad и перенесите **NeuroSquad.app** из «Программ» в Корзину. Ваши данные — воркспейсы,
агенты, настройки, модели диктовки — остаются в `~/Library/Application Support/NeuroSquad`; удалите и
эту папку, если хотите убрать всё. Папки ваших проектов не трогаются. См.
[Где хранятся ваши данные](https://docs.neurosquad.ai/ru/help/data).
