Guía de instalación

HagiCode ofrece tres métodos de instalación. Elija primero una ruta según su caso de uso, confirme después los requisitos previos que esa ruta necesita y, por último, vaya a la página de instalación correspondiente.

Elegir un método de instalación

Su escenario	Método recomendado
Uso local personal en Windows	Instalación desde Microsoft Store
Uso local personal en macOS / Linux, o Windows sin acceso a la Store	Instalación de Desktop
Servidor, NAS, uso compartido en equipo o necesidad de aislar el entorno	Instalación con Docker Compose

Instalación desde Microsoft StorePunto de entrada recomendado por defecto en Windows: la instalación y las actualizaciones posteriores se gestionan a través de la tienda oficial.

Instalación de DesktopFlujo gráfico de instalación y gestión. Adecuado para macOS / Linux y para usuarios de Windows que necesitan descargar el paquete de instalación manualmente.

Instalación con Docker ComposeAdecuado para escenarios que requieren aislamiento del entorno, despliegue unificado o colaboración en equipo.

Requisitos previos

Cada ruta tiene requisitos previos distintos:

Método de instalación	Node.js	Git
Microsoft Store / Desktop	Debe instalarlo usted mismo: versión 24 o superior	Debe instalarlo usted mismo
Docker Compose	No es necesario en el host	No es necesario en el host

Desktop ya no incluye Node.js

Desktop solo incluye el runtime de .NET necesario para ejecutar HagiCode Server y ya no proporciona Node.js. Busca node y npm en el PATH del sistema e instala los paquetes gestionados, como los Agent CLI, en el directorio global de npm de su equipo. Instale Node.js 24 o superior antes de iniciar Desktop por primera vez; consulte Instalar Node.js.

Instalar Git

Desktop comprueba node, npm y git al iniciarse, y el “Proyecto de demostración” del cuadro de diálogo “Nuevo proyecto” de la interfaz principal también necesita Git para clonar el repositorio de ejemplo oficial. Elija una forma de instalarlo según su sistema:

• Windows: ejecute winget install --id Git.Git -e o descargue el instalador desde git-scm.com.
• macOS: ejecute xcode-select --install o, con Homebrew, brew install git.
• Debian / Ubuntu: ejecute sudo apt-get install -y git.
• Fedora: ejecute sudo dnf install -y git.

Cuando termine la instalación, vuelva a abrir la terminal y confirme que los comandos funcionan:

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

Inicie Desktop después de instalarlos

Desktop lee el PATH del sistema al iniciarse. Si instala Node.js o Git con Desktop ya abierto, ciérrelo por completo y vuelva a iniciarlo.

Agent CLI

HagiCode funciona con los Agent CLI que estén instalados y con la sesión iniciada en su equipo. El asistente de inicialización solo lista los CLI detectados localmente, así que instale al menos uno e inicie sesión antes de entrar en el asistente. Los CLI admitidos, sus métodos de instalación y los puntos de entrada oficiales se mantienen en Instalación de AI Agent CLI.

Instalación de software relacionado

Instalar Node.jsPrepare Node.js 24+ y npm, de los que dependen Desktop y la mayoría de los Agent CLI.

Introducción a OpenSpecVaya al sitio de documentación independiente de OpenSpec para conocer su instalación, sus conceptos clave y el flujo de trabajo basado en especificaciones.

Instalar AI Agent CLIConsulte los Agent CLI admitidos actualmente y distinga entre la instalación con un clic y la instalación / autenticación manual.

Próximos pasos

1. Elija un método de instalación según la tabla anterior y complete primero sus requisitos previos.
2. Termine la instalación y el primer arranque; después siga Configuración del asistente para crear el Hagicoder predeterminado y su primer proyecto.
3. Si quiere conocer el flujo de propuestas de OpenSpec, lea Introducción a OpenSpec y Crear una sesión de propuesta.