Configuración del asistente

Tanto si instala HagiCode mediante Microsoft Store, Desktop o Docker Compose, al abrir por primera vez la interfaz web de HagiCode accederá al asistente de inicialización. Cuando lo complete, tendrá un Hagicoder predeterminado utilizable y al menos un proyecto, y podrá empezar directamente su primera sesión.

No es lo mismo que la guía de primer uso de Desktop

La guía “Configuración por primera vez” que muestra Desktop en su primer arranque (elegir idioma, confirmar los documentos legales y descargar Hagicode Server) tiene lugar antes de que aparezca la interfaz web; consulte Instalación de Desktop. Esta página describe el asistente de inicialización que aparece después, dentro de la interfaz web.

Antes de empezar

Asegúrese primero de lo siguiente:

• Tiene al menos un Agent CLI instalado y con la sesión iniciada. El asistente solo lista los CLI detectados en la máquina donde se ejecuta Hagicode Server; si no se detecta ninguno, no podrá continuar con la creación de Hagicoder. Los CLI admitidos y sus métodos de instalación se describen en Instalación de AI Agent CLI.
• Usuarios de Desktop / Store: ha instalado Node.js 24+ y Git siguiendo la Guía de instalación.
• Usuarios de Docker: ha configurado el proveedor de API y el Token en Docker Compose Builder.
• Tenga preparado un repositorio local o un directorio de trabajo que quiera conectar: el paso 3 le pedirá que lo registre.

Descripción general del asistente

El asistente consta de 4 pasos, y la navegación de la izquierda muestra el progreso actual:

Paso	Objetivo	Indicador de finalización
1. Configuración inicial	Elegir el idioma de la interfaz y el tema	Hacer clic en “Siguiente: crear un proyecto”
2. Configurar Hagicoder	Elegir el CLI y el modelo, y crear el Hagicoder predeterminado	Hacer clic en “Confirmar y crear Hagicoder”, o que ya haya un Agente disponible
3. Crear un proyecto	Crear al menos un proyecto	El paso del proyecto muestra “Paso del proyecto completado”
4. Guía de comunidad	Conocer los puntos de entrada de la comunidad	Hacer clic en “Comience a usar HagiCode”

Paso 1: Configuración inicial

Objetivo: definir el idioma y el tema de la interfaz.

1. En “Elegir idioma de la interfaz”, seleccione un idioma. Esto solo cambia el texto de la interfaz; no modifica el estilo de lenguaje de Hagicoder.
2. En “Elegir tema”, seleccione un tema. Actualmente hay “Primavera clara” y “Primavera oscura”.
3. Haga clic en “Siguiente: crear un proyecto”.

Paso 2: Configurar Hagicoder

Objetivo: crear el Agente predeterminado, cuyo nombre es siempre Hagicoder.

Si el sistema ya tiene algún Agente, este paso muestra “Se encontraron Agentes existentes” y basta con conservar la alineación actual. En caso contrario:

1. Elige tu AgentCLI principal: la lista desplegable solo muestra los CLI detectados en la máquina. Si aparece el aviso de que no se ha detectado ningún CLI utilizable, complete primero la instalación y el inicio de sesión siguiendo Instalación de AI Agent CLI y vuelva aquí para actualizar.
2. Elige tu modelo principal:
   • Seleccionar una plantilla existente: reutiliza una plantilla de modelo que ya exista para ese CLI; puede buscar por nombre o por ID de modelo.
   • Introducir un modelo personalizado: escriba a mano el nombre del modelo, por ejemplo gpt-5.5, glm-5.1 o claude-opus-4-7; al crear, se reutilizará o creará automáticamente la plantilla correspondiente.
3. (Opcional) Haga clic en “Probar disponibilidad”: envía una verificación ping-pong al CLI y al modelo seleccionados para confirmar que el modelo puede responder pong. El resultado de la prueba solo es válido para la combinación actual de CLI y modelo; si la modifica, debe volver a probar. Crear Hagicoder no exige que la prueba se supere.
4. (Opcional) Haga clic en “Mezclar” para cambiar el retrato predeterminado; el avatar se elige al azar de la galería de imágenes.
5. Haga clic en “Confirmar y crear Hagicoder”. Una vez creado, se agrega al equipo de emergencia y el CLI y el modelo seleccionados se guardan en su configuración predeterminada.

Qué CLI se admiten

Los CLI que puede elegir en el asistente dependen de los Agent CLI instalados y detectados en la máquina, y no se limitan a uno concreto. El alcance de compatibilidad completo y los métodos de instalación se rigen por Instalación de AI Agent CLI; entre ellos, Hermes, Gemini y DeepAgents requieren completar primero la instalación o la autenticación manual.

Problemas habituales

• Mi CLI no aparece en la lista: confirme que está instalado y que está disponible en el entorno donde se ejecuta Hagicode Server; en Desktop, reinicie Desktop para actualizar el PATH.
• Falla la prueba de disponibilidad: las causas habituales son que el CLI aún no tiene la sesión iniciada, que el token no es válido o que el CLI no admite el nombre del modelo. Ejecute primero en la terminal una conversación mínima con ese CLI para confirmar que funciona por sí mismo.
• Falla al agregarlo al equipo de emergencia: la página ofrece “Reintentar agregar al equipo de emergencia”; basta con reintentar.

Paso 3: Crear un proyecto

Objetivo: registrar al menos un proyecto para que las sesiones posteriores tengan un directorio de trabajo legible. El asistente comprueba primero si ya existe algún proyecto local: si existe, muestra el resumen del proyecto actual; si no, primero debe registrar uno.

1. En “Registrar un proyecto local”, indique el nombre del proyecto, la ruta de la carpeta y, opcionalmente, una descripción del proyecto. Los campos y la validación de la ruta son exactamente los mismos que los del cuadro de diálogo “Nuevo proyecto” de la interfaz principal.
2. Haga clic en “Crear y continuar” para pasar al siguiente paso; si prefiere quedarse en este paso para seguir añadiendo proyectos, haga clic en “Crear proyecto”.
3. Si ya existen proyectos, puede hacer clic directamente en “Continuar a la comunidad”, o bien “Crear otro proyecto” o volver a la configuración (“Volver a la configuración”).

¿Quiere probar primero con un proyecto de ejemplo?

El asistente solo ofrece registrar un proyecto local. El proyecto de demostración se encuentra en la pestaña “Proyecto de demostración” del cuadro de diálogo “Nuevo proyecto” de la interfaz principal: clona y registra automáticamente el repositorio oficial MonoSpecs Demo, con la ruta predeterminada data/repos/monospecs-demo; el directorio real depende de la configuración del directorio de datos (DataDir) en tiempo de ejecución. Este método requiere Git y acceso a GitHub.

Problemas habituales

• Falla la validación de la ruta: confirme que la ruta de la carpeta es correcta y que existe realmente; en una implementación con Docker, debe indicar un directorio montado accesible dentro del contenedor, y no una ruta del host.

Paso 4: Guía de comunidad

Objetivo: tener a mano los puntos de entrada de la comunidad.

La página “Acerca de” del sitio web oficial reúne todos los canales de la comunidad. Los enlaces se abren en una pestaña nueva; cuando termine de verlos, vuelva al asistente y haga clic en “Comience a usar HagiCode” para entrar en el espacio de trabajo. Después de este paso, puede volver a abrir el asistente en cualquier momento.

Próximos pasos

Crear una sesión de conversaciónUse primero el modo de solo lectura predeterminado para que la IA comprenda el proyecto y, una vez confirmada la dirección, decida si cambia al modo de edición.

Crear una sesión de propuestaCuando necesite dividir un plan o revisar una solución, use la sesión de propuesta para convertir una idea en un plan de implementación estructurado.