Anleitung: Claude Code für Shopify einrichten (2026)

Die wichtigsten Punkte

• Die Plugin-Methode ist der schnellste Weg und sorgt für automatische Updates. Die Installation erfordert nur zwei Befehle.
• Die manuelle Installation von Skills funktioniert, wird aber nicht automatisch aktualisiert. Die mitgelieferten Schemas weichen mit der Zeit von der Live-Plattform ab.
• Setze OPT_OUT_INSTRUMENTATION=true vor deiner ersten Validierung, wenn du mit proprietärem Code arbeitest. Standardmäßig enthalten die Validierungs-Payloads deinen Code.
• Store-Operationen werden sofort in deinem Live-Store ausgeführt. Es gibt keinen Entwurfs-Schritt.
• Frage immer den aktuellen Status ab, bevor du Mutationen ausführst. Das Toolkit hat keine Rückgängig-Funktion.

Claude Code ist eines der wichtigsten KI-Coding-Tools, das vom Shopify AI Toolkit unterstützt wird. Einmal verbunden, erhält deine Claude Code-Sitzung Zugriff auf die aktuelle Shopify-Dokumentation, Code-Validierung gegen gebündelte API-Schemas und die Möglichkeit, Store-Operationen über die Shopify CLI auszuführen.

Dieser Leitfaden behandelt die Einrichtung und alles, was du wissen musst. Eine vollständige Aufschlüsselung, was das Toolkit leistet, wie es funktioniert und welche Governance-Risiken mit der Ausführung von Store-Operationen verbunden sind, findest du in unserer Übersicht zum Shopify AI Toolkit.

Claude mit Shopify verbinden: Welcher Weg ist der richtige für dich?

“Claude mit Shopify verbinden” bedeutet je nachdem, wer die Verbindung herstellt, unterschiedliche Dinge:

Händler (ohne Code): der offizielle Shopify Connector für Claude. Shopify bietet einen Connector für Claude, den du aus dem Connector-Verzeichnis von Claude installierst – er leitet dich zu deinem Shopify-Admin weiter, um den Zugriff zu genehmigen, ohne dass eine Installation aus dem App Store erforderlich ist. Einmal verbunden, kann Claude im Web oder auf dem Desktop Produkte erstellen und aktualisieren, Bestellungen nachschlagen (nur Lesezugriff), Analysen mit Tabellen und Diagrammen abrufen und Kollektionen, Inventar, Seiten sowie prozentuale Rabattcodes verwalten. Er kann keine Themes bearbeiten oder veröffentlichen, keine Shop-Einstellungen ändern oder Rückerstattungen bearbeiten – er ist also ein Admin-Assistent, kein Storefront-Editor. (Innerhalb des Admins ist Shopifys eigener Assistent für diesen Bereich Shopify Sidekick.) Für KI-gestützte Änderungen am Storefront selbst, mit Entwürfen und Vorschauen, ist Fudge zuständig.

Entwickler: Claude Code + das Shopify AI Toolkit. Der Rest dieses Leitfadens. Dieser Weg gibt Claude validierten Zugriff auf Shopifys APIs, Dokumentationen und die CLI – die richtige Wahl, wenn du Theme-Code, Apps oder Automatisierungen schreibst.

Shopping-Agenten: Storefront-Endpunkte. Jeder Shopify-Store stellt auch Endpunkte für Agenten bereit, die KI-Shopping-Assistenten zum Durchsuchen von Katalogen und zum Zusammenstellen von Warenkörben verwenden. Als Händler musst du hier nichts einrichten – in unserem Artikel über Shopifys Universal Commerce Protocol erfährst du, was das für deinen Shop bedeutet.

Warum du uns vertrauen kannst

Jacques hat über 15 Jahre Entwicklungserfahrung und hat mit Hunderten von Shopify-Shops gearbeitet. Wir haben Fudge entwickelt – einen KI-nativen Shopify Page-Builder und Store-Editor mit einer Bewertung von 4.9 und einem „Built for Shopify“-Badge. Wir nutzen diese Tools täglich.

Voraussetzungen

• Claude Code ist installiert und funktioniert
• Node.js 18 oder höher (node --version zur Überprüfung)
• Shopify CLI ist installiert (wird für Store-Operationen benötigt)
• Ein Shopify-Store zum Verbinden (nur für Store-Operationen erforderlich – nicht für die Dokumentationssuche und Code-Validierung nötig)

Installation: Plugin-Methode (empfohlen)

Die Plugin-Methode ist der schnellste Weg und aktualisiert sich automatisch, sobald Shopify neue Funktionen veröffentlicht.

Möchtest du lieber visuell folgen? Schau dir die vollständige Video-Anleitung zur Plugin-Installation an:

Schritt 1: Das Plugin installieren

Führe diesen Befehl in deinem Terminal aus (aktuell von Shopify dokumentierter Befehl, verifiziert im September 2026):

claude plugin install shopify-ai-toolkit@claude-plugins-official

Dies installiert automatisch alle verfügbaren Agent-Skills. Unser Video zeigt den früheren zweistufigen Prozess /plugin marketplace add Shopify/shopify-ai-toolkit von April 2026; der obige Einzeiler ist der Weg, den die Shopify-Dokumentation jetzt beschreibt.

Schritt 2: Installation überprüfen

Frage Claude etwas Shopify-Spezifisches, um zu bestätigen, dass das Toolkit aktiv ist:

Was ist die korrekte GraphQL-Mutation, um den Titel eines Produkts in der Shopify Admin API zu aktualisieren?

Wenn das Toolkit funktioniert, wird Claude die aktuelle Shopify-Dokumentation durchsuchen und eine validierte Abfrage zurückgeben, anstatt aus seinen Trainingsdaten zu raten.

Alternative: Manuelle Installation der Skills

Wenn du die Skills lieber manuell installierst (z.B. weil du nur bestimmte Funktionen benötigst):

Alle Skills installieren

npx skills add Shopify/shopify-ai-toolkit

Einen bestimmten Skill installieren

npx skills add Shopify/shopify-ai-toolkit --skill shopify-admin

Manuell installierte Skills werden nicht automatisch aktualisiert. Du musst den Installationsbefehl regelmäßig erneut ausführen, um mit den API-Änderungen von Shopify auf dem Laufenden zu bleiben. Mit der Zeit werden die mitgelieferten Schemas von der Live-Plattform abweichen.

Shopify MCP + Claude Code: Direkte Server-Einrichtung

Für eine direkte MCP-Integration ohne das Plugin füge den Dev MCP-Server von Shopify mit einem Befehl zu Claude Code hinzu:

claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest

Der Server läuft lokal, führt aber Netzwerkaufrufe zu Shopify-Endpunkten für die Dokumentationssuche durch. Die Authentifizierung hängt davon ab, mit welchem MCP-Server du dich verbindest – der Dev MCP für die Dokumentation erfordert keine Store-Authentifizierung, Store-Operationen hingegen schon.

Informationen zum Konfigurationsformat und zu den Optionen findest du in der Dokumentation zum Shopify AI Toolkit.

Telemetrie und Code-Übertragung

Bevor du mit der Validierung von Code beginnst, solltest du Folgendes wissen: Sowohl validate.mjs als auch search_docs.mjs senden standardmäßig Nutzungs-Payloads an die Server von Shopify.

Die SKILL.md-Dateien beschreiben dies als „anonymisierte Validierungsergebnisse (erfolgreich/fehlgeschlagen und Skill-Name)“. Die tatsächliche Validierungs-Payload enthält jedoch den zu validierenden Code – deine GraphQL-Abfragen, Liquid-Vorlagen und anderen Code, den du durch den Validator laufen lässt.

Um dies zu deaktivieren, setze diese Umgebungsvariable:

export OPT_OUT_INSTRUMENTATION=true

Wenn du mit proprietärem Code, Kundencode oder irgendetwas arbeitest, das nicht an die Endpunkte von Shopify übertragen werden soll, setze dies vor deiner ersten Validierung.

Mit deinem Store verbinden

Um Operationen in einem Live-Store auszuführen (und nicht nur Code zu generieren und zu validieren), musst du dich über die Shopify CLI authentifizieren.

Authentifizierung

Das Toolkit erledigt dies automatisch, wenn du eine Store-Operation anforderst, aber der zugrunde liegende Befehl lautet:

shopify store auth --store yourstore.myshopify.com --scopes write_products,read_products

Daraufhin wirst du aufgefordert, den Zugriff über den Shopify-Admin zu autorisieren.

Auswahl der Scopes

Das Validierungsskript des Toolkits erkennt die minimal erforderlichen OAuth-Scopes für jede Operation. Gängige Scopes:

Halte dich an die minimal notwendigen Scopes. write_products gewährt Zugriff auf ALLE Schreiboperationen für Produkte, nicht nur auf die spezifische Mutation, die du ausführst.

Was du mit Claude Code + Shopify tun kannst

Validierte GraphQL-Entwicklung

Bitte Claude, Shopify GraphQL-Abfragen und -Mutationen zu schreiben. Das Toolkit validiert sie gegen das mitgelieferte API-Schema, bevor du sie verwendest.

Claude durchsucht die aktuellen Dokumente der Shopify Admin API, generiert die Abfrage, validiert sie gegen das mitgelieferte Schema und meldet alle Probleme oder erforderlichen Scopes. Keine halluzinierten Felder oder veralteten Muster mehr.

Theme-Entwicklung

Arbeite mit Liquid-Vorlagen mit Validierung gegen die Theme-Regeln von Shopify. Das Toolkit validiert Schemas gegen JSON-Definitionen und erzwingt LiquidDoc-Header.

Verwandt: Hinzufügen von benutzerdefinierter Liquid-Logik in Shopify.

Hydrogen-Storefront-Entwicklung

Erstelle Headless-Storefronts mit validierten React-Komponenten und korrekten Importen aus @shopify/hydrogen.

Store-Operationen

Führe Operationen direkt in deinem verbundenen Store aus. Claude generiert die Mutation, validiert sie, authentifiziert sich bei deinem Store und führt sie über shopify store execute --allow-mutations aus.

Die Änderung ist sofort live. Es gibt keinen Entwurfs-Schritt. Im Abschnitt über Risiken in unserem Hauptleitfaden erfährst du, warum das wichtig ist.

Metafield-Verwaltung

Erweitere das Datenmodell deines Stores mit Metafield-Definitionen. Das Toolkit verwendet TOML für Metafield-Definitionen und kennt den Unterschied zwischen App-eigenen und Händler-eigenen Daten.

Verwandt: Metafields zu Shopify-Produkten hinzufügen.

Functions und Erweiterungen

Erstelle Backend-Anpassungen – Rabatte, Warenkorb-Validierung, Lieferregeln – und das Grundgerüst für UI-Erweiterungen mit Polaris-Komponenten. Der Functions-Skill weiß, dass Shopify Functions rein sein müssen (keine Netzwerkaufrufe, kein Dateisystem, keine Zufälligkeit).

Verwandt: Hinzufügen von benutzerdefiniertem JavaScript in Shopify.

Best Practices

Immer vor dem Mutieren abfragen

Bevor du etwas aktualisierst, lies zuerst den aktuellen Zustand aus:

Zeige mir den aktuellen Titel, die Beschreibung und die SEO-Felder für das Produkt mit dem Handle "classic-tee"

Das gibt dir eine Ausgangsbasis und hilft, unbeabsichtigtes Überschreiben zu verhindern.

Sei bei Mutationen spezifisch

Vage Anweisungen führen zu weitreichenden Mutationen. Anstatt „Optimiere meine Produkte für SEO“ zu sagen, sei spezifisch:

Aktualisiere NUR die Meta-Beschreibung für das Produkt mit dem Handle „classic-tee“ auf „Kaufe das Classic Tee – hochwertige Baumwolle, 5 Farben, kostenloser Versand ab 50 $“

Themes als unveröffentlicht pushen

Wenn du Theme-Änderungen pushst, pushe sie immer zuerst als unveröffentlicht. Das Toolkit unterstützt shopify theme push --unpublished, erzwingt dies aber nicht standardmäßig. Mache es dir zur Gewohnheit.

Bei kritischen Änderungen nur eine Ressource auf einmal

Führe wichtige Updates für ein Produkt nach dem anderen aus, anstatt in großen Mengen. Dies begrenzt den Schadensradius, falls etwas schiefgeht.

Erstelle deine eigenen Backups

Das Toolkit hat keine Rückgängig-Funktion. Bevor du Mutationen ausführst, die bestehende Inhalte aktualisieren, exportiere oder notiere die aktuellen Werte.

Einschränkungen

Diese sind strukturell im Toolkit verankert und nicht spezifisch für Claude Code. Für die vollständige Risikoanalyse siehe unsere Übersicht zum Shopify AI Toolkit.

1. Kein Entwurfsmodus – Store-Mutationen werden sofort in deinem Live-Store ausgeführt
2. Keine Vorschau – Du kannst nicht sehen, wie Änderungen aussehen werden, bevor sie passieren
3. Kein Rückgängig/Rollback – Änderungen sind nach der Ausführung dauerhaft
4. Kein Audit-Trail – Keine Aufzeichnung auf Toolkit-Ebene, was geändert wurde
5. Weitreichende Scopes – OAuth-Berechtigungen gelten für ganze Ressourcentypen, nicht für einzelne Elemente
6. Code wird an Shopify gesendet – Validierungs-Payloads enthalten standardmäßig deinen Code (deaktivieren mit OPT_OUT_INSTRUMENTATION=true)
7. Manuelle Skills veralten – Wenn du Skills manuell installiert hast, werden sie nicht automatisch aktualisiert

Wo Fudge ins Spiel kommt

Das AI Toolkit macht dich schneller beim Schreiben von Shopify-Code – Schemas, Themes, Hydrogen, benutzerdefinierte Apps. Es ist nicht die richtige Oberfläche für das Merchandising-Team, das die täglichen Abläufe verwaltet, und es fügt nicht den Workflow hinzu, den echte Änderungen am Store benötigen: Entwürfe, Vorschauen, Genehmigungen, Versionsverlauf, geplante Veröffentlichungen, Rollbacks. Code lebt in Git; der Zustand des Stores nicht. Das ist die Lücke, die Fudge füllt – ein KI-nativer Shopify-Editor mit Entwürfen, Vorschauen und Rollback für die Leute in deinem Team, die kein GraphQL schreiben sollten.

Kurzübersicht

Zusammenfassung

Das Shopify AI Toolkit verwandelt Claude Code in eine Shopify-spezifische Entwicklungsumgebung. Die Dokumentationssuche und Code-Validierung machen die Installation für jeden Shopify-Entwickler lohnenswert – allein die Genauigkeitsprüfung spart Zeit.

Für Entwicklungsarbeiten – App-Erstellung, Theme-Entwicklung, Hydrogen-Storefronts – ist es ein klares Produktivitäts-Upgrade. Bei Store-Operationen gelten die Governance-Lücken: keine Entwürfe, keine Vorschau, keine Rückgängig-Funktion und standardmäßig aktivierte Code-Telemetrie. Sei bewusst bei dem, was du aktivierst.

Für ein vollständiges Bild der Risiken und Governance, lies unsere Übersicht zum Shopify AI Toolkit. Für die Einrichtung auf anderen Plattformen, siehe unseren Cursor-Leitfaden und OpenAI Codex-Leitfaden.

Wir haben die Befehle und Funktionen auf dieser Seite zuletzt im September 2026 mit der aktuellen Dokumentation von Shopify abgeglichen.

FAQ