Руководство по установке

HagiCode предлагает три способа установки. Сначала выберите путь, который подходит вашему сценарию, затем проверьте предварительные требования для этого пути и только после этого переходите на соответствующую страницу установки.

Выберите способ установки

Ваш сценарий	Рекомендуемый способ
Личное локальное использование в Windows	Установка из Microsoft Store
Личное локальное использование в macOS / Linux или Windows, где нельзя использовать Store	Установка Desktop
Сервер, NAS, совместная работа в команде или нужна изоляция среды	Установка Docker Compose

Установка из Microsoft StoreРекомендуемый вариант для Windows: установка и последующие обновления через официальный магазин.

Установка DesktopГрафический процесс установки и управления. Подходит для macOS / Linux, а также для пользователей Windows, которым нужно скачать установочный пакет вручную.

Установка Docker ComposeПодходит для сценариев, где нужны изоляция среды, единообразное развертывание или командная работа.

Подготовка перед установкой

Для разных путей установки нужны разные предварительные условия:

Способ установки	Node.js	Git
Microsoft Store / Desktop	Нужно установить самостоятельно, версия 24 или выше	Нужно установить самостоятельно
Docker Compose	На хосте устанавливать не нужно	На хосте устанавливать не нужно

Desktop больше не включает Node.js

Desktop включает только среду выполнения .NET, необходимую для запуска HagiCode Server, и больше не поставляет Node.js. Он ищет node и npm в системной переменной PATH и устанавливает управляемые пакеты, например Agent CLI, в глобальный каталог npm на вашем компьютере. Установите Node.js 24 или выше до первого запуска Desktop; подробности смотрите в разделе Установка Node.js.

Установка Git

Desktop при запуске проверяет наличие node, npm и git, а «Демо-проект» в диалоге «Новый проект» главного интерфейса также использует Git, чтобы клонировать официальный репозиторий с примером. Выберите подходящий для вашей системы способ установки:

• Windows: выполните winget install --id Git.Git -e или скачайте установщик с git-scm.com.
• macOS: выполните xcode-select --install или, если вы используете Homebrew, brew install git.
• Debian / Ubuntu: выполните sudo apt-get install -y git.
• Fedora: выполните sudo dnf install -y git.

После установки заново откройте терминал и убедитесь, что команды доступны:

node --version
npm --version
git --version

Сначала установите, потом запускайте Desktop

Desktop читает системную переменную PATH при запуске. Если вы установили Node.js или Git, когда Desktop уже был открыт, полностью закройте Desktop и запустите его заново.

Agent CLI

HagiCode работает через Agent CLI, которые установлены на вашем компьютере и в которых уже выполнен вход. Мастер инициализации показывает только те CLI, которые обнаружены на этом компьютере, поэтому перед входом в мастер установите хотя бы один из них и выполните вход. Список поддерживаемых CLI, способы установки и официальные точки входа собраны в одном месте: Установка AI Agent CLI.

Сопутствующее программное обеспечение

Установка Node.jsПодготовьте Node.js 24+ и npm: от них зависят Desktop и большинство Agent CLI.

Введение в OpenSpecПерейдите на отдельный сайт документации OpenSpec, чтобы узнать о способах установки, основных понятиях и рабочем процессе, управляемом спецификациями.

Установка AI Agent CLIПосмотрите, какие Agent CLI поддерживаются сейчас, и чем установка в один клик отличается от ручной установки / аутентификации.

Дальнейшие шаги

1. Выберите способ установки по таблице выше и сначала выполните его предварительные требования.
2. Завершите установку и запустите HagiCode в первый раз, а затем по инструкции Настройка мастера инициализации создайте Hagicoder по умолчанию и первый проект.
3. Чтобы познакомиться с процессом предложений OpenSpec, прочитайте Введение в OpenSpec и Создать сеанс предложений.