MercaderIA Schritt für Schritt installieren
Ohne technische Vorkenntnisse. Wir sagen dir genau, was du in jedem Moment auf dem Bildschirm siehst und was zu tun ist, wenn du es nicht siehst. Wenn etwas seltsam wirkt, ist es fast immer normal: wir erklären es an der richtigen Stelle.
MercaderIA stützt sich auf vier Bausteine. Du musst nicht verstehen, wie sie funktionieren — nur dass sie da sind:
- Node.js: Der Motor, der die Werkzeuge darunter antreibt.
- Git: Ein Hilfsprogramm, das diese Werkzeuge intern nutzen.
- Claude Code: Die künstliche Intelligenz, die in deinem Shop arbeiten wird.
- MercaderIA: Das agentische System, das deinen kompletten Shop automatisiert.
Das Wichtigste auf dieser ganzen Seite
MercaderIA installiert Git und Claude Code für dich, aber Node.js musst du vorher selbst installieren. Wenn du diese Reihenfolge überspringst, meldet die App, dass etwas fehlt. Fang mit Schritt 1 an.
Das kommt vor dem Download von MercaderIA. Geh auf die offizielle Website und lade die Version mit der Kennzeichnung LTS herunter.
Node.js LTS herunterladenLTS bedeutet „stabile Version mit langem Support“. Wenn du zwei Buttons siehst, nimm immer LTS, nie den mit „Current“.
Bei der Installation: weiter, weiter, weiter. Nichts ändern, alle Standardwerte übernehmen.
Schließe alle Terminals und starte den Rechner neu
Wenn du Node zum ersten Mal installierst, starte den Rechner neu. Das System braucht eine Weile, um zu „merken“, dass es ein neues Programm gibt — Neustart ist der sichere Weg. Das verhindert den häufigsten Fehler der ganzen Installation.
Prüfen, ob es geklappt hat:
Öffne Terminal (wie das geht, steht in Schritt 2) und tippe:
node --versionEs sollte so etwas wie v22.14.0 antworten. Dann ist alles gut.
Wenn dort “command not found: node” steht, ist es nicht installiert oder du hast nicht neu gestartet: neu starten und nochmal probieren.
Das Terminal ist ein Fenster, in dem du Befehle als Text schreibst, Enter drückst und das Programm antwortet. Mehr nicht. Du machst nichts kaputt.
macOS
- Drücke Cmd + Leertaste.
- Tippe terminal.
- Drücke Enter.
Windows
- Drücke die Windows-Taste.
- Tippe powershell.
- Öffne Windows PowerShell.
maria@MacBook ~ % node --version v22.14.0 maria@MacBook ~ %
Das schwarze oder blaue Fenster voller Text ist völlig normal: so sieht ein frisch geöffnetes Terminal aus.
Kopieren und Einfügen ist erlaubt (und empfohlen)
Du musst nichts abtippen. Nutze den Kopieren-Button jedes Blocks in dieser Anleitung und füge im Terminal mit Cmd + V ein.
Gut zu wissen: Wenn das Terminal irgendwann ein Passwort verlangt, sieht man beim Tippen nichts — keine Punkte, keine Sternchen. Das ist Schutz, kein Fehler. Bei MercaderIA passiert das nicht, aber gut zu wissen.
Es gibt zwei Wege. Beide funktionieren:
Variante A — manuell im Terminal (empfohlen)
Öffne Terminal und füge diese Zeile ein:
curl -fsSL https://claude.ai/install.sh | bashVariante B — lass es MercaderIA machen
Beim ersten Start von MercaderIA erkennt ein Assistent, was fehlt, und installiert Git und Claude Code selbst. Das ist am einfachsten, dauert aber manchmal, bis es übernommen wird — dann muss man die App schließen und wieder öffnen. Ein Neustart des Rechners oder ein paar Minuten Warten verbinden alles von selbst. Das passiert nur am Anfang: nach der Verbindung nie wieder.
Es läuft ziemlich viel Text durch. Das ist normal. Fertig ist es, wenn die Eingabezeile wieder erscheint ($).
Nach der Installation von Claude Code tippst du claude ins Terminal und bekommst:
zsh: command not found: claude
Keine Sorge: das ist zu erwarten, kein seltsamer Fehler. Das Programm ist installiert, liegt aber in einem Ordner, der nicht auf der Suchliste des Terminals steht. Wie ein Buch, das zu Hause ist, aber nicht im Regal, in das du immer schaust: du musst dem Rechner sagen, wo es liegt.
macOS — füge diese zwei Zeilen nacheinander ein:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrcDie erste fügt den Ordner dauerhaft zur Liste hinzu (zum Beispiel /Users/maria/.local/bin). Die zweite sorgt dafür, dass das Terminal es sofort merkt, ohne Neustart.
Prüfen mit:
claude --versionWenn es trotzdem nicht klappt, ist das nicht schlimm
MercaderIA sucht das Programm in vielen verschiedenen Ordnern und findet es meist, auch wenn das Terminal es nicht sieht. Mach weiter und probiere die App.
Claude Code braucht ein Konto. Beim ersten Mal wird die Anmeldung verlangt: ein Browser-Tab öffnet sich, du meldest dich mit deinem Claude-Konto an, bestätigst und gehst zurück zur App.
MercaderIA öffnet diesen Tab automatisch, wenn Claude Code gerade zum ersten Mal installiert wurde. Wenn Claude schon vorher installiert war, geht die App von einer bestehenden Anmeldung aus und öffnet ihn nicht. Falls doch nicht, einfach das Terminal öffnen und eingeben:
claude…und dann den Anweisungen auf dem Bildschirm folgen.
Das sind zwei verschiedene Dinge, nicht verwechseln
Du brauchst ein Claude-Konto mit aktivem Plan und, davon getrennt, eine MercaderIA-Lizenz. Das eine enthält das andere nicht.
Wenn macOS sagt, der Entwickler kann nicht überprüft werden
Öffne die .dmg und zieh MercaderIA in den Ordner Programme. Wenn beim Öffnen die Warnung erscheint: Rechtsklick auf die App → Öffnen → Öffnen. Sie erscheint, weil die App noch nicht von Apple signiert ist, nicht weil sie gefährlich wäre.
Du siehst eine Liste mit Git, Claude Code und Node.js, jeweils mit Status, und die App installiert selbstständig, was fehlt.
- Node.jsGefunden — v22.14.0
- GitWird installiert…
- Claude CodeNicht gefunden
Wenn etwas nach der Installation weiter als „nicht gefunden“ erscheint
Schließe MercaderIA komplett und öffne sie erneut. Die App übernimmt die Programmliste des Systems beim Start — was währenddessen installiert wird, sieht sie erst beim nächsten Start. Das ist kein Fehler, sondern die Funktionsweise. Auf einem Rechner, auf dem nie etwas davon installiert war, ist es normal, die App ein- bis zweimal neu zu starten, bis alles grün ist.
Wenn die Liste eingefroren wirkt, prüft sie gerade
Die Prüfung jedes Programms wartet bis zu 10 Sekunden. Gib ihr Zeit.
Die App fragt nach der Adresse deines Shops in diesem Format:
mitienda.myshopify.comAchtung: Es geht um diese Adresse, nicht um die schöne Domain deines Shops. Du findest sie im Shopify-Adminbereich → Einstellungen → Domains: dort steht deine .myshopify.com-Domain, markiert als interne Shopify-Domain.
Danach öffnet der Browser eine Shopify-Seite mit der Bitte, Berechtigungen zu erteilen. Die Liste ist lang und das ist normal: der Assistent muss Produkte, Bestellungen, Bestand, Versand und Retouren lesen und bearbeiten können, um für dich zu arbeiten. Prüfen und bestätigen.
Wenn du den Shop schon einmal verbunden hattest
Die App kann erneut nach Berechtigungen fragen, um neue Rechte einer neueren Version zu ergänzen. Das ist zu erwarten, kein Fehler.
Hake jeden Punkt ab. Wenn alle fünf stehen, kannst du anfangen, mit deinem Shop zu sprechen.
Häufige Probleme
claude: command not found / „wird nicht erkannt“
Das Programm ist installiert, aber das Terminal weiß nicht, wo es suchen soll. Wende den Fix aus Schritt 4 (PATH) an und teste claude --version erneut. Unter Windows PowerShell schließen und neu öffnen.
node: command not found nach der Node-Installation
Starte den Rechner neu. Das System braucht einen Neustart, um das neue Programm zu registrieren. Danach node --version testen.
Die App sagt, etwas fehlt, das ich schon installiert habe
Schließe MercaderIA komplett und öffne sie erneut. Die App liest die Umgebung beim Start; was bei offener App installiert wurde, sieht sie erst beim nächsten Start.
Die Shopify-Berechtigungsseite meldet einen Fehler
Schließe den Tab und starte die Verbindung erneut aus der App. Falls es bleibt, schreib uns mit einem Screenshot.
macOS lässt mich die App nicht öffnen
Rechtsklick auf MercaderIA in Programme → Öffnen → Öffnen. Das ist der Hinweis für unsignierte Apps, kein echtes Sicherheitsproblem.
Windows sagt, das Programm sei unsicher
Weitere Informationen → Trotzdem ausführen. SmartScreen zeigt diesen Hinweis bei neuen Installern.
Auf einem neuen Rechner wird nichts erkannt
Das ist der Normalfall. Richtige Reihenfolge: Node.js installieren, Rechner neu starten, MercaderIA öffnen und Git und Claude Code installieren lassen, App neu starten. Alles grün.
Immer noch hängen geblieben?
Schreib uns, wir begleiten dich, bis es läuft. Sag uns, bei welchem Schritt du warst und was auf dem Bildschirm stand (ein Screenshot hilft enorm).
todo@mercaderia.co