À retenir
- Codex prend en charge l’installation des skills et de MCP, mais pas la méthode par plugin disponible dans Claude Code et Cursor.
- L’installation manuelle des skills fonctionne, mais les schémas se désynchronisent de la plateforme en production sans mises à jour manuelles.
- La configuration MCP pour Codex utilise le format TOML, contrairement au JSON pour Cursor et la CLI Gemini.
- Définissez
OPT_OUT_INSTRUMENTATION=trueavant votre première validation si vous travaillez avec du code propriétaire.- Les opérations sur la boutique s’exécutent immédiatement en production. Il n’y a pas d’étape de brouillon ni d’annulation possible.
La CLI Codex d’OpenAI est l’un des outils de développement IA pris en charge par le Shopify AI Toolkit, avec son propre manifeste de plugin dans le repo. Une fois installé, Codex a accès à la recherche dans la documentation Shopify, à la validation du code par rapport aux schémas d’API intégrés, et aux mêmes skills que Claude Code et Cursor.
Ce guide couvre la configuration et ce qu’il faut savoir. Pour une analyse complète de ce que fait le toolkit, de son fonctionnement et des risques de gouvernance liés aux exécutions sur la boutique, consultez notre présentation du Shopify AI Toolkit.
Pourquoi vous pouvez nous faire confiance
Jacques a plus de 15 ans d’expérience en développement et a travaillé avec des centaines de boutiques Shopify. Nous avons créé Fudge - un constructeur de pages et éditeur de boutique Shopify natif pour l’IA avec une note de 5,0 et un badge Built for Shopify. Nous utilisons ces outils au quotidien.
Prérequis
- OpenAI Codex CLI installé et fonctionnel
- Node.js 18 ou supérieur (
node --versionpour vérifier) - Shopify CLI installé (nécessaire pour les opérations sur la boutique)
- Une boutique Shopify à laquelle se connecter (requis uniquement pour les opérations sur la boutique)
Installation : méthode par plugin
Dans le Codex CLI, exécutez :
/pluginsCherchez Shopify, puis sélectionnez Add to Codex.
Cela installe le plugin Shopify avec tous les skills d’agent disponibles.
Vérifier l’installation
Demandez à Codex quelque chose de spécifique à Shopify :
What's the correct GraphQL mutation to update a product's title in the Shopify Admin API?Si le toolkit est actif, Codex cherchera dans la documentation actuelle de Shopify et validera sa sortie au lieu de l’halluciner à partir de ses données d’entraînement.
Alternative : installation manuelle des skills
Si vous préférez installer les skills manuellement :
Installer tous les skills
npx skills add Shopify/shopify-ai-toolkitInstaller un skill spécifique
npx skills add Shopify/shopify-ai-toolkit --skill shopify-adminLes skills installés manuellement ne se mettent pas à jour tout seuls. Les schémas intégrés finiront par différer de la plateforme en ligne si vous ne les réinstallez pas périodiquement.
Alternative : configuration du serveur MCP
Pour une intégration MCP directe, Codex utilise la configuration TOML (contrairement à Cursor et Gemini CLI qui utilisent JSON). Le serveur Dev MCP fonctionne comme une intégration locale serveur/client mais fait des appels réseau vers les endpoints Shopify pour la recherche de documentation.
Consultez la documentation du Shopify AI Toolkit pour connaître le format de configuration TOML spécifique à Codex.
Télémétrie et transmission de code
Avant de commencer à valider du code : validate.mjs et search_docs.mjs envoient par défaut des payloads d’utilisation aux serveurs de Shopify.
Les fichiers SKILL.md décrivent cela comme des “résultats de validation anonymisés (succès/échec et nom du skill)”. Cependant, le payload réel de validation inclut le code en cours de validation - vos requêtes GraphQL, vos templates Liquid et tout autre code que vous passez dans le validateur.
Pour vous désinscrire (opt out) :
export OPT_OUT_INSTRUMENTATION=trueDéfinissez ceci avant de lancer Codex si vous travaillez avec du code propriétaire ou client.
Connexion à votre boutique
Pour les opérations sur la boutique (et pas seulement la génération et la validation de code), vous vous authentifiez via Shopify CLI :
shopify store auth --store votreboutique.myshopify.com --scopes write_products,read_productsLe toolkit détecte les scopes minimums requis pendant la validation. Scopes courants :
| Opération | Scope |
|---|---|
| Lire les produits | read_products |
| Mettre à jour les produits | write_products |
| Lire l’inventaire | read_inventory |
| Ajuster l’inventaire | write_inventory |
| Lire les commandes | read_orders |
| Lire les clients | read_customers |
Utilisez les scopes minimaux nécessaires. write_products donne accès à toutes les opérations d’écriture sur les produits, pas seulement à la mutation spécifique que vous exécutez.
Ce que vous pouvez faire
Les capacités sont les mêmes pour tous les clients IA compatibles. Voici ce que permet le toolkit :
GraphQL validé - Requêtes et mutations validées par rapport au schéma d’API Shopify intégré avant de les utiliser. Fini les champs sortis de nulle part (hallucinés) ou les modèles obsolètes.
Développement de thèmes - Templates Liquid validés par rapport aux règles de thème de Shopify, y compris les blocs de schéma et les en-têtes LiquidDoc.
Lié : ajouter une logique Liquid personnalisée dans Shopify.
Vitrines Hydrogen - Génération de composants React avec des imports et des patterns validés.
Fonctions et extensions - Personnalisation du backend (réductions, validation du panier, règles de livraison) et du scaffolding d’extensions d’interface utilisateur (UI) avec les composants Polaris.
Lié : ajouter du JavaScript personnalisé dans Shopify.
Opérations sur la boutique - Exécutez de l’Admin GraphQL sur une boutique en ligne via shopify store execute --allow-mutations. Les changements sont immédiats - il n’y a pas d’étape de brouillon. Consultez notre guide principal pour l’analyse complète des risques.
Gestion des metafields - Étendez le modèle de données de votre boutique avec des définitions de metafields et des données personnalisées.
Lié : ajouter des metafields aux produits Shopify.
Bonnes pratiques
Celles-ci s’appliquent à tous les clients du toolkit, mais méritent d’être répétées.
-
Faites une requête avant la mutation. Lisez toujours l’état actuel d’une ressource avant de la mettre à jour. Cela évite les écrasements involontaires.
-
Soyez précis avec les mutations. “Optimiser mes produits pour le SEO” est trop vague. “Mettre à jour la meta description pour le handle de produit ‘classic-tee’ vers ’…’” est suffisamment précis pour être sûr.
-
Poussez les thèmes en mode non publié. Le toolkit prend en charge
shopify theme push --unpublishedmais ne l’impose pas. Prenez-en l’habitude. -
Une ressource à la fois pour les changements critiques. Limite les dommages collatéraux (blast radius) si quelque chose se passe mal.
-
Gardez vos propres sauvegardes. Le toolkit n’a pas d’annulation (undo). Exportez les valeurs actuelles avant d’exécuter des mutations qui mettent à jour le contenu existant.
Limitations
Elles sont inhérentes au toolkit, et non spécifiques à Codex. Pour l’analyse complète des risques, consultez notre présentation du Shopify AI Toolkit.
- Pas de mode brouillon - Les mutations sur la boutique s’exécutent immédiatement sur votre boutique en direct
- Pas d’aperçu (preview) - Vous ne pouvez pas voir à quoi ressembleront les changements avant qu’ils ne se produisent
- Pas d’annulation/rollback - Les changements sont permanents une fois exécutés
- Pas d’historique d’audit - Aucune trace de ce qui a été modifié au niveau du toolkit
- Scopes larges - Les permissions OAuth s’appliquent à des types entiers de ressources, pas à des éléments individuels
- Code envoyé à Shopify - Les payloads de validation incluent votre code par défaut (désinscrivez-vous avec
OPT_OUT_INSTRUMENTATION=true) - Obsolescence manuelle des skills - Les installations sans plugin nécessitent des mises à jour manuelles régulières
Où Fudge intervient
L’AI Toolkit vous permet d’écrire du code Shopify plus rapidement — schémas, thèmes, Hydrogen, applications personnalisées. Ce n’est pas l’interface idéale pour l’équipe merch qui gère les opérations quotidiennes, et il n’apporte pas le workflow dont les vraies modifications de boutique ont besoin : brouillons, aperçus, approbations, historique des versions, lancements programmés, rollbacks. Le code vit dans git ; l’état de la boutique, non. C’est ce vide que Fudge comble — un éditeur Shopify natif IA avec des brouillons, des aperçus et des rollbacks pour les membres de votre équipe qui ne devraient pas écrire de GraphQL.
Référence rapide
| Tâche | Comment |
|---|---|
| Installer le plugin | /plugins puis cherchez Shopify et sélectionnez Add to Codex |
| Installer toutes les skills manuellement | npx skills add Shopify/shopify-ai-toolkit |
| Installer une seule skill | npx skills add Shopify/shopify-ai-toolkit --skill shopify-admin |
| Format de config MCP | TOML (contrairement au JSON pour Cursor/Gemini) |
| Authentification à la boutique | shopify store auth --store domain --scopes list |
| Désactiver la télémétrie | export OPT_OUT_INSTRUMENTATION=true |
| Vérifier la version de Node | node --version (nécessite 18+) |
Résumé
Le Shopify AI Toolkit fonctionne avec Codex de la même manière qu’avec Claude Code et Cursor : recherche dans la documentation, validation des schémas, et exécutions optionnelles sur la boutique. La valeur réside dans la boucle de précision - Codex arrête de deviner les API de Shopify et commence à les valider par rapport aux véritables schémas.
Les mêmes avertissements de gouvernance s’appliquent : pas de brouillons, pas d’aperçu, pas d’annulation, et télémétrie du code activée par défaut. Définissez OPT_OUT_INSTRUMENTATION=true si vous travaillez sur des projets propriétaires, et soyez prudent avec les exécutions sur la boutique.
Pour avoir une vue d’ensemble des risques, lisez notre présentation du Shopify AI Toolkit. Pour les autres plateformes, consultez notre guide Claude Code et notre guide Cursor.
Cet article a été mis à jour pour la dernière fois en avril 2026 à la suite de la sortie de Shopify Editions Winter 2026.
FAQ
La CLI Codex d'OpenAI utilise TOML pour son format de configuration général. La configuration du serveur MCP suit donc cette convention. Cursor, la CLI Gemini et la plupart des autres clients MCP utilisent JSON. La capacité est identique — seule la syntaxe diffère. Traduisez les exemples JSON de la doc Shopify en TOML pour Codex.
Oui, via l'intégration avec la Shopify CLI (shopify store execute --allow-mutations). Codex génère la mutation, la valide par rapport au schéma, puis déclenche la CLI pour l'exécuter sur votre boutique authentifiée. Mêmes avertissements que pour les autres clients : pas de mode brouillon, pas d'aperçu, pas d'annulation possible.
Le chemin d'installation par plugin se met à jour automatiquement avec les releases de Shopify. Les installations manuelles via npx skills add ne le font pas — vous devrez les ré-exécuter périodiquement pour garder vos schémas à jour. Codex n'a pas son propre mécanisme de mise à jour pour le toolkit ; il dépend de la méthode d'installation sous-jacente.
Oui — il faut vous réauthentifier via shopify store auth --store <domain> pour chaque boutique. La CLI garde une trace de la boutique active et Codex utilise celle qui est authentifiée à ce moment-là. Passer d'une boutique à une autre se fait en une commande. Très pratique pour jongler entre les environnements de dev/staging/production.
Les deux prennent en charge le même toolkit et les mêmes skills. La différence réside dans les capacités de l'agent (qualité du modèle, boucles agentiques, compréhension de la codebase) — choissisez celui que vous préférez pour le développement en général. Claude Code a une meilleure intégration type marketplace pour les plugins ; Codex possède une configuration basée sur TOML. Les fonctionnalités Shopify sont équivalentes.
