Wichtigste Erkenntnisse
- Codex unterstützt die Plugin-Methode (
codex plugin add shopify@openai-curated), manuelle Skills und MCP.- Die manuelle Installation von Skills funktioniert, aber die Schemas weichen ohne manuelle Updates von der Live-Plattform ab.
- Die MCP-Konfiguration für Codex verwendet das TOML-Format, im Gegensatz zu JSON bei Cursor und der Gemini CLI.
- Setze
OPT_OUT_INSTRUMENTATION=truevor deiner ersten Validierung, wenn du mit proprietärem Code arbeitest.- Store-Operationen werden sofort in deinem Live-Store ausgeführt. Es gibt keinen Entwurfsschritt (Draft) und kein Rückgängigmachen (Undo).
Um das Shopify AI Toolkit in OpenAI Codex einzurichten, führe codex plugin add shopify@openai-curated in deinem Terminal aus, oder nutze /plugins in der Codex CLI, suche nach Shopify und wähle ‘Add to Codex’. Stelle dann eine Frage zur Shopify API, um zu bestätigen, dass Codex in den aktuellen Docs sucht.
Sobald es installiert ist, erhält Codex Zugriff auf die Shopify-Dokumentationssuche, Code-Validierung gegen gebündelte API-Schemas und das gleiche Skill-Set, das auch Claude Code und Cursor zur Verfügung steht.
Für eine detaillierte Übersicht darüber, was das Toolkit macht, wie es funktioniert und welche Governance-Risiken bei der Store-Ausführung bestehen, sieh dir unsere Shopify AI Toolkit-Übersicht an.
Warum du uns vertrauen kannst
Jacques hat über 15 Jahre Entwicklungserfahrung und mit hunderten von Shopify-Stores gearbeitet. Wir bauen Fudge, den KI-Operator für Shopify-Stores, mit einer Bewertung von 4.9 im Shopify App Store und einem Built for Shopify Badge. Wir nutzen diese Tools täglich.
Voraussetzungen
- OpenAI Codex CLI installiert und funktionstüchtig
- Node.js 18 oder höher, das von Shopify dokumentierte Minimum (
node --versionzur Überprüfung). Node 18 erreichte im April 2025 sein End-of-Life, nutze also Node 20 LTS oder neuer - Shopify CLI installiert (erforderlich für Store-Operationen)
- Ein Shopify-Store zur Verbindung (nur für Store-Operationen erforderlich)
Installation: Plugin-Methode
Führe in deinem Terminal den von Shopify dokumentierten Befehl aus:
codex plugin add shopify@openai-curatedOder führe in der Codex CLI /plugins aus, suche nach Shopify und wähle dann Add to Codex.
Dadurch wird das Shopify-Plugin mit allen verfügbaren Agenten-Skills installiert.
Installation ueberpruefen
Stelle OpenAI Codex eine Shopify-spezifische Frage:
What's the correct GraphQL mutation to update a product's title in the Shopify Admin API?Wenn das Toolkit aktiv ist, durchsucht OpenAI Codex die aktuelle Shopify-Dokumentation und validiert seine Ausgabe, anstatt aus Trainingsdaten zu raten.
Alternative: Manuelle Skills-Installation
Wenn dein Setup das Plugin nicht verwenden kann oder du den Skill lieber selbst verwalten möchtest, installiere ihn direkt:
npx skills add Shopify/shopify-ai-toolkitDies installiert den einzigen shopify-Skill des Toolkits, der alle Entwickler-Oberflächen von Shopify abdeckt: die GraphQL Admin API, Shopify Functions, Polaris, Liquid, Hydrogen und die Shopify CLI. Frühere Versionen brachten für jeden Bereich einen separaten Skill mit, z. B. shopify-admin und shopify-liquid. Diese sind veraltet (deprecated) und werden nicht mehr aktualisiert. Falls du welche davon installiert hast, entferne sie (zum Beispiel 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 Änderungen der Shopify-API auf dem neuesten Stand zu bleiben. Andernfalls weichen die gebündelten Schemas von der Live-Plattform ab.
Alternative: MCP-Server Setup
Für die direkte MCP-Integration verwendet Codex die TOML-Konfiguration (im Gegensatz zu Cursor und der Gemini CLI, die JSON verwenden). Der Dev MCP-Server läuft als lokale Server/Client-Integration, macht aber für die Dokumentationssuche Netzwerkaufrufe an Shopify-Endpunkte.
Füge dies deiner ~/.codex/config.toml-Datei hinzu, wie in den Shopify AI Toolkit-Docs beschrieben:
[mcp_servers.shopify-dev-mcp]
command = "npx"
args = ["-y", "@shopify/dev-mcp@latest"]Beachte den Snake_Case-Schlüssel mcp_servers, während JSON-Clients mcpServers verwenden. Starte Codex neu, um die neue Konfiguration zu laden.
Telemetrie und Code-Übertragung
Bevor du anfängst, Code zu validieren: 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 zu validierenden Code – deine GraphQL-Queries, Liquid-Templates und anderen Code, den du durch den Validator jagst.
Um dich abzumelden (Opt-out):
export OPT_OUT_INSTRUMENTATION=trueSetze dies vor dem Start von Codex, wenn du mit proprietärem oder Kunden-Code arbeitest.
Mit deinem Store verbinden
Für Store-Operationen (nicht nur Code-Generierung und -Validierung) authentifizierst du dich über die Shopify CLI:
shopify store auth --store yourstore.myshopify.com --scopes write_products,read_productsDas Toolkit erkennt während der Validierung die erforderlichen Mindest-Scopes. Häufige 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 |
Nutze die minimal benötigten Scopes. write_products gewährt Zugriff auf alle Produkt-Schreiboperationen, nicht nur auf die spezifische Mutation, die du gerade ausführst.
Was du tun kannst
Die Funktionen sind bei allen unterstützten KI-Clients gleich. Das Toolkit ermöglicht:
Validiertes GraphQL - Queries und Mutations werden gegen das gebündelte Shopify API-Schema validiert, bevor du sie nutzt. Weniger halluzinierte Felder und veraltete Pattern.
Theme-Entwicklung - Liquid-Templates werden gegen die Theme-Regeln von Shopify validiert, einschließlich Schema-Blöcken und LiquidDoc-Headern.
Hydrogen Storefronts - React-Komponentengenerierung mit validierten Imports und Pattern.
Functions und Extensions - Backend-Anpassungen (Rabatte, Warenkorb-Validierung, Lieferregeln) und Scaffolding für UI-Extensions mit Polaris-Komponenten.
Store-Operationen - Führe Admin-GraphQL in einem Live-Store via shopify store execute --allow-mutations aus. Änderungen sind sofort wirksam - es gibt keinen Entwurfsschritt. Siehe unseren Haupt-Guide für eine vollständige Risikoaufschlüsselung.
Metafield-Management - Erweitere das Datenmodell deines Stores mit Metafield-Definitionen und Custom Data.
Für praxisnahe Theme-Beispiele siehe Wie man Custom Liquid Logic in Shopify hinzufügt.
Best Practices
Diese gelten für alle Toolkit-Clients, sind es aber wert, wiederholt zu werden.
-
Query vor der Mutation. Lies immer den aktuellen Status einer Ressource aus, bevor du sie aktualisierst. Das verhindert unbeabsichtigtes Überschreiben.
-
Sei spezifisch bei Mutations. “Optimiere meine Produkte für SEO” ist zu vage. “Aktualisiere die Meta Description für das Produkt-Handle ‘classic-tee’ zu ’…’” ist spezifisch genug, um sicher zu sein.
-
Themes als unpublished pushen. Das Toolkit unterstützt
shopify theme push --unpublished, erzwingt es aber nicht. Mach es dir zur Gewohnheit. -
Eine Ressource nach der anderen bei kritischen Änderungen. Das begrenzt den Blast Radius, falls etwas schiefgeht.
-
Mache eigene Backups. Das Toolkit hat keine Undo-Funktion. Exportiere aktuelle Werte, bevor du Mutations ausführst, die bestehende Inhalte aktualisieren.
Einschränkungen
Diese sind strukturell für das Toolkit und nicht Codex-spezifisch. Für die vollständige Risikoanalyse siehe unsere Shopify AI Toolkit-Übersicht.
- Kein Draft-Modus - Store-Mutations werden sofort in 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
- Weitreichende Scopes - OAuth-Berechtigungen gelten für gesamte Ressourcentypen, nicht für einzelne Elemente
- Code wird an Shopify gesendet - Validierungs-Payloads enthalten standardmäßig deinen Code (Opt-out mit
OPT_OUT_INSTRUMENTATION=true) - Manuelle Skills veralten - Nicht-Plugin-Installationen erfordern regelmäßige manuelle Updates
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 operativen Tagesgeschäft, und es bringt nicht den Workflow mit, den echte Store-Änderungen brauchen: Entwürfe, Vorschauen, Freigaben, Versionsverlauf, Rollbacks. Code lebt in Git; der Store-Status nicht.
Das ist die Lücke, die Fudge, der KI-Operator für Shopify-Stores, schließt. Anstatt dass jeder Codex mit dem Store verdrahtet und selbst entscheidet, was geändert werden soll, bekommt dein Team einen vorgefertigten Weg, um ihn kontinuierlich zu verbessern: Fudge sucht sich die Arbeit aus, die sich für ein von dir gewähltes Ziel lohnt, baut sie als Entwürfe in deinem Theme auf, und dein Team kann jede Änderung in der Vorschau ansehen, freigeben oder zurückrollen.
Theme-Anfragen laufen über seinen Store Editor, und Codex bleibt nützlich für den Custom Code, den deine Entwickler schreiben.
Kurzreferenz
| Aufgabe | Wie |
|---|---|
| Plugin installieren | codex plugin add shopify@openai-curated |
| Alle Skills manuell installieren | npx skills add Shopify/shopify-ai-toolkit |
| Manuelle Skills updaten | npx skills update |
| MCP-Konfiguration | TOML in ~/.codex/config.toml (Cursor/Gemini nutzen JSON) |
| Mit Store authentifizieren | shopify store auth --store domain --scopes list |
| Opt-out für Telemetrie | export OPT_OUT_INSTRUMENTATION=true |
| Node-Version prüfen | node --version (18+ erforderlich, 20 LTS empfohlen) |
Für das vollständige Bild zu den Risiken lies unsere Shopify AI Toolkit-Übersicht. Für andere Plattformen siehe unseren Claude Code-Guide und Cursor-Guide.
Wir haben die Befehle auf dieser Seite zuletzt im Oktober 2026 anhand der Shopify-Dokumentation überprüft.
FAQ
Warum ist die MCP-Konfiguration von Codex TOML statt JSON wie bei anderen Clients?
Die Codex CLI von OpenAI verwendet TOML für ihr allgemeines Konfigurationsformat, daher folgt die Konfiguration des MCP-Servers dieser Konvention. Cursor, die Gemini CLI und die meisten anderen MCP-Clients verwenden JSON. Die Funktionalität ist identisch; nur die Konfigurations-Syntax unterscheidet sich. Die Dokumentation von Shopify enthält ein Codex-spezifisches TOML-Snippet, das oben im MCP-Bereich gezeigt wird.
Kann OpenAI Codex Live-Mutations im Shopify-Store ausführen?
Ja, mit der Shopify CLI-Integration (shopify store execute --allow-mutations). Codex generiert die Mutation, validiert sie gegen das Schema und triggert dann die CLI, um sie gegen deinen authentifizierten Store auszuführen. Es gelten die gleichen Vorbehalte wie bei anderen Clients: kein Entwurfsmodus, keine Vorschau, kein Undo.
Aktualisiert Codex das Shopify AI Toolkit automatisch?
Der Plugin-Installationspfad aktualisiert sich automatisch mit den Shopify-Releases. Manuelle Installationen per npx skills add tun das nicht, führe also regelmäßig npx skills update aus, um die Schemas aktuell zu halten. Codex hat keinen eigenen Update-Mechanismus für das Toolkit; es verlässt sich auf die zugrunde liegende Installationsmethode.
Funktioniert das Shopify AI Toolkit mit mehreren Shopify-Stores in Codex?
Ja — authentifiziere dich über shopify store auth --store <domain> für jeden Store neu. Die CLI trackt den aktiven Store und Codex verwendet den, der gerade authentifiziert ist. Das Wechseln zwischen Stores ist ein Befehl. Nützlich, wenn du über Dev-/Staging-/Produktions-Umgebungen hinweg arbeitest.
Wie schlägt sich Codex im Vergleich zu Claude Code für die Shopify-Entwicklung?
Beide unterstützen das gleiche Toolkit und die gleichen Skills. Die Unterschiede liegen in der Agenten-Fähigkeit (Modellqualität, agentische Loops, Codebase-Awareness), wähle also den Client, den du für die allgemeine Entwicklung bevorzugst. Beide installieren das Toolkit als Plugin; der wesentliche praktische Unterschied ist, dass Codex MCP in TOML konfiguriert. Die Shopify-Fähigkeiten sind äquivalent.
