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

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

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

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

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

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

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

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

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

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 и Создать сеанс предложений.