Installa MercaderIA passo passo
Senza competenze tecniche. Ti diciamo esattamente cosa vedrai sullo schermo in ogni momento e cosa fare se non lo vedi. Se qualcosa sembra strano, quasi sempre è normale: te lo spieghiamo al momento giusto.
MercaderIA si appoggia su quattro pezzi. Non serve capire come funzionano, basta che ci siano:
- Node.js: Il motore che fa funzionare gli strumenti sottostanti.
- Git: Un'utilità che quegli strumenti usano internamente.
- Claude Code: L'intelligenza artificiale che lavorerà sul tuo negozio.
- MercaderIA: Il sistema agentico che automatizza tutto il tuo negozio.
La cosa più importante di tutta la pagina
MercaderIA installa Git e Claude Code al posto tuo, ma Node.js devi installarlo tu prima. Se salti quest'ordine, l'app ti dirà che manca qualcosa. Parti dal passo 1.
Questo viene prima di scaricare MercaderIA. Vai sul sito ufficiale e scarica la versione contrassegnata LTS.
Scarica Node.js LTSLTS significa “versione stabile con supporto a lungo termine”. Se vedi due pulsanti, scegli sempre LTS, mai quello “Current”.
Durante l'installazione: avanti, avanti, avanti. Non cambiare nulla, accetta tutto come proposto.
Chiudi tutti i terminali e riavvia il computer
Se è la prima volta che installi Node, riavvia la macchina. Il sistema ci mette un po' ad “accorgersi” che c'è un programma nuovo, e riavviare è il modo infallibile. Così eviti l'errore più comune di tutta l'installazione.
Verifica che abbia funzionato:
Apri Terminal (spieghiamo come al passo 2) e scrivi:
node --versionDeve rispondere qualcosa come v22.14.0. Se lo fa, è tutto a posto.
Se dice “command not found: node”, non è installato o non hai riavviato: riavvia e riprova.
Il terminale è una finestra dove scrivi comandi in testo, premi Invio e il programma risponde. Nient'altro. Non romperai nulla.
macOS
- Premi Cmd + Spazio.
- Scrivi terminale.
- Premi Invio.
Windows
- Premi il tasto Windows.
- Scrivi powershell.
- Apri Windows PowerShell.
maria@MacBook ~ % node --version v22.14.0 maria@MacBook ~ %
La finestra nera o blu piena di testo è del tutto normale: così appare un terminale appena aperto.
Copia e incolla è permesso (e consigliato)
Non serve scrivere nulla a mano. Usa il pulsante Copia di ogni blocco di questa guida e incolla nel terminale con Cmd + V.
Utile per il futuro: se un giorno il terminale ti chiede una password, non si vede nulla mentre scrivi — né punti né asterischi. È una protezione, non è rotto. Con MercaderIA non succederà, ma è bene saperlo.
Ci sono due strade. Vanno bene entrambe:
Opzione A — a mano dal terminale (consigliata)
Apri Terminal e incolla questa riga:
curl -fsSL https://claude.ai/install.sh | bashOpzione B — lascia fare a MercaderIA
Alla prima apertura di MercaderIA, un assistente rileva cosa manca e installa Git e Claude Code da solo. È la via più facile, ma a volte ci mette un po' a propagarsi e serve chiudere e riaprire l'app perché la riconosca. Riavviando il computer o aspettando qualche minuto si collega tutto da solo. Succede solo all'inizio: non si ripete più una volta collegato.
Scorrerà parecchio testo. È normale. È finito quando ricompare la riga dove si scrive ($).
Dopo aver installato Claude Code scrivi claude nel terminale e ti risponde:
zsh: command not found: claude
Tranquillo: è previsto, non è un guasto strano. Il programma è installato, ma è finito in una cartella che il terminale non ha nell'elenco dei posti dove cercare. È come avere il libro in casa ma non sullo scaffale dove guardi sempre: bisogna dire al computer dov'è.
macOS — incolla queste due righe, una dopo l'altra:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrcLa prima aggiunge la cartella all'elenco in modo permanente (per esempio /Users/maria/.local/bin). La seconda fa sì che il terminale se ne accorga subito, senza riavviare.
Verifica con:
claude --versionSe ancora non funziona, non è grave
MercaderIA cerca il programma in molte cartelle diverse e di solito lo trova anche se il terminale non lo vede. Vai avanti e prova l'app.
Claude Code richiede un account. La prima volta chiede l'accesso: si apre una scheda del browser, entri con il tuo account Claude, accetti e torni all'app.
MercaderIA apre quella scheda automaticamente quando ha appena installato Claude Code per la prima volta. Se avevi già Claude installato, l'app dà per scontato che tu abbia fatto l'accesso e non la apre. Se non è così, basta aprire il terminale e scrivere:
claude…e seguire ciò che appare sullo schermo.
Sono due cose diverse, non confonderle
Ti serve un account Claude con piano attivo e, a parte, una licenza MercaderIA. Una non include l'altra.
Se macOS dice che non può verificare lo sviluppatore
Apri il .dmg e trascina MercaderIA nella cartella Applicazioni. Se all'apertura compare l'avviso, fai clic destro sull'app → Apri → Apri. Compare perché l'app non è ancora firmata da Apple, non perché sia pericolosa.
Vedrai un elenco con Git, Claude Code e Node.js, ciascuno con il suo stato, e l'app che installa da sola ciò che manca.
- Node.jsTrovato — v22.14.0
- GitInstallazione…
- Claude CodeNon trovato
Se qualcosa risulta ancora “non trovato” dopo averlo installato
Chiudi MercaderIA del tutto e riaprila. L'app eredita l'elenco dei programmi di sistema all'avvio, quindi ciò che si installa mentre è aperta non lo vede fino al riavvio successivo. Non è un difetto, funziona così. Su un computer dove non c'era nulla di tutto questo, è normale riavviare l'app una o due volte prima che sia tutto verde.
Se l'elenco sembra bloccato, sta controllando
Il controllo di ogni programma attende fino a 10 secondi. Dagli tempo.
L'app ti chiederà l'indirizzo del tuo negozio in questo formato:
mitienda.myshopify.comAttenzione: è quell'indirizzo, non il dominio elegante del tuo negozio. Per trovarlo entra nel pannello Shopify → Impostazioni → Domini: lì compare il dominio .myshopify.com, indicato come dominio interno di Shopify.
Poi il browser apre una schermata Shopify che chiede di autorizzare i permessi. È un elenco lungo ed è normale: l'assistente deve poter leggere e modificare prodotti, ordini, inventario, spedizioni e resi per lavorare al posto tuo. Controlla e accetta.
Se avevi già collegato il negozio
L'app può richiedere di nuovo l'autorizzazione per aggiungere permessi nuovi di una versione più recente. È previsto, non è un errore.
Spunta ogni voce. Se ci sono tutte e cinque, puoi iniziare a lavorare parlando con il tuo negozio.
Problemi frequenti
claude: command not found / “non è riconosciuto come comando”
Il programma è installato ma il terminale non sa dove cercarlo. Applica la correzione del passo 4 (PATH) e riprova con claude --version. Su Windows chiudi e riapri PowerShell.
node: command not found dopo aver installato Node
Riavvia il computer. Il sistema ha bisogno di un riavvio per registrare il programma nuovo. Poi prova node --version.
L'app dice che manca qualcosa che ho già installato
Chiudi MercaderIA del tutto e riaprila. L'app legge l'ambiente all'avvio; ciò che è stato installato mentre era aperta compare solo al riavvio.
La schermata dei permessi Shopify dà errore
Chiudi la scheda e rilancia la connessione dall'app. Se insiste, scrivici con uno screenshot.
macOS non mi fa aprire l'app
Clic destro su MercaderIA in Applicazioni → Apri → Apri. È l'avviso di app non firmata, non un vero problema di sicurezza.
Windows dice che il programma non è sicuro
Ulteriori informazioni → Esegui comunque. SmartScreen mostra quell'avviso con gli installer nuovi.
Su un computer nuovo non rileva nulla
È il caso normale. Ordine corretto: installa Node.js, riavvia il computer, apri MercaderIA e lascia che installi Git e Claude Code, poi riavvia l'app. Tutto verde.
Ancora bloccato?
Scrivici e ti seguiamo finché non funziona. Raccontaci a che passo eri e cosa è comparso sullo schermo (uno screenshot aiuta moltissimo).
todo@mercaderia.co