Wichtigste Erkenntnisse
- Die Plugin-Methode ist der schnellste Weg und führt Auto-Updates durch. Für die Installation genügen zwei Befehle.
- Die manuelle Installation von Skills funktioniert, erhält aber keine Auto-Updates. Gebündelte Schemas weichen im Laufe der Zeit von der Live-Plattform ab.
- Setze
OPT_OUT_INSTRUMENTATION=truevor deiner ersten Validierung, wenn du mit proprietärem Code arbeitest. Validierungs-Payloads enthalten standardmäßig deinen Code.- Store-Operationen werden sofort auf deinem Live-Store ausgeführt. Es gibt keinen Entwurfsschritt.
- Frage immer den aktuellen Status ab, bevor du Mutations ausführst. Das Toolkit hat keine Undo-Funktion.
Claude Code ist eines der wichtigsten KI-Coding-Tools, die vom Shopify AI Toolkit unterstützt werden. Sobald die Verbindung hergestellt ist, erhält deine Claude Code Session Zugriff auf die aktuelle Shopify-Dokumentation, Code-Validierung gegen mitgelieferte API-Schemas und die Möglichkeit, Store-Operationen über die Shopify CLI auszuführen.
Dieser Guide behandelt das Setup und das Wichtigste, was du wissen solltest. Für eine detaillierte Übersicht darüber, was das Toolkit leistet, wie es funktioniert und welche Risiken bei der Store-Ausführung bestehen, lies unsere Shopify AI Toolkit-Übersicht.
Warum du uns vertrauen kannst
Jacques hat über 15 Jahre Entwicklungserfahrung und hat mit Hunderten von Shopify-Stores gearbeitet. Wir haben Fudge entwickelt - einen KI-nativen Shopify Page Builder und Store Editor mit einer 5,0-Bewertung 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 (
node --versionzum Überprüfen) - Shopify CLI installiert (wird für Store-Operationen benötigt)
- Ein Shopify-Store zum Verbinden (nur für Store-Operationen erforderlich - nicht benötigt für Dokumentationssuche und Code-Validierung)
Installation: Plugin-Methode (empfohlen)
Die Plugin-Methode ist der schnellste Weg und aktualisiert sich automatisch, wenn Shopify neue Funktionen veröffentlicht.
Lieber visuell folgen? Schau dir die vollständige Plugin-Installations-Anleitung an:
Schritt 1: Plugin installieren
Führe in deiner Claude Code-Sitzung diese beiden Befehle aus:
/plugin marketplace add Shopify/shopify-ai-toolkit
/plugin install shopify-plugin@shopify-ai-toolkitDadurch werden alle verfügbaren Agent Skills automatisch installiert.
Schritt 2: Installation überprüfen
Stelle Claude eine Shopify-spezifische Frage, um zu bestätigen, dass das Toolkit aktiv ist:
What's the correct GraphQL mutation to update a product's title in the Shopify Admin API?Wenn das Toolkit funktioniert, durchsucht Claude die aktuelle Shopify-Dokumentation und gibt eine validierte Abfrage zurück, anstatt aus seinen Trainingsdaten zu raten.
Alternative: Manuelle Skills-Installation
Wenn du Skills lieber manuell installierst (z. B. weil du nur bestimmte Funktionen benötigst):
Alle Skills installieren
npx skills add Shopify/shopify-ai-toolkitEinen bestimmten Skill installieren
npx skills add Shopify/shopify-ai-toolkit --skill shopify-adminManuell installierte Skills aktualisieren sich nicht automatisch. Du musst den Installationsbefehl regelmäßig erneut ausführen, um mit Shopifys API-Änderungen aktuell zu bleiben. Mit der Zeit weichen die gebündelten Schemas von der Live-Plattform ab.
Alternative: MCP-Server-Einrichtung
Für eine direkte MCP-Integration kannst du dich mit Shopifys Dev MCP-Server verbinden. Dieser läuft als lokale Server/Client-Integration, macht aber Netzwerkaufrufe an Shopify-Endpunkte für die Dokumentationssuche. Die Authentifizierung hängt davon ab, mit welchem MCP-Server du dich verbindest - Dev MCP für Docs erfordert keine Store-Authentifizierung; Store-Operationen schon.
Informationen zum Konfigurationsformat und den Optionen findest du in der Shopify AI Toolkit-Dokumentation.
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 Shopifys Server.
Die SKILL.md-Dateien beschreiben dies als “anonymisierte Validierungsergebnisse (bestanden/nicht bestanden und Skill-Name).” Der tatsächliche Validierungs-Payload enthält jedoch den zu validierenden Code - deine GraphQL-Abfragen, Liquid-Templates und anderen Code, den du durch den Validator laufen lässt.
Zum Deaktivieren setze diese Umgebungsvariable:
export OPT_OUT_INSTRUMENTATION=trueWenn du mit proprietärem Code, Kundencode oder irgendetwas arbeitest, das du nicht an Shopifys Endpunkte übertragen möchtest, setze dies vor deiner ersten Validierung.
Verbindung mit deinem Store
Um Operationen auf einem Live-Store auszuführen (nicht nur Code zu generieren und zu validieren), musst du dich über die Shopify CLI authentifizieren.
Authentifizierung
Das Toolkit übernimmt 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_productsDies fordert dich auf, den Zugriff über den Shopify-Admin zu autorisieren.
Scope-Auswahl
Das Validierungsskript des Toolkits erkennt die minimal erforderlichen OAuth-Scopes für jede Operation. Gängige Scopes:
| Operation | Scope |
|---|---|
| Produkte lesen | read_products |
| Produkte aktualisieren | write_products |
| Inventar lesen | read_inventory |
| Inventar anpassen | write_inventory |
| Bestellungen lesen | read_orders |
| Kunden lesen | read_customers |
Halte dich an die minimal benötigten Scopes. write_products gibt Zugriff auf ALLE Produkt-Schreiboperationen, nicht nur auf die spezifische Mutation, die du ausführst.
Was du tun kannst
Validierte GraphQL-Entwicklung
Bitte Claude, Shopify GraphQL-Abfragen und -Mutationen zu schreiben. Das Toolkit validiert sie gegen das gebündelte API-Schema, bevor du sie verwendest.
Claude durchsucht die aktuelle Shopify Admin API-Dokumentation, generiert die Abfrage, validiert sie gegen das gebündelte Schema und meldet eventuelle Probleme oder erforderliche Scopes. Keine halluzinierten Felder oder veralteten Muster mehr.
Theme-Entwicklung
Arbeite mit Liquid-Templates mit Validierung gegen Shopifys Theme-Regeln. Das Toolkit validiert Schemas gegen JSON-Definitionen und erzwingt LiquidDoc-Header.
Verwandt: Benutzerdefinierte Liquid-Logik in Shopify hinzufügen.
Hydrogen-Storefront-Entwicklung
Baue Headless-Storefronts mit validierten React-Komponenten und korrekten Importen aus @shopify/hydrogen.
Store-Operationen
Führe Operationen direkt auf 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 Entwurfsschritt. Siehe den Risiko-Abschnitt in unserer Hauptanleitung für die Hintergründe.
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 Extensions
Baue Backend-Anpassungen - Rabatte, Warenkorb-Validierung, Lieferregeln - und erstelle UI-Extensions mit Polaris-Komponenten. Der Functions-Skill weiß, dass Shopify Functions rein sein müssen (keine Netzwerkaufrufe, kein Dateisystem, keine Zufallswerte).
Verwandt: Benutzerdefiniertes JavaScript in Shopify hinzufügen.
Best Practices
Immer abfragen vor dem Mutieren
Bevor du etwas aktualisierst, lies zuerst den aktuellen Zustand:
Show me the current title, description, and SEO fields for the product with handle "classic-tee"Das gibt dir eine Ausgangsbasis und hilft, unbeabsichtigte Überschreibungen zu verhindern.
Sei spezifisch bei Mutationen
Vage Prompts führen zu breiten Mutationen. Statt “Optimiere meine Produkte für SEO” sei spezifisch:
Update ONLY the meta description for the product with handle "classic-tee" to "Shop the Classic Tee - premium cotton, 5 colors, free shipping over $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 es aber nicht standardmäßig. Mach es dir zur Gewohnheit.
Ein Objekt nach dem anderen bei kritischen Änderungen
Führe bei wichtigen Updates die Änderungen einzeln pro Produkt durch, anstatt in großen Mengen. Das begrenzt den Schadensradius, falls etwas schiefgeht.
Eigene Backups anlegen
Das Toolkit hat kein Undo. Bevor du Mutationen ausführst, die bestehende Inhalte aktualisieren, exportiere oder notiere die aktuellen Werte.
Einschränkungen
Diese sind strukturell bedingt durch das Toolkit, nicht Claude Code-spezifisch. Für die vollständige Risikoanalyse siehe unsere Shopify AI Toolkit-Übersicht.
- Kein Entwurfsmodus - Store-Mutationen werden sofort auf deinem Live-Store ausgeführt
- Keine Vorschau - Du kannst nicht sehen, wie Änderungen aussehen werden, bevor sie passieren
- Kein Undo/Rollback - Änderungen sind nach der Ausführung dauerhaft
- Kein Audit-Trail - Keine Aufzeichnung auf Toolkit-Ebene darüber, was geändert wurde
- Breite Scopes - OAuth-Berechtigungen gelten für ganze Ressourcentypen, nicht einzelne Einträge
- Code wird an Shopify gesendet - Validierungs-Payloads enthalten standardmäßig deinen Code (Opt-out mit
OPT_OUT_INSTRUMENTATION=true) - 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 aber nicht das richtige Tool für das Merch-Team im Tagesgeschäft, und es liefert nicht den Workflow, den echte Änderungen am Store brauchen: Drafts, Previews, Freigaben, Versionsverlauf, geplante Launches, Rollbacks. Code lebt in Git; der Store-State nicht. Genau diese Lücke schließt Fudge — ein AI-nativer Shopify-Editor mit Drafts, Previews und Rollbacks für die Leute in deinem Team, die kein GraphQL schreiben sollten.
Schnellübersicht
| Aufgabe | Befehl |
|---|---|
| Plugin installieren (Schritt 1) | /plugin marketplace add Shopify/shopify-ai-toolkit |
| Plugin installieren (Schritt 2) | /plugin install shopify-plugin@shopify-ai-toolkit |
| Alle Skills manuell installieren | npx skills add Shopify/shopify-ai-toolkit |
| Einzelnen Skill installieren | npx skills add Shopify/shopify-ai-toolkit --skill shopify-admin |
| Beim Store authentifizieren | shopify store auth --store domain --scopes list |
| Telemetrie deaktivieren (Opt-out) | export OPT_OUT_INSTRUMENTATION=true |
| Node-Version prüfen | node --version (benötigt 18+) |
Zusammenfassung
Das Shopify AI Toolkit macht Claude Code zu einer Shopify-fähigen Entwicklungsumgebung. Die Dokumentationssuche und Code-Validierung machen die Installation für jeden Shopify-Entwickler lohnenswert – allein der Accuracy Loop spart Zeit.
Für Entwicklungsarbeiten – App-Entwicklung, Theme-Erstellung, Hydrogen Storefronts – ist es ein klares Produktivitäts-Upgrade. Für den Shop-Betrieb gelten allerdings die Governance-Lücken: keine Entwürfe, keine Vorschau, kein Undo und die Code-Telemetrie ist standardmäßig aktiviert. Überlege dir genau, was du aktivierst.
Alle Details zu Risiken und Governance findest du in unserer Übersicht zum Shopify AI Toolkit. Für die Einrichtung auf anderen Plattformen empfehlen wir unseren Cursor Guide und OpenAI Codex Guide.
Dieser Artikel wurde zuletzt im April 2026 basierend auf dem Release der Shopify Editions Winter 2026 aktualisiert.
FAQ
Nutze das Plugin, wenn du das einfachste Setup und Auto-Updates möchtest, sobald Shopify neue Funktionen veröffentlicht. Wähle die manuelle Installation, wenn du nur bestimmte Skills benötigst (z. B. nur shopify-admin für Backend-Arbeiten) oder eine explizite Versionskontrolle wünschst. Für die meisten Claude Code Nutzer wird das Plugin als Standard empfohlen.
Update Node, bevor du das Toolkit installierst – die Validierungs-Skripte nutzen moderne Node-Features, die in älteren Versionen nicht verfügbar sind. Nutze nvm (Node Version Manager), um Node 20 LTS zu installieren, ohne dabei andere Projekte zu stören. Das Toolkit lässt sich auf älteren Node-Versionen zwar womöglich installieren, verursacht dann aber verwirrende Runtime-Errors.
Ja, für die Suche in der Dokumentation und die Code-Validierung – dafür ist keine Store-Authentifizierung nötig. Für Store-Operationen (Ausführen von Mutations auf einem Live-Store) musst du dich jedoch authentifizieren. Du kannst das Toolkit auch rein als Entwicklungsreferenz nutzen, ohne je einen Store zu verbinden.
Ja, und das wird sogar ausdrücklich empfohlen, um Mutations sicher zu testen. Verbinde den Development Store zuerst, führe die Operationen dort aus, um zu prüfen, ob alles wie erwartet funktioniert, und logge dich danach für die Produktionsumgebung ein. Development Stores können kostenlos erstellt werden und erlauben dir das Experimentieren, ohne reale Daten zu gefährden.
Die Validierungs-Payloads enthalten den Code, der geprüft wird, damit Shopify serverseitig gegen aktuelle Schemas validieren kann. Dies wird zwar als "anonymisierte Validierungsergebnisse" dokumentiert, aber die Payload enthält weiterhin deine Queries/Codes. Setze OPT_OUT_INSTRUMENTATION=true, um dies für proprietäre oder Kunden-Projekte zu deaktivieren.