Instalá MercaderIA paso a paso
Sin conocimientos técnicos. Te decimos exactamente qué vas a ver en pantalla en cada momento y qué hacer si no lo ves. Si algo parece raro, casi siempre es normal: te lo explicamos cuando toque.
MercaderIA se apoya en cuatro piezas. No hace falta que entiendas cómo funcionan, solo que estén ahí:
- Node.js: El motor que hace funcionar las herramientas por debajo.
- Git: Una utilidad que esas herramientas usan internamente.
- Claude Code: La inteligencia artificial que va a trabajar en tu tienda.
- MercaderIA: El sistema agéntico que hace que toda tu tienda se automatice.
Lo más importante de toda esta página
MercaderIA instala Git y Claude Code por vos, pero Node.js tenés que instalarlo vos antes. Si te saltás este orden, la app va a decirte que falta algo. Empezá por el paso 1.
Esto va antes de descargar MercaderIA. Entrá a la web oficial y descargá la versión que dice LTS.
Descargar Node.js LTSLTS quiere decir “versión estable con soporte largo”. Si ves dos botones, elegí siempre el de LTS, nunca el que dice “Current”.
Al instalarlo: siguiente, siguiente, siguiente. No cambies nada, aceptá todo por defecto.
Cerrá todas las terminales y reiniciá el ordenador
Si es la primera vez que instalás Node, reiniciá el equipo. El sistema tarda en “darse cuenta” de que hay un programa nuevo, y reiniciar es la forma infalible de que se entere. Esto evita el error más común de toda la instalación.
Comprobá que funcionó:
Abrí Terminal (te explicamos cómo en el paso 2) y escribí:
node --versionTiene que responder algo como v22.14.0. Si lo hace, listo.
Si dice “command not found: node”, no quedó instalado o no reiniciaste: reiniciá y volvé a probar.
La terminal es una ventana donde escribís órdenes en texto, pulsás Enter y el programa te responde. Nada más. No vas a romper nada.
macOS
- Pulsá Cmd + Espacio.
- Escribí terminal.
- Pulsá Enter.
Windows
- Pulsá la tecla Windows.
- Escribí powershell.
- Abrí Windows PowerShell.
maria@MacBook ~ % node --version v22.14.0 maria@MacBook ~ %
La ventana negra o azul con texto es completamente normal: así se ve una terminal recién abierta.
Copiar y pegar está permitido (y recomendado)
No hace falta escribir nada a mano. Usá el botón Copiar de cada bloque de esta guía y pegá en la terminal con Cmd + V.
Dato útil para el futuro: si alguna vez la terminal te pide una contraseña, no se ve nada mientras escribís — ni puntos ni asteriscos. Es una protección, no está roto. Con MercaderIA no te va a pasar, pero conviene saberlo.
Hay dos caminos. Los dos valen:
Opción A — a mano desde la terminal (recomendada)
Abrí Terminal y pegá esta línea:
curl -fsSL https://claude.ai/install.sh | bashOpción B — dejá que MercaderIA lo haga
Al abrir MercaderIA por primera vez, un asistente detecta lo que falta e instala Git y Claude Code solo. Es lo más fácil, pero a veces tarda en propagarse y hay que cerrar y volver a abrir la app para que lo reconozca. Reiniciando el ordenador o esperando unos minutos se conecta todo solo. Esto solo pasa al principio: nunca vuelve a ocurrir una vez conectado.
Va a salir bastante texto pasando por la pantalla. Es normal. Terminó cuando vuelve a aparecer la línea donde se escribe ($).
Después de instalar Claude Code, escribís claude en la terminal y te responde:
zsh: command not found: claude
Tranquilo: es lo esperado, no es un fallo raro. El programa sí está instalado, pero quedó guardado en una carpeta que la terminal no tiene en su lista de sitios donde buscar. Es como tener el libro en casa pero no en la estantería donde siempre mirás: hay que decirle al ordenador dónde está.
macOS — pegá estas dos líneas, una detrás de otra:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrcLa primera añade la carpeta a la lista de forma permanente (por ejemplo /Users/maria/.local/bin). La segunda hace que la terminal se dé cuenta ya, sin reiniciar.
Comprobá con:
claude --versionSi aun así no funciona, no pasa nada grave
MercaderIA busca el programa en muchas carpetas distintas y suele encontrarlo aunque la terminal no lo vea. Seguí adelante y probá la app.
Claude Code necesita una cuenta. La primera vez te pide iniciar sesión: se abre una pestaña del navegador, entrás con tu cuenta de Claude, aceptás y volvés a la app.
MercaderIA abre esa pestaña automáticamente cuando acaba de instalar Claude Code por primera vez. Si ya tenías Claude instalado de antes, la app da por hecho que ya iniciaste sesión y no la abre. Si resulta que no, se arregla abriendo la terminal y escribiendo:
claude…y siguiendo lo que aparezca en pantalla.
Son dos cosas distintas, no las confundas
Necesitás una cuenta de Claude con plan activo y, aparte, una licencia de MercaderIA. Una no incluye la otra.
Si macOS dice que no puede comprobar el desarrollador
Abrí el .dmg y arrastrá MercaderIA a la carpeta Aplicaciones. Si al abrirla aparece el aviso, hacé clic derecho sobre la app → Abrir → Abrir. Sale porque la app todavía no está firmada por Apple, no porque sea peligrosa.
Vas a ver una lista con Git, Claude Code y Node.js, cada uno con su estado, y la app instalando sola lo que falte.
- Node.jsEncontrado — v22.14.0
- GitInstalando…
- Claude CodeNo encontrado
Si algo sigue apareciendo como “no encontrado” después de instalarlo
Cerrá MercaderIA por completo y volvé a abrirla. La app hereda la lista de programas del sistema en el momento de arrancar, así que lo que se instala mientras está abierta no lo ve hasta el siguiente arranque. No es un fallo, es cómo funciona. En un ordenador donde nunca hubo nada de esto instalado, es normal tener que reiniciar la app una o dos veces antes de que todo salga en verde.
Si la lista parece congelada, está comprobando
La comprobación de cada programa espera hasta 10 segundos. Dale tiempo.
La app te va a pedir la dirección de tu tienda con este formato:
mitienda.myshopify.comOjo: es esa dirección, no el dominio bonito de tu tienda. Para encontrarla, entrá al panel de Shopify → Configuración → Dominios: ahí aparece tu dominio .myshopify.com, marcado como dominio interno de Shopify.
Después se abre el navegador con una pantalla de Shopify pidiendo autorizar permisos. Es una lista larga y es normal: el asistente necesita poder leer y editar productos, pedidos, inventario, envíos y devoluciones para poder trabajar por vos. Revisala y aceptá.
Si ya habías conectado la tienda antes
La app puede volver a pedirte autorización para añadir permisos nuevos de una versión más reciente. Es esperado, no es un error.
Marcá cada punto. Si los cinco están, ya podés empezar a trabajar hablando con tu tienda.
Problemas frecuentes
claude: command not found / “no se reconoce el comando”
El programa está instalado pero la terminal no sabe dónde buscarlo. Aplicá el arreglo del paso 4 (PATH) y volvé a probar con claude --version. En Windows, cerrá y reabrí PowerShell.
node: command not found después de instalar Node
Reiniciá el ordenador. El sistema necesita rearrancar para registrar el programa nuevo. Después probá node --version.
La app dice que falta algo que ya instalé
Cerrá MercaderIA por completo y volvé a abrirla. La app lee el entorno al arrancar; lo instalado mientras estaba abierta no lo ve hasta el siguiente inicio.
La pantalla de permisos de Shopify da error
Cerrá la pestaña y volvé a lanzar la conexión desde la app. Si insiste, escribinos con una captura.
macOS no me deja abrir la app
Clic derecho sobre MercaderIA en Aplicaciones → Abrir → Abrir. Es el aviso de app sin firmar, no un problema de seguridad real.
Windows dice que el programa no es seguro
Más información → Ejecutar de todas formas. SmartScreen muestra ese aviso con instaladores nuevos.
En un ordenador nuevo no me detecta nada
Es el caso normal. Orden correcto: instalá Node.js, reiniciá el ordenador, abrí MercaderIA y dejá que instale Git y Claude Code, y reiniciá la app. Todo en verde.
¿Seguís atascado?
Escribinos y te acompañamos hasta que quede funcionando. Contanos qué paso estabas haciendo y qué te apareció en pantalla (una captura ayuda muchísimo).
todo@mercaderia.co