Comment configurer le Shopify AI Toolkit avec Claude Code

Points clés

• La méthode par plugin est la plus rapide et se met à jour automatiquement. Deux commandes suffisent pour l’installation.
• L’installation manuelle des skills fonctionne, mais ne s’auto-actualise pas. Avec le temps, les schémas intégrés (bundled schemas) finissent par se désynchroniser de la plateforme en direct.
• Définissez OPT_OUT_INSTRUMENTATION=true avant votre première validation si vous travaillez avec du code propriétaire. Les payloads de validation incluent votre code par défaut.
• Les opérations de boutique sont exécutées immédiatement sur votre boutique en ligne. Il n’y a pas d’étape de brouillon (draft).
• Interrogez toujours l’état actuel avant de lancer une mutation. Le toolkit n’a pas de fonction “annuler” (undo).

Claude Code est l’un des principaux outils de codage IA supportés par le Shopify AI Toolkit. Une fois connecté, votre session Claude Code a accès à la documentation Shopify actuelle, à une validation de code par rapport aux schémas d’API intégrés, et à la capacité d’exécuter des opérations sur la boutique via la Shopify CLI.

Ce guide couvre la configuration et tout ce qu’il faut savoir. Pour une analyse complète de ce que fait le toolkit, de la façon dont il fonctionne et des risques de gouvernance liés à l’exécution de code 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 conçu Fudge - un constructeur de pages et éditeur de boutiques Shopify natif à l’IA noté 5,0 avec le badge Built for Shopify. Nous utilisons ces outils au quotidien.

Prérequis

• Claude Code installé et fonctionnel
• Node.js 18 ou supérieur (node --version pour vérifier)
• Shopify CLI installée (nécessaire pour les opérations de boutique)
• Une boutique Shopify sur laquelle se connecter (requise uniquement pour les opérations : ce n’est pas nécessaire pour la recherche de documentation ou la validation de code)

Installation : méthode plugin (recommandée)

Tuto vidéo : Vous préférez suivre les étapes visuellement ? Découvrez le tutoriel complet d’installation du plugin sur YouTube.

La méthode d’installation par plugin est la plus rapide et se met à jour automatiquement chaque fois que Shopify sort de nouvelles fonctionnalités.

Vous préférez suivre visuellement ? Regardez cette présentation complète de l’installation du plugin :

Étape 1 : Installer le plugin

Dans votre session Claude Code, exécutez ces deux commandes :

/plugin marketplace add Shopify/shopify-ai-toolkit
/plugin install shopify-plugin@shopify-ai-toolkit

Cela installera toutes les skills disponibles pour l’agent automatiquement.

Étape 2 : Vérifier l’installation

Posez une question spécifique à Shopify à Claude pour confirmer que le toolkit est actif :

Quelle est la bonne mutation GraphQL pour mettre à jour le titre d'un produit via la Shopify Admin API ?

Si le toolkit est fonctionnel, Claude cherchera dans la documentation Shopify la plus récente et renverra une requête validée au lieu d’halluciner ou de deviner à partir de ses données d’entraînement.

Alternative : installation manuelle des skills

Si vous préférez installer vos skills manuellement (ex : si vous n’avez besoin que de certaines fonctionnalités) :

Installer toutes les skills

npx skills add Shopify/shopify-ai-toolkit

Installer une skill spécifique

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

Notez que les skills installées manuellement ne se mettent pas à jour d’elles-mêmes. Vous devrez relancer la commande d’installation occasionnellement pour rester synchronisés avec les mises à jour de l’API de Shopify. Avec le temps, les schémas intégrés (bundled schemas) s’éloigneront de la version live de la plateforme actuelle.

Alternative : configuration via serveur MCP

Pour une intégration MCP directe, vous pouvez vous connecter au Dev MCP server de Shopify. Cela agit comme une intégration client-serveur en local, mais cela effectue tout de même des network calls aux endpoints de Shopify pour la recherche au sein de la documentation. L’authentification dépend du serveur MCP que vous rejoignez : Dev MCP pour la doc ne demande pas d’authentifier de boutique, mais les opérations de boutique oui.

Consultez la documentation du Shopify AI Toolkit pour trouver le format de configuration et les autres options.

Télémétrie et transmission de code

Avant même de valider le premier bout de code, vous devez savoir ceci : validate.mjs et search_docs.mjs envoient des payloads d’utilisation aux serveurs de Shopify par défaut.

Les fichiers SKILL.md traduisent cela sous la forme de “résultats de validation anonymisés (réussite/échec et nom de la skill)”. Toutefois, le payload de validation contient la totalité du code que vous testez - vos requêtes GraphQL, l’ensemble de vos templates Liquid et tout autre code scanné par le validateur.

Pour le désactiver (opt-out), vous devez régler cette variable d’environnement :

export OPT_OUT_INSTRUMENTATION=true

Si vous gérez du code propriétaire, le code d’un de vos clients, ou que vous souhaitez éviter de transférer ces données vers les endpoints de Shopify, paramétrez bien cela avant de générer la première validation.

Se connecter à votre boutique

Pour effectuer des opérations sur une boutique en live (et pas seulement tester ou valider du code d’application), une authentification à la Shopify CLI est nécessaire.

Authentification

Le framework se charge de ça en automatique lors de l’exécution d’une opération de boutique, mais si on cherche la commande sous-jacente, c’est celle-ci :

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

Cela vous demandera d’autoriser l’accès via l’interface admin de Shopify.

Sélection des scopes

Le script de validation du framework analyse et trouve toujours la quantité de scopes OAuth nécessaires pour valider une opération. Voici quelques exemples de scopes habituels :

Restez sur le minimum de scopes requis. write_products va donner l’accès à TOUTES les fonctionnalités d’écriture de produits, et pas juste à votre mutation ciblée.

Ce que vous pouvez faire

Développement GraphQL validé

Vous pouvez demander à Claude de rédiger des requêtes et mutations GraphQL Shopify. Ensuite, le toolkit fera tourner le code pour repérer toute discordance via le bundle du document sur la version d’API intégrée.

Claude va d’abord sonder la documentation actuelle de l’API Shopify Admin, sortir la requête test, puis valider s’il ne manque aucun scope ou autre aspect. Finis les champs sortis du chapeau (hallucination) ou devenus obsolètes.

Développement de thèmes

Manipulez des templates Liquid en les testant suivant les bonnes règles de thèmes chez Shopify. Les schémas JSON et la bonne méthode via formatage des headers par le code LiquidDoc seront appliqués pour vous.

A lire aussi : ajouter de la logique Liquid personnalisée dans Shopify.

Développement de storefronts Hydrogen

Produisez des storefronts headless à base de composants de type React testés tout en appliquant la syntaxe précise d’imports via : @shopify/hydrogen.

Opérations sur la boutique

Traitez ou déployez vos opérations directement face à l’environnement cible. Claude génère la mutation, l’évalue, vérifie les accès via l’interface de votre admin puis propulse son action via la commande : shopify store execute --allow-mutations.

Cette action est visible en direct très vite. C’est un process où la phase de brouillon n’existe pas. Pensez à aller lire la zone des risques de notre guide général pour bien piger tout ça.

Gestion des metafields

Ajustez finement votre architecture d’informations produits/marque via les définitions de metafields. Le toolkit est configuré en mode TOML pour analyser tout le contenu et dissocier le flux data application face aux métadonnées des boutiques de vos marchands (merchant data).

Consultez l’article lié : ajouter des metafields aux produits Shopify.

Functions et extensions

Confectionnez des optimisations backend : vos codes de réduction, de vérification des paniers, règles du mode expédition - mais également des extensions UI via des composants de type Polaris. L’IA incluse dans la gestion Functions n’oublie pas le point vital que doit avoir Shopify, c’est-à-dire être et rester un module pur (pas de retours extérieurs de serveurs non maîtrisés, zero accès base de données ou scripts impromptus/aléatoires).

Voir aussi : ajouter du JavaScript personnalisé dans Shopify.

Bonnes pratiques

Toujours faire un query avant une mutation

Avant de vouloir modifier quoique ce soit, sondez l’environnement original en l’état actuel d’abord :

Affiche-moi le titre, la description actuelle ainsi que les balises ou champs réservés au SEO du produit avec pour handle : "classic-tee"

C’est la garantie d’une référence propre qui aide à vérifier l’état des options pour stopper ou éviter l’écrasement ou annulation d’information.

Soyez spécifique avec vos mutations

Toute écriture de prompt évasif mènera toujours vers un code très large. Dans le contexte SEO par ex. plutôt que dire : “Mets-moi à niveau tout ça !”, visez juste :

Mets à jour UNIQUEMENT la meta description pour le produit avec le handle "classic-tee" avec "Achetez le t-shirt Classic - coton haut de gamme (premium), ses 5 couleurs et frais de livraisons remisés au de-là de 50€"

Pusher les thèmes en mode non publié (unpublished)

Quand vous pushez un script de changement dans la maquette de votre thème, passez toujours en version brouillon d’abord. Les lignes intègrent très bien shopify theme push --unpublished, ce n’est cependant pas imposé automatiquement au lancement du toolkit. Prenez cela en habitude !

Une ressource à la fois pour les changements critiques

Traitez l’essentiel par le format d’optimisations de détails produits par produits, et jamais en mode de bloc lourd (bulk mode ou batchings d’infos). C’est vital s’il faut remonter un éventuel effet domino en cas de mauvaises pratiques ou d’un accident d’upload sur une ressource impactée (blast radius).

Gardez vos propres sauvegardes (backups)

Il n’est pas possible d’utiliser la touche retour ou “undo” du toolkit. La meilleure recommandation de base face aux écritures lourdes ou de la data modifiée est d’agir en copiant tout vos paramètres ou contenus ailleurs tout en documentant les attributs (noter l’ID de ressources) liés dans le même cadre qu’utilisé au précedent stade.

Limites

Elles sont inhérentes et structurelles au toolkit en soi et non imputables de manière propre à l’écriture native par le code de Claude. À étudier davantage sur notre grande synthèse et overview du Shopify AI Toolkit.

1. Pas de mode draft (brouillon) - Une mutation sera appliquée rapidement lors de son cycle final, en direct
2. Pas de fonctionnalité de prévisualisation (preview) - Difficile de prévisualiser l’objet du rendu pour validation visuelle simple
3. Pas d’effet retour / rollbacks - Zéro droit d’erreurs en action (irréversible pour le dev pure sans backup/script annexe de la commande appliquée en console du code par erreur de variable ou mutation de datas).
4. Pas d’historique (audit trail) - Aucun historique ne figure entre la base outil Toolkit en lien et les commandes déployées ou réaffectées pour le tracking de gestion du code natif et d’intégration via le store/projet en direct
5. Trop de broad scopes (scopes larges) - Vous visez en permissions un format d’accord sans différenciation au niveau de tous les autres processus de la famille ou item qui héberge un point non inclus versé, mais tout de même accessible pour la phase oauth visée (Ex accès ressource pour une data minime mais globale).
6. Exportation sur log / Envoie vers Shopify - Opt-out non généré si on l’oublie, car par base native il déverse aux services Shopify les codes via les processus d’automatisation des lectures et logs analytiques (Utilisez la balise d’éviction de transfert OPT_OUT_INSTRUMENTATION=true).
7. La limite ou faille sur du manuel - Installer sur le mode par paramétrage sur mode d’API ne s’autosync plus si vous ne réalisez pas en mode natif ce rafraîchissement seul (sans quoi le code s’abaisse pour créer son aspect decay / pourriture de skill de vos fonctions ou datas du SDK).

Aide-mémoire

En résumé

Le Shopify AI Toolkit fait de Claude Code un véritable environnement de développement orienté Shopify. La capacité de recherche dans la doc et de validation du code valent à elles seules l’installation pour tout développeur Shopify - la boucle de précision fait gagner un temps fou.

Pour le développement pur - création d’applications, de thèmes, ou de storefronts Hydrogen - le gain de productivité est évident. Pour les opérations sur la boutique en revanche, attention aux limites de gouvernance : pas de brouillons, de preview, de Ctrl+Z, et une télémétrie du code activée de base. Soyez donc tout à fait conscients des options à cocher ou à garder allumées.

Pour une documentation propre et des insights liés à la structure même du système de gestion des limites des API du moment, lisez notre article de ref. : Présentation du Shopify AI Toolkit. Et, à l’inverse, si vous visez de tester / voir le comparatif des autres modèles tels qu’avec la marque OpenAI : Configuration OpenAi codex ainsi que l’article détaillé du même projet d’outils mais pour app et le SDK à viser via via le guide : Cursor et son environnement dédié.

Cet article a été mis à jour pour la dernière fois en avril 2026 en ce basant sur l’annonce du de la nouvelle édition de Shopify Editions Winter 2026.