← Journal

6. September 2026·6 Min. Lesezeit

Shopify CLI 2026 erklärt: Befehle für Apps & Themes

Die neue Shopify CLI vereint App-, Theme- und Hydrogen-Entwicklung in einem Tool. Installation, die wichtigsten Befehle und dein erster Dev-Server.

Wer heute für Shopify entwickelt, kommt an der Shopify CLI nicht vorbei. Sie ist das zentrale Werkzeug, um Apps, Themes und Hydrogen-Storefronts lokal zu bauen, live zu testen und zu deployen.

In diesem Beitrag erklären wir, was die Shopify CLI ist, wie du sie installierst und welche Befehle du wirklich brauchst. Alle Befehle sind gegen die offizielle Shopify CLI-Doku geprüft.

Was die Shopify CLI ist und was sie vereinheitlicht hat

Die Shopify CLI ist ein Kommandozeilen-Tool, mit dem du Shopify-Apps, -Themes und Custom Storefronts generierst und weiterentwickelst. Sie automatisiert Routineaufgaben und ist heute das offizielle Standard-Werkzeug für die Shopify-Entwicklung.

Der entscheidende Punkt: Früher gab es getrennte Tools für Theme- und App-Entwicklung. Mit dem großen Rewrite ab Version 3.0 wurde daraus _eine_ einheitliche CLI. Inzwischen ist die CLI bei Version 4.x angekommen. Seit 4.0 aktualisiert sie sich sogar selbst über den Paketmanager, mit dem du sie installiert hast.

Für dich heißt das: ein Tool, eine Syntax, ein Login. Egal ob du an einem Theme, einer App oder einer Hydrogen-Storefront arbeitest. Die Befehle folgen immer dem gleichen Muster:

shopify [thema] [befehl]

Also zum Beispiel shopify theme dev oder shopify app deploy. Diese Konsistenz spart im Agentur-Alltag enorm Zeit, weil du dir nicht mehr für jedes Projekt ein anderes CLI-Verhalten merken musst.

Installation und Voraussetzungen

Bevor du loslegst, brauchst du eine passende Umgebung. Laut offizieller Doku sind das die Voraussetzungen:

  • Node.js in Version 22.12 oder höher
  • Ein Paketmanager: npm, Yarn 1.x oder pnpm
  • Git in Version 2.28.0 oder höher

Die Installation läuft am einfachsten über npm. Damit installierst du die CLI global:

npm install -g @shopify/cli@latest

Auf dem Mac kannst du alternativ Homebrew nutzen. Der Vorteil: Homebrew kümmert sich beim Upgrade auch um die passende Node-Version.

brew tap shopify/shopify
brew install shopify-cli

Ob alles funktioniert, prüfst du danach mit:

shopify version

Eine Übersicht aller verfügbaren Befehle bekommst du jederzeit mit shopify help. Das ist praktisch, weil sich die CLI selbst dokumentiert und du Flags nicht auswendig lernen musst.

Theme-Entwicklung mit der CLI

Für Theme-Entwickler ist die CLI der schnellste Weg zu einem sauberen Workflow. Du startest ein neues Theme auf Basis einer Vorlage mit:

shopify theme init

Das Herzstück ist der lokale Dev-Server. Er lädt dein Theme als Entwicklungs-Theme in den Store und stellt eine Vorschau bereit:

shopify theme dev --store deine-store.myshopify.com

Der Server läuft standardmäßig unter http://127.0.0.1:9292. Das Beste daran ist Hot Reload: Änderungen an CSS und Sections werden sofort übernommen, bei anderen Dateien lädt die Seite automatisch neu. Du siehst deine Anpassungen also praktisch in Echtzeit.

Für den Abgleich mit dem Store nutzt du zwei Gegenstücke:

  • shopify theme push lädt deine lokalen Dateien in den Store hoch.
  • shopify theme pull holt die Theme-Dateien aus dem Store auf deinen Rechner.

Weitere nützliche Befehle im Theme-Alltag:

  • shopify theme check prüft deinen Code auf Fehler und Liquid-Best-Practices.
  • shopify theme list zeigt alle Themes im Store mit ID und Status.
  • shopify theme console startet eine Liquid-REPL zum Ausprobieren.

Damit deckst du den kompletten Zyklus ab: lokal bauen, live testen, sauber deployen.

App-Entwicklung mit der CLI

Auch für Apps ist die CLI der offizielle Startpunkt. Ein neues App-Projekt legst du mit einem einzigen Befehl an. Die CLI führt dich durch Template-Auswahl und Setup:

shopify app init

Anschließend startest du die lokale Entwicklung. Dabei baut die CLI deine App, verknüpft sie mit einem Dev-Store und beobachtet Änderungen:

shopify app dev

Der große Vorteil: Du testest deine App direkt in einer echten Shopify-Umgebung, ohne manuell Tunnel oder Webhooks konfigurieren zu müssen. Die CLI übernimmt das für dich.

Apps leben von Extensions, etwa für Checkout, Admin oder Functions. Ein neues Extension-Gerüst erzeugst du mit:

shopify app generate extension

Wenn du fertig bist, deployst du App-Konfiguration und Extensions gebündelt:

shopify app deploy

Ergänzend gibt es shopify app info für Projektdetails und shopify app config link, um die App-Konfiguration mit einer bestehenden App zu verknüpfen. Wie du eine App danach sinnvoll mit externen Diensten koppelst, zeigen wir im Beitrag KI mit Shopify verbinden.

Hydrogen für Custom Storefronts

Wenn du ein Headless-Setup mit React willst, ist Hydrogen dein Framework. Auch dafür ist die CLI zuständig. Eine neue Storefront startest du mit:

shopify hydrogen init

Für den Alltag legt Hydrogen einen kurzen h2-Shortcut an, sodass du Befehle wie h2 dev direkt aus dem Projekt heraus aufrufen kannst. Hydrogen ist die richtige Wahl, wenn du volle Kontrolle über Frontend und Performance brauchst und Standard-Themes nicht ausreichen.

Login und Store-Verknüpfung

Ein häufiges Missverständnis: Es gibt keinen separaten login-Befehl. Die CLI meldet dich automatisch an, sobald du einen Befehl ausführst, der einen Store oder Partner-Account braucht, zum Beispiel shopify theme dev oder shopify app dev. Dann öffnet sich dein Browser für die Anmeldung.

Zum Abmelden oder für einen Account-Wechsel nutzt du:

shopify auth logout

Das hilft auch, wenn Sessions mal hängen oder du zwischen mehreren Kundenprojekten wechselst. Für automatisierte Umgebungen wie CI/CD unterstützt shopify theme dev außerdem eine Anmeldung per --password, etwa mit einem Theme-Access-App-Passwort oder einem Admin-API-Token. So läuft der Workflow auch ohne interaktiven Browser-Login.

Typische Stolperfallen und Tipps

Ein paar Dinge kosten immer wieder Zeit, wenn sie übersehen werden. Wenn du sie kennst, sparst du dir viel Sucherei:

  • Falsche Node-Version. Der häufigste Fehler beim Setup. Die CLI erwartet Node 22.12 oder höher. Nutze am besten einen Versionsmanager wie nvm, um pro Projekt die passende Version zu wählen.
  • Kein Development-Store. Für shopify app dev brauchst du einen Entwicklungs-Store. Die CLI hilft dir, einen auszuwählen oder anzulegen. Teste neue Apps niemals direkt an einem produktiven Shop.
  • Auto-Upgrade im Blick behalten. Seit Version 4.0 aktualisiert sich die CLI selbst. Das ist praktisch, kann aber Verhalten ändern. Prüfe bei Problemen zuerst mit shopify version, welche Version gerade läuft.
  • Vor dem Push pullen. Wenn mehrere Leute am selben Theme arbeiten, hol dir mit shopify theme pull erst den aktuellen Stand, bevor du mit shopify theme push überschreibst.

Diese Basics klingen banal, verhindern im Team-Alltag aber die meisten Reibungsverluste.

So startest du: vom Install zum ersten Dev-Server

Genug Theorie. Hier der praktische Ablauf für dein erstes Theme-Projekt:

  1. Installiere die CLI global mit npm install -g @shopify/cli@latest.
  2. Prüfe die Installation mit shopify version.
  3. Lege ein neues Theme an mit shopify theme init und folge den Fragen.
  4. Wechsle in den Projektordner deines neuen Themes.
  5. Starte den Dev-Server mit shopify theme dev --store deine-store.myshopify.com.
  6. Melde dich im Browser an, wenn die CLI dich dazu auffordert.
  7. Öffne http://127.0.0.1:9292 und bearbeite deine Dateien mit Live-Vorschau.

Für eine App ersetzt du Schritt 3 bis 7 durch shopify app init und danach shopify app dev. Der Rest bleibt gleich: anmelden, Dev-Store wählen, loslegen.

Wichtig: Die CLI entwickelt sich weiter, und Flags können sich ändern. Wenn du unsicher bist, prüfe den jeweiligen Befehl mit --help oder direkt in der offiziellen Doku.

Für wen die Shopify CLI relevant ist

Die kurze Antwort: für alle, die mehr als Klicks im Admin brauchen.

  • Agenturen profitieren vom einheitlichen Workflow über viele Kundenprojekte hinweg.
  • Entwicklerinnen und Entwickler bekommen lokalen Code, Versionskontrolle und echte Dev-Server statt Copy-Paste im Theme-Editor.
  • Händler mit eigenem Dev-Team können Themes und Apps sauber testen, bevor etwas live geht.

Gerade im Shopify-Umfeld ist ein professioneller Entwicklungs-Workflow der Unterschied zwischen schnellem Fortschritt und ständigem Aufräumen. Genau hier setzt die CLI an.

Wenn du eine individuelle Shopify-App oder ein maßgeschneidertes Theme brauchst, unterstützen wir dich gern. Buche ein unverbindliches Gespräch mit Andreas und wir schauen uns dein Projekt gemeinsam an.

Fazit

Die Shopify CLI hat die Entwicklung spürbar vereinfacht. Aus mehreren getrennten Tools ist eine konsistente CLI geworden, die Apps, Themes und Hydrogen unter einem Dach vereint.

Für den Einstieg reichen wenige Befehle: installieren, dev-Server starten, Änderungen live sehen. Der Rest wächst mit deinem Projekt. Am besten öffnest du jetzt dein Terminal und startest deinen ersten shopify theme dev.