Installez MercaderIA pas à pas
Aucune compétence technique requise. On vous dit exactement ce que vous verrez à l'écran à chaque instant et quoi faire si ce n'est pas le cas. Si quelque chose paraît bizarre, c'est presque toujours normal : on vous l'explique au bon moment.
MercaderIA repose sur quatre briques. Pas besoin de comprendre leur fonctionnement, seulement qu'elles soient là :
- Node.js: Le moteur qui fait tourner les outils en dessous.
- Git: Un utilitaire que ces outils utilisent en interne.
- Claude Code: L'intelligence artificielle qui va travailler sur votre boutique.
- MercaderIA: Le système agentique qui automatise toute votre boutique.
Le plus important de toute cette page
MercaderIA installe Git et Claude Code pour vous, mais Node.js, c'est à vous de l'installer avant. Si vous sautez cet ordre, l'app vous dira qu'il manque quelque chose. Commencez par l'étape 1.
Cela vient avant le téléchargement de MercaderIA. Allez sur le site officiel et téléchargez la version marquée LTS.
Télécharger Node.js LTSLTS veut dire « version stable avec support long ». Si vous voyez deux boutons, prenez toujours LTS, jamais « Current ».
À l'installation : suivant, suivant, suivant. Ne changez rien, acceptez tout par défaut.
Fermez tous les terminaux et redémarrez l'ordinateur
Si c'est votre première installation de Node, redémarrez la machine. Le système met du temps à « remarquer » qu'un nouveau programme existe, et redémarrer est le moyen infaillible. Cela évite l'erreur la plus fréquente de toute l'installation.
Vérifiez que ça a marché :
Ouvrez Terminal (on explique comment à l'étape 2) et tapez :
node --versionIl doit répondre quelque chose comme v22.14.0. Si c'est le cas, c'est bon.
S'il dit “command not found: node”, ce n'est pas installé ou vous n'avez pas redémarré : redémarrez et réessayez.
Le terminal est une fenêtre où vous tapez des ordres en texte, appuyez sur Entrée et le programme répond. Rien de plus. Vous ne casserez rien.
macOS
- Appuyez sur Cmd + Espace.
- Tapez terminal.
- Appuyez sur Entrée.
Windows
- Appuyez sur la touche Windows.
- Tapez powershell.
- Ouvrez Windows PowerShell.
maria@MacBook ~ % node --version v22.14.0 maria@MacBook ~ %
La fenêtre noire ou bleue remplie de texte est tout à fait normale : c'est l'apparence d'un terminal qui vient de s'ouvrir.
Copier-coller est permis (et recommandé)
Inutile de taper quoi que ce soit à la main. Utilisez le bouton Copier de chaque bloc de ce guide et collez dans le terminal avec Cmd + V.
Bon à savoir pour plus tard : si un jour le terminal vous demande un mot de passe, rien ne s'affiche pendant que vous tapez — ni points ni astérisques. C'est une protection, ce n'est pas cassé. Avec MercaderIA cela n'arrivera pas, mais autant le savoir.
Il y a deux chemins. Les deux marchent :
Option A — à la main depuis le terminal (recommandée)
Ouvrez Terminal et collez cette ligne :
curl -fsSL https://claude.ai/install.sh | bashOption B — laissez MercaderIA le faire
Au premier lancement de MercaderIA, un assistant détecte ce qui manque et installe Git et Claude Code tout seul. C'est le plus simple, mais la propagation prend parfois du temps et il faut fermer puis rouvrir l'app pour qu'elle le reconnaisse. En redémarrant l'ordinateur ou en attendant quelques minutes, tout se connecte seul. Cela n'arrive qu'au début : jamais plus une fois connecté.
Beaucoup de texte va défiler. C'est normal. C'est terminé quand la ligne de saisie réapparaît ($).
Après avoir installé Claude Code, vous tapez claude dans le terminal et il répond :
zsh: command not found: claude
Pas d'inquiétude : c'est attendu, pas une panne étrange. Le programme est bien installé, mais il se trouve dans un dossier qui n'est pas dans la liste des endroits où le terminal cherche. C'est comme avoir le livre chez soi mais pas sur l'étagère où l'on regarde toujours : il faut dire à l'ordinateur où il est.
macOS — collez ces deux lignes, l'une après l'autre :
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrcLa première ajoute le dossier à la liste de façon permanente (par exemple /Users/maria/.local/bin). La seconde fait que le terminal s'en aperçoit tout de suite, sans redémarrer.
Vérifiez avec :
claude --versionSi ça ne marche toujours pas, rien de grave
MercaderIA cherche le programme dans de nombreux dossiers et le trouve généralement même si le terminal ne le voit pas. Continuez et testez l'app.
Claude Code a besoin d'un compte. La première fois, il demande de se connecter : un onglet du navigateur s'ouvre, vous entrez avec votre compte Claude, vous acceptez et revenez à l'app.
MercaderIA ouvre cet onglet automatiquement quand il vient d'installer Claude Code pour la première fois. Si Claude était déjà installé, l'app suppose que vous êtes connecté et ne l'ouvre pas. Si ce n'est pas le cas, ouvrez le terminal et tapez :
claude…puis suivez ce qui s'affiche.
Ce sont deux choses différentes, ne les confondez pas
Il vous faut un compte Claude avec un plan actif et, séparément, une licence MercaderIA. L'un n'inclut pas l'autre.
Si macOS dit qu'il ne peut pas vérifier le développeur
Ouvrez le .dmg et glissez MercaderIA dans le dossier Applications. Si l'avertissement apparaît à l'ouverture, clic droit sur l'app → Ouvrir → Ouvrir. Il apparaît parce que l'app n'est pas encore signée par Apple, pas parce qu'elle est dangereuse.
Vous verrez une liste avec Git, Claude Code et Node.js, chacun avec son état, et l'app installant seule ce qui manque.
- Node.jsTrouvé — v22.14.0
- GitInstallation…
- Claude CodeIntrouvable
Si un élément reste « introuvable » après installation
Fermez complètement MercaderIA et rouvrez-la. L'app hérite de la liste des programmes du système au démarrage : ce qui est installé pendant qu'elle est ouverte reste invisible jusqu'au prochain lancement. Ce n'est pas un bug, c'est le fonctionnement. Sur un ordinateur vierge, il est normal de redémarrer l'app une ou deux fois avant que tout passe au vert.
Si la liste semble figée, elle vérifie
La vérification de chaque programme attend jusqu'à 10 secondes. Laissez-lui le temps.
L'app vous demandera l'adresse de votre boutique dans ce format :
mitienda.myshopify.comAttention : c'est cette adresse, pas le joli domaine de votre boutique. Pour la trouver, allez dans l'admin Shopify → Paramètres → Domaines : votre domaine .myshopify.com y apparaît, marqué comme domaine interne Shopify.
Ensuite le navigateur ouvre un écran Shopify demandant d'autoriser des permissions. La liste est longue et c'est normal : l'assistant doit pouvoir lire et modifier produits, commandes, stock, expéditions et retours pour travailler à votre place. Vérifiez et acceptez.
Si vous aviez déjà connecté la boutique
L'app peut redemander l'autorisation pour ajouter de nouvelles permissions d'une version plus récente. C'est attendu, ce n'est pas une erreur.
Cochez chaque point. Si les cinq sont là, vous pouvez commencer à travailler en parlant à votre boutique.
Problèmes fréquents
claude: command not found / « n'est pas reconnu »
Le programme est installé mais le terminal ne sait pas où chercher. Appliquez le correctif de l'étape 4 (PATH) et retestez claude --version. Sous Windows, fermez et rouvrez PowerShell.
node: command not found après avoir installé Node
Redémarrez l'ordinateur. Le système a besoin d'un redémarrage pour enregistrer le nouveau programme. Testez ensuite node --version.
L'app dit qu'il manque quelque chose que j'ai déjà installé
Fermez complètement MercaderIA et rouvrez-la. L'app lit l'environnement au démarrage ; ce qui a été installé pendant qu'elle était ouverte n'apparaît qu'au lancement suivant.
L'écran de permissions Shopify renvoie une erreur
Fermez l'onglet et relancez la connexion depuis l'app. Si cela persiste, écrivez-nous avec une capture.
macOS refuse d'ouvrir l'app
Clic droit sur MercaderIA dans Applications → Ouvrir → Ouvrir. C'est l'avertissement d'app non signée, pas un vrai problème de sécurité.
Windows dit que le programme n'est pas sûr
Informations complémentaires → Exécuter quand même. SmartScreen affiche cet avis pour les nouveaux installateurs.
Sur un ordinateur neuf rien n'est détecté
C'est le cas normal. Bon ordre : installez Node.js, redémarrez l'ordinateur, ouvrez MercaderIA et laissez-la installer Git et Claude Code, puis redémarrez l'app. Tout au vert.
Toujours bloqué ?
Écrivez-nous, on vous accompagne jusqu'à ce que ça marche. Dites-nous à quelle étape vous étiez et ce qui s'est affiché (une capture aide énormément).
todo@mercaderia.co