Instale o MercaderIA passo a passo
Sem conhecimento técnico. Dizemos exatamente o que você vai ver na tela em cada momento e o que fazer se não vir. Se algo parecer estranho, quase sempre é normal: explicamos na hora certa.
O MercaderIA se apoia em quatro peças. Você não precisa entender como funcionam, só que estejam lá:
- Node.js: O motor que faz as ferramentas funcionarem por baixo.
- Git: Um utilitário que essas ferramentas usam internamente.
- Claude Code: A inteligência artificial que vai trabalhar na sua loja.
- MercaderIA: O sistema agêntico que automatiza a sua loja inteira.
O mais importante desta página inteira
O MercaderIA instala Git e Claude Code por você, mas o Node.js você precisa instalar antes. Se pular essa ordem, o app vai dizer que falta algo. Comece pelo passo 1.
Isso vem antes de baixar o MercaderIA. Entre no site oficial e baixe a versão marcada como LTS.
Baixar Node.js LTSLTS quer dizer “versão estável com suporte longo”. Se vir dois botões, escolha sempre o LTS, nunca o “Current”.
Na instalação: avançar, avançar, avançar. Não mude nada, aceite tudo como está.
Feche todos os terminais e reinicie o computador
Se é a primeira vez que instala o Node, reinicie a máquina. O sistema demora a “perceber” que há um programa novo, e reiniciar é a forma infalível de fazê-lo perceber. Isso evita o erro mais comum de toda a instalação.
Confira se funcionou:
Abra o Terminal (explicamos como no passo 2) e digite:
node --versionDeve responder algo como v22.14.0. Se responder, está pronto.
Se disser “command not found: node”, não ficou instalado ou você não reiniciou: reinicie e tente de novo.
O terminal é uma janela onde você escreve ordens em texto, pressiona Enter e o programa responde. Só isso. Você não vai quebrar nada.
macOS
- Pressione Cmd + Espaço.
- Digite terminal.
- Pressione Enter.
Windows
- Pressione a tecla Windows.
- Digite powershell.
- Abra o Windows PowerShell.
maria@MacBook ~ % node --version v22.14.0 maria@MacBook ~ %
A janela preta ou azul cheia de texto é completamente normal: é assim que um terminal recém-aberto aparece.
Copiar e colar é permitido (e recomendado)
Não precisa digitar nada à mão. Use o botão Copiar de cada bloco deste guia e cole no terminal com Cmd + V.
Dica para o futuro: se um dia o terminal pedir uma senha, nada aparece enquanto você digita — nem pontos nem asteriscos. É proteção, não está quebrado. Com o MercaderIA não vai acontecer, mas é bom saber.
Há dois caminhos. Os dois valem:
Opção A — manualmente pelo terminal (recomendada)
Abra o Terminal e cole esta linha:
curl -fsSL https://claude.ai/install.sh | bashOpção B — deixe o MercaderIA fazer
Ao abrir o MercaderIA pela primeira vez, um assistente detecta o que falta e instala Git e Claude Code sozinho. É o mais fácil, mas às vezes demora a propagar e é preciso fechar e reabrir o app para ele reconhecer. Reiniciando o computador ou esperando alguns minutos tudo se conecta sozinho. Isso só acontece no começo: nunca mais se repete depois de conectado.
Vai passar bastante texto na tela. É normal. Terminou quando a linha onde se escreve aparece de novo ($).
Depois de instalar o Claude Code, você escreve claude no terminal e ele responde:
zsh: command not found: claude
Calma: é o esperado, não é uma falha estranha. O programa está instalado, mas ficou numa pasta que o terminal não tem na lista de lugares onde procurar. É como ter o livro em casa mas não na estante onde você sempre olha: é preciso dizer ao computador onde ele está.
macOS — cole estas duas linhas, uma depois da outra:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrcA primeira adiciona a pasta à lista de forma permanente (por exemplo /Users/maria/.local/bin). A segunda faz o terminal perceber na hora, sem reiniciar.
Confira com:
claude --versionSe mesmo assim não funcionar, nada grave
O MercaderIA procura o programa em várias pastas diferentes e costuma encontrá-lo mesmo que o terminal não veja. Siga em frente e teste o app.
O Claude Code precisa de uma conta. Na primeira vez ele pede login: abre uma aba do navegador, você entra com sua conta Claude, aceita e volta ao app.
O MercaderIA abre essa aba automaticamente quando acabou de instalar o Claude Code pela primeira vez. Se você já tinha o Claude instalado, o app supõe que já fez login e não abre. Se não for o caso, resolve abrindo o terminal e digitando:
claude…e seguindo o que aparecer na tela.
São duas coisas diferentes, não confunda
Você precisa de uma conta Claude com plano ativo e, à parte, uma licença do MercaderIA. Uma não inclui a outra.
Se o macOS disser que não pode verificar o desenvolvedor
Abra o .dmg e arraste o MercaderIA para a pasta Aplicativos. Se o aviso aparecer ao abrir, clique com o botão direito no app → Abrir → Abrir. Aparece porque o app ainda não está assinado pela Apple, não porque seja perigoso.
Você vai ver uma lista com Git, Claude Code e Node.js, cada um com seu estado, e o app instalando sozinho o que faltar.
- Node.jsEncontrado — v22.14.0
- GitInstalando…
- Claude CodeNão encontrado
Se algo continuar como “não encontrado” depois de instalado
Feche o MercaderIA por completo e abra de novo. O app herda a lista de programas do sistema no momento em que inicia, então o que é instalado com ele aberto só aparece na próxima inicialização. Não é falha, é como funciona. Num computador onde nunca houve nada disso, é normal reiniciar o app uma ou duas vezes até tudo ficar verde.
Se a lista parecer congelada, está verificando
A verificação de cada programa espera até 10 segundos. Dê tempo.
O app vai pedir o endereço da sua loja neste formato:
mitienda.myshopify.comAtenção: é esse endereço, não o domínio bonito da sua loja. Para encontrá-lo, entre no painel da Shopify → Configurações → Domínios: ali aparece o domínio .myshopify.com, marcado como domínio interno da Shopify.
Depois o navegador abre uma tela da Shopify pedindo autorização de permissões. É uma lista longa e é normal: o assistente precisa ler e editar produtos, pedidos, estoque, envios e devoluções para trabalhar por você. Revise e aceite.
Se você já tinha conectado a loja antes
O app pode pedir autorização de novo para adicionar permissões novas de uma versão mais recente. É esperado, não é erro.
Marque cada ponto. Se os cinco estiverem prontos, já pode começar a trabalhar conversando com sua loja.
Problemas frequentes
claude: command not found / “não é reconhecido como comando”
O programa está instalado mas o terminal não sabe onde procurar. Aplique a correção do passo 4 (PATH) e teste claude --version de novo. No Windows, feche e reabra o PowerShell.
node: command not found depois de instalar o Node
Reinicie o computador. O sistema precisa reiniciar para registrar o programa novo. Depois teste node --version.
O app diz que falta algo que já instalei
Feche o MercaderIA por completo e abra de novo. O app lê o ambiente ao iniciar; o que foi instalado com ele aberto só aparece na próxima vez.
A tela de permissões da Shopify dá erro
Feche a aba e lance a conexão de novo pelo app. Se insistir, escreva para nós com uma captura de tela.
O macOS não me deixa abrir o app
Clique com o botão direito no MercaderIA em Aplicativos → Abrir → Abrir. É o aviso de app sem assinatura, não um problema real de segurança.
O Windows diz que o programa não é seguro
Mais informações → Executar assim mesmo. O SmartScreen mostra esse aviso com instaladores novos.
Num computador novo não detecta nada
É o caso normal. Ordem correta: instale o Node.js, reinicie o computador, abra o MercaderIA e deixe instalar Git e Claude Code, e reinicie o app. Tudo verde.
Ainda travado?
Escreva para nós e acompanhamos até funcionar. Conte em que passo estava e o que apareceu na tela (uma captura ajuda muito).
todo@mercaderia.co