Contenido de la documentación02 / 16

Primeros pasos02 / 16

Instalar y preparar Noea

En esta página

Para empezar, instala la aplicación de escritorio Noea y prepara al menos un Agente de programación. La aplicación te guía durante la instalación, el inicio de sesión y la verificación de la conexión.

Elige un instalador

Visita la sección de descarga de Noea y elige la versión para tu sistema operativo y procesador.

SistemaQué elegir
macOSApple silicon, macOS 13 o posterior. Actualmente no hay un instalador para Mac con Intel.
Windowsx64 para procesadores Intel o AMD; ARM64 para dispositivos Windows con ARM.
Linuxx86_64 o ARM64 según tu procesador. Hay paquetes AppImage y .deb.

En macOS, abre la imagen de disco e instala la aplicación. En Windows, ejecuta el instalador; la instalación se realiza para el usuario actual sin privilegios de administrador. En Linux, utiliza AppImage o .deb según tu distribución.

Prepara tu primer Agente

Si ningún Agente está listo al iniciar Noea, se abre la guía de configuración.

  1. Elige un Agente de la lista y pulsa Instalar.
  2. Espera a que termine la descarga y sigue el panel de detalles para iniciar sesión y autorizar el acceso.
  3. Espera a que Noea verifique la conexión. Solo el estado Listo indica que la verificación se ha superado.
  4. Elige la opción para empezar a usar Noea y entrar en el área de trabajo.

Noea admite actualmente Codex, Claude Code, OpenCode y CodeBuddy Code. Solo necesitas uno para empezar. Puedes añadir otros más adelante en Configuración → Agente.

Noea descarga el entorno de ejecución que necesita el Agente, por lo que no tienes que instalar Node.js previamente. La aplicación muestra el progreso de descarga y preparación.

Inicia sesión con el método del Agente

El inicio de sesión puede abrir un navegador, un terminal integrado o un terminal del sistema, o pedir una clave de API. Sigue las instrucciones del Agente seleccionado.

Codex prefiere el inicio de sesión mediante navegador en macOS y Windows, y mediante código de dispositivo en Linux. OpenCode se configura conectando un proveedor de modelos. Para las cuentas de proveedores, claves de API y puntos de conexión personalizados, consulta Agentes, modelos y uso.

Noea vuelve a verificar la conexión después del inicio de sesión. Si sigue solicitándolo o informa de un error, abre el panel de detalles del Agente para consultar la causa.

Aunque ya utilices un Agente en otra herramienta de terminal, consulta su estado en la lista de Noea para saber si está listo aquí.

Resuelve problemas de descarga o verificación

Las descargas y solicitudes del Agente utilizan la configuración de proxy HTTP(S) del sistema. Las variables de entorno del proxy tienen prioridad cuando están definidas. Este mecanismo no admite proxies SOCKS.

Si una descarga falla, comprueba la red y el proxy y vuelve a intentarlo desde el mismo lugar. Un estado de preparación durante una breve pausa en la recepción de datos no significa necesariamente que la descarga haya fallado.

Si la instalación termina pero la verificación falla, utiliza el panel de detalles del Agente para volver a iniciar sesión, corregir la configuración del proveedor o solucionar problemas de red. Puedes copiar los diagnósticos al pedir ayuda; consulta Solución de problemas.

Abre tu proyecto

En el área de trabajo, elige Abrir carpeta… y selecciona tu carpeta de código. Noea abre o crea un proyecto vinculado. No necesitas un documento completo de requisitos, servidores MCP ni Skills para seguir el primer tutorial.

Continúa con Tu primer flujo de trabajo.