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

Das Wichtigste in Kürze

• Die Plugin-Methode ist der schnellste Weg und aktualisiert sich automatisch. Ein einziger Befehl installiert es: claude plugin install shopify-ai-toolkit@claude-plugins-official.
• Die manuelle Installation von Skills funktioniert, aktualisiert sich aber nicht automatisch. Die gebündelten Schemas weichen im Laufe der Zeit von der Live-Plattform ab.
• Setze OPT_OUT_INSTRUMENTATION=true vor deiner ersten Validierung, wenn du mit proprietärem Code arbeitest. Validierungs-Payloads enthalten standardmäßig deinen Code.
• Shop-Operationen werden sofort in deinem Live-Shop ausgeführt. Es gibt keinen Entwurfs-Schritt.
• Frage immer den aktuellen Status ab, bevor du Mutations ausführst. Das Toolkit hat keine Rückgängig-Funktion.

Um Claude Code für Shopify einzurichten, installiere das Shopify AI Toolkit Plugin mit claude plugin install shopify-ai-toolkit@claude-plugins-official. Stelle dann eine Frage zur Shopify API, um zu bestätigen, dass die aktuellen Docs durchsucht werden. Füge den Dev MCP-Server für direkten MCP-Zugriff hinzu und führe shopify store auth nur dann aus, wenn Claude einen Live-Shop ändern soll.

Sobald die Verbindung hergestellt ist, erhält deine Claude Code Session Zugriff auf die aktuelle Shopify-Dokumentation, Code-Validierung anhand gebündelter API-Schemas und die Möglichkeit, Shop-Operationen über die Shopify CLI auszuführen.

Für eine vollständige Aufschlüsselung, was das Toolkit tut, wie es funktioniert und welche Governance-Risiken bei der Ausführung im Shop bestehen, sieh dir unsere Shopify AI Toolkit Übersicht an.

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

“Claude mit Shopify verbinden” bedeutet je nach Anwender unterschiedliche Dinge:

Händler (No-Code): der offizielle Shopify Connector für Claude. Shopify bietet einen Connector für Claude an, den du aus dem Connector-Verzeichnis von Claude installierst. Er leitet dich in deinen Shopify-Adminbereich weiter, um den Zugriff zu genehmigen. Eine Installation über den App Store ist nicht nötig.

• Was er kann: Von Claude im Web oder auf dem Desktop aus Produkte erstellen und aktualisieren, Bestellungen abfragen (Read-Only), Analytics mit Tabellen und Diagrammen abrufen sowie Kollektionen, Inventar, Seiten und prozentuale Rabattcodes verwalten.
• Was er nicht kann: Themes bearbeiten oder veröffentlichen, Shop-Einstellungen ändern oder Rückerstattungen bearbeiten. Es ist ein Admin-Assistent, kein Storefront-Editor.
• Wo Sidekick und Fudge reinpassen: Im Adminbereich ist Shopifys eigener Assistent für diesen Bereich Shopify Sidekick. Für KI-Änderungen an der Storefront selbst, mit Entwürfen und Vorschauen, ist Fudge, der AI Operator für Shopify-Shops, zuständig.

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

Shopping Agents: Storefront-Endpunkte. Jeder Shopify-Shop stellt auch Storefront-Endpunkte für Agenten zur Verfügung, die von KI-Einkaufsassistenten genutzt werden, um Kataloge zu durchsuchen und Warenkörbe zu erstellen. Als Händler musst du hier nichts einrichten – in unserem Artikel über das Universal Commerce Protocol von Shopify 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 bauen Fudge, den AI Operator für Shopify-Shops, mit einer 4.9-Bewertung im Shopify App Store und einem Built for Shopify Badge. Wir nutzen diese Tools täglich.

Voraussetzungen

• Claude Code installiert und funktionsfähig
• Node.js 18 oder höher, die von Shopify dokumentierte Mindestversion (mit node --version prüfen). Node 18 hat sein End-of-Life im April 2025 erreicht, nutze also Node 20 LTS oder neuer
• Shopify CLI installiert (wird für Shop-Operationen benötigt)
• Ein Shopify-Shop, mit dem du dich verbindest (nur für Shop-Operationen erforderlich – nicht für die Dokumentationssuche und Code-Validierung)

Installation: Plugin-Methode (empfohlen)

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

Lernst du lieber visuell? Schau dir das komplette Video-Tutorial 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 dein Setup das Plugin nicht nutzen kann oder du den Skill lieber selbst verwalten möchtest, installiere ihn direkt:

npx skills add Shopify/shopify-ai-toolkit

Damit wird der einzige shopify Skill des Toolkits installiert, der jeden Entwicklerbereich von Shopify abdeckt: die GraphQL Admin API, Shopify Functions, Polaris, Liquid, Hydrogen und die Shopify CLI. Frühere Versionen lieferten für jeden Bereich einen separaten Skill aus, wie z.B. shopify-admin und shopify-liquid. Diese sind veraltet (deprecated) und werden nicht mehr aktualisiert. Wenn du also einen davon installiert hast, entferne ihn (zum Beispiel mit npx skills remove shopify-admin shopify-liquid) und installiere stattdessen den shopify Skill.

Manuell installierte Skills aktualisieren sich nicht automatisch. Führe regelmäßig npx skills update aus, um bei den API-Änderungen von Shopify auf dem neuesten Stand zu bleiben. Andernfalls weichen die gebündelten Schemas von der Live-Plattform ab.

Shopify MCP + Claude Code: Direktes Server-Setup

Für die direkte MCP-Integration ohne das Plugin kannst du den Dev MCP-Server von Shopify mit einem Befehl zu Claude Code hinzufügen:

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

Der Server läuft lokal, führt aber Netzwerkaufrufe an Shopify-Endpunkte für die Dokumentationssuche durch. Die Authentifizierung hängt davon ab, mit welchem MCP-Server du dich verbindest – Dev MCP für Docs erfordert keine Shop-Authentifizierung; Shop-Operationen hingegen schon.

Weitere Informationen zum Konfigurationsformat und den Optionen findest du in den Shopify AI Toolkit Docs.

Telemetrie und Code-Übertragung

Bevor du anfängst, Code zu validieren, 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 (Pass/Fail und Skill-Name)”. Der tatsächliche Validierungs-Payload enthält jedoch den Code, der validiert wird – deine GraphQL Queries, Liquid Templates und anderen Code, den du durch den Validator jagst.

Um dies zu deaktivieren (Opt-out), setze diese Umgebungsvariable:

export OPT_OUT_INSTRUMENTATION=true

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

Mit deinem Shop verbinden

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

Authentifizierung

Das Toolkit erledigt dies automatisch, wenn du eine Shop-Operation anforderst. Der zugrundeliegende Befehl lautet jedoch:

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

Dadurch wirst du aufgefordert, den Zugriff über den Shopify-Adminbereich zu autorisieren.

Auswahl der Scopes

Das Validierungsskript des Toolkits erkennt die minimal erforderlichen OAuth Scopes für jede Operation. Häufige Scopes:

Beschränke dich auf die minimal benötigten Scopes. write_products gewährt Zugriff auf ALLE Schreiboperationen für Produkte, nicht nur auf die spezifische Mutation, die du gerade ausführst.

Was du mit Claude Code + Shopify machen kannst

Validierte GraphQL-Entwicklung

Bitte Claude, Shopify GraphQL Queries und Mutations zu schreiben. Das Toolkit validiert sie anhand des gebündelten API-Schemas, bevor du sie verwendest.

Claude durchsucht die aktuellen Docs der Shopify Admin API, generiert die Query, validiert sie anhand des gebündelten Schemas und meldet alle Probleme oder erforderlichen Scopes. Weniger halluzinierte Felder und veraltete (deprecated) Patterns.

Theme-Entwicklung

Arbeite mit Liquid Templates samt Validierung nach den Theme-Regeln von Shopify. Das Toolkit validiert Schemas anhand von JSON-Definitionen und erzwingt LiquidDoc-Header.

Hydrogen Storefront-Entwicklung

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

Shop-Operationen

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

Die Änderung ist sofort live. Es gibt keinen Entwurfs-Schritt. Lies dir den Abschnitt zu den Risiken in unserem Hauptguide durch, um zu verstehen, warum das wichtig ist.

Metafield-Verwaltung

Erweitere das Datenmodell deines Shops mit Metafield-Definitionen. Das Toolkit nutzt TOML für Metafield-Definitionen und kennt den Unterschied zwischen App-eigenen Daten (app-owned) und Händler-eigenen Daten (merchant-owned).

Functions und Extensions

Baue Backend-Anpassungen – Rabatte, Warenkorb-Validierung, Lieferregeln – und generiere das Grundgerüst (Scaffold) für UI Extensions mit Polaris-Komponenten. Der Functions-Leitfaden des Skills weiß, dass Shopify Functions “pure” sein müssen (keine Netzwerkaufrufe, kein Dateisystem, keine Zufälligkeit).

Für praktische Theme-Beispiele schau dir Wie man benutzerdefinierte Liquid-Logik in Shopify hinzufügt an.

Best Practices

Vor dem Mutieren immer abfragen

Bevor du etwas aktualisierst, lies zuerst den aktuellen Status 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, unbeabsichtigte Überschreibungen zu verhindern.

Sei bei Mutations präzise

Vage Prompts führen zu weitreichenden Mutations. Anstatt “Optimiere meine Produkte für SEO”, werde konkret:

Aktualisiere NUR die Meta-Description für das Produkt mit dem Handle "classic-tee" auf "Shop the Classic Tee - Premium-Baumwolle, 5 Farben, kostenloser Versand ab 50€"

Themes als “unpublished” pushen

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

Bei kritischen Änderungen nur eine Ressource nach der anderen

Bei wichtigen Updates solltest du diese lieber für jedes Produkt einzeln ausführen, anstatt als Bulk-Vorgang. Das begrenzt den Schaden (“Blast Radius”), falls etwas schiefgeht.

Mache deine eigenen Backups

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

Einschränkungen

Diese sind strukturell durch das Toolkit bedingt, nicht Claude Code-spezifisch. Für die vollständige Risikoanalyse siehe unsere Shopify AI Toolkit Übersicht.

1. Kein Entwurfsmodus - Shop-Mutations werden sofort in deinem Live-Shop ausgeführt
2. Keine Vorschau - Du kannst nicht sehen, wie die Änderungen aussehen werden, bevor sie passieren
3. Kein Undo/Rollback - Änderungen sind dauerhaft, sobald sie ausgeführt wurden
4. Kein Audit-Trail - Es gibt keine Aufzeichnung auf Toolkit-Ebene darüber, was geändert wurde
5. Weit gefasste Scopes - OAuth-Berechtigungen gelten für komplette Ressourcentypen, nicht für einzelne Elemente
6. Code wird an Shopify gesendet - Validierungs-Payloads enthalten standardmäßig deinen Code (Opt-out mit OPT_OUT_INSTRUMENTATION=true)
7. Manuelle Skills veralten - Wenn du Skills manuell installiert hast, aktualisieren sie sich nicht automatisch

Wo Fudge ins Spiel kommt

Das AI Toolkit macht dich schneller beim Schreiben von Shopify-Code: Schemas, Themes, Hydrogen, Custom Apps. Es ist nicht die richtige Oberfläche für das Merch-Team im Tagesgeschäft, und es bietet nicht den Workflow, den echte Shop-Änderungen brauchen: Entwürfe, Vorschauen, Freigaben, Versionsverlauf, Rollbacks. Code lebt in Git; der Status des Shops nicht.

Das ist die Lücke, die Fudge füllt. Gib ihm ein Ziel, wie mehr Suchtraffic oder einen höheren Bestellwert, und Fudge findet heraus, was sich lohnt. Es bereitet jede Änderung als Entwurf in deinem Theme vor, inklusive Vorschau und Begründung, und vergleicht die Zahlen davor und danach, sobald sie live ist. Einmalige Anfragen laufen auf die gleiche Weise über den zugehörigen Store-Editor.

Deine Entwickler können Claude Code weiterhin für individuelle Anpassungen nutzen; der Rest des Teams muss nie wieder GraphQL schreiben.

Schnellübersicht

Für das vollständige Bild zu Risiken und Governance, lies unsere Shopify AI Toolkit Übersicht. Für das Setup auf anderen Plattformen, siehe unseren Cursor Guide und OpenAI Codex Guide.

Wir haben die Befehle und Funktionen auf dieser Seite zuletzt im September 2026 mit den aktuellen Shopify-Docs abgeglichen.

FAQ