Comment configurer Claude Code pour Shopify (2026)

À retenir

• La méthode par plugin est la plus rapide et se met à jour automatiquement. Une seule commande pour l’installer : claude plugin install shopify-ai-toolkit@claude-plugins-official.
• L’installation manuelle des skills fonctionne mais ne se met pas à jour automatiquement. Les schémas intégrés finissent par se décaler par rapport à la plateforme en direct avec le temps.
• 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 sur la boutique s’exécutent immédiatement sur votre boutique en ligne. Il n’y a pas d’étape de brouillon.
• Interrogez toujours l’état actuel avant d’exécuter des mutations. Le toolkit n’a pas de fonction d’annulation.

Pour configurer Claude Code pour Shopify, installez le plugin Shopify AI Toolkit avec claude plugin install shopify-ai-toolkit@claude-plugins-official, puis posez une question sur l’API Shopify pour confirmer qu’il cherche dans la doc actuelle. Ajoutez le serveur Dev MCP pour un accès MCP direct, et exécutez shopify store auth uniquement si vous voulez que Claude modifie une boutique en ligne.

Une fois connecté, votre session Claude Code a accès à la documentation Shopify actuelle, à la validation du 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 CLI Shopify.

Pour une analyse complète de ce que fait le toolkit, de son fonctionnement et des risques de gouvernance liés à l’exécution sur la boutique, consultez notre présentation du Shopify AI Toolkit.

Connecter Claude à Shopify : quelle méthode choisir ?

“Connecter Claude à Shopify” signifie différentes choses selon qui se connecte :

Marchands (no code) : le connecteur officiel Shopify pour Claude. Shopify propose un connecteur pour Claude que vous installez depuis le répertoire de connecteurs de Claude. Il redirige vers votre admin Shopify pour approuver l’accès, sans passer par l’App Store.

• Ce qu’il peut faire : depuis Claude sur le web ou l’app de bureau, créer et mettre à jour des produits, consulter des commandes (en lecture seule), extraire des analytics avec des tableaux et des graphiques, et gérer les collections, l’inventaire, les pages et les codes de réduction en pourcentage.
• Ce qu’il ne peut pas faire : modifier ou publier des thèmes, changer les paramètres de la boutique, ou traiter des remboursements. C’est un assistant d’administration, pas un éditeur de storefront.
• Où se situent Sidekick et Fudge : dans l’admin, l’assistant de Shopify pour ce domaine est Shopify Sidekick. Pour les modifications par l’IA sur le storefront lui-même, avec des brouillons et des aperçus, c’est ce que fait Fudge, l’opérateur IA pour les boutiques Shopify.

Développeurs : Claude Code + le Shopify AI Toolkit. Le reste de ce guide. Cette voie donne à Claude un accès validé aux API, à la doc et à la CLI de Shopify - le bon choix quand vous écrivez du code de thème, des apps ou des automatisations.

Agents d’achat : endpoints du storefront. Chaque boutique Shopify expose également des endpoints de storefront orientés agents que les assistants d’achat IA utilisent pour parcourir les catalogues et créer des paniers. Rien à configurer ici en tant que marchand - lisez notre article sur le Universal Commerce Protocol de Shopify pour comprendre ce que cela signifie pour votre boutique.

Pourquoi 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 créons Fudge, l’opérateur IA pour les boutiques Shopify, avec une note de 4.9 sur le Shopify App Store et un badge Built for Shopify. Nous utilisons ces outils au quotidien.

Prérequis

• Claude Code installé et fonctionnel
• Node.js 18 ou supérieur, le minimum documenté par Shopify (node --version pour vérifier). Node 18 a atteint sa fin de vie en avril 2025, utilisez donc Node 20 LTS ou plus récent
• Shopify CLI installée (nécessaire pour les opérations sur la boutique)
• Une boutique Shopify à laquelle se connecter (uniquement requise pour les opérations sur la boutique - pas nécessaire pour la recherche de doc et la validation de code)

Installation : méthode par plugin (recommandée)

La méthode par plugin est la plus rapide et se met à jour automatiquement dès que Shopify publie de nouvelles fonctionnalités.

Vous préférez un support visuel ? Regardez le guide complet d’installation du plugin :

Étape 1 : Installer le plugin

Exécutez ceci depuis votre terminal (la commande actuellement documentée par Shopify, vérifiée en septembre 2026) :

claude plugin install shopify-ai-toolkit@claude-plugins-official

Cela installe tous les skills d’agent disponibles automatiquement. Notre vidéo montre le flux précédent en deux étapes /plugin marketplace add Shopify/shopify-ai-toolkit datant d’avril 2026 ; la ligne de commande ci-dessus est la méthode que la documentation de Shopify indique désormais.

Étape 2 : Vérifier l’installation

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

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

Si le toolkit fonctionne, Claude effectuera une recherche dans la documentation Shopify actuelle et retournera une requête validée au lieu de deviner à partir de ses données d’entraînement.

Alternative : installation manuelle des skills

Si votre configuration ne permet pas d’utiliser le plugin, ou si vous préférez gérer la skill vous-même, installez-la directement :

npx skills add Shopify/shopify-ai-toolkit

Ceci installe la skill shopify unique du toolkit, qui couvre toutes les surfaces de développement Shopify : l’API Admin GraphQL, Shopify Functions, Polaris, Liquid, Hydrogen et la CLI Shopify. Les versions précédentes proposaient une skill séparée par surface, comme shopify-admin et shopify-liquid. Celles-ci sont obsolètes et ne sont plus mises à jour, donc si vous en avez installé une, supprimez-la (par exemple npx skills remove shopify-admin shopify-liquid) et installez la skill shopify à la place.

Les skills installées manuellement ne se mettent pas à jour automatiquement. Exécutez npx skills update régulièrement pour rester à jour avec les changements d’API de Shopify. Sinon, les schémas intégrés finissent par se décaler par rapport à la plateforme en direct.

Shopify MCP + Claude Code : configuration directe du serveur

Pour une intégration MCP directe sans le plugin, ajoutez le serveur Dev MCP de Shopify à Claude Code avec une seule commande :

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

Le serveur s’exécute localement mais effectue des appels réseau vers les endpoints Shopify pour la recherche de documentation. L’authentification dépend du serveur MCP auquel vous vous connectez - Dev MCP pour la doc ne nécessite pas d’authentification à la boutique ; les opérations sur la boutique, oui.

Consultez la doc du Shopify AI Toolkit pour le format de configuration et les options.

Télémétrie et transmission de code

Avant de commencer à valider du code, sachez ceci : validate.mjs et search_docs.mjs envoient tous deux des payloads d’utilisation aux serveurs de Shopify par défaut.

Les fichiers SKILL.md décrivent cela comme des “résultats de validation anonymisés (réussite/échec et nom de la skill)”. Cependant, le payload de validation réel inclut le code en cours de validation - vos requêtes GraphQL, templates Liquid, et tout autre code que vous passez dans le validateur.

Pour désactiver cela, définissez cette variable d’environnement :

export OPT_OUT_INSTRUMENTATION=true

Si vous travaillez avec du code propriétaire, le code d’un client, ou quoi que ce soit que vous ne voulez pas transmettre aux endpoints de Shopify, configurez ceci avant votre première validation.

Se connecter à votre boutique

Pour exécuter des opérations sur une boutique en ligne (pas seulement générer et valider du code), vous devez vous authentifier via la CLI Shopify.

Authentification

Le toolkit gère cela automatiquement lorsque vous demandez une opération sur la boutique, mais la commande sous-jacente est :

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

Cela vous invite à autoriser l’accès via l’admin Shopify.

Sélection des scopes

Le script de validation du toolkit détecte les scopes OAuth minimum requis pour chaque opération. Scopes courants :

Tenez-vous-en aux scopes minimum 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 avec Claude Code + Shopify

Développement GraphQL validé

Demandez à Claude d’écrire des requêtes et mutations GraphQL Shopify. Le toolkit les valide par rapport au schéma d’API intégré avant que vous ne les utilisiez.

Claude cherchera dans la doc actuelle de l’API Admin Shopify, générera la requête, la validera par rapport au schéma intégré, et signalera tout problème ou scope requis. Moins de champs hallucinés et de patterns obsolètes.

Développement de thèmes

Travaillez avec des templates Liquid avec une validation par rapport aux règles de thème de Shopify. Le toolkit valide les schémas par rapport aux définitions JSON et impose les en-têtes LiquidDoc.

Développement de storefront Hydrogen

Créez des storefronts headless avec des composants React validés et des imports corrects depuis @shopify/hydrogen.

Opérations sur la boutique

Exécutez des opérations directement sur votre boutique connectée. Claude génère la mutation, la valide, s’authentifie auprès de votre boutique, et l’exécute via shopify store execute --allow-mutations.

Le changement est en ligne immédiatement. Il n’y a pas d’étape de brouillon. Consultez la section sur les risques dans notre guide principal pour comprendre pourquoi c’est important.

Gestion des metafields

Étendez le modèle de données de votre boutique avec des définitions de metafields. Le toolkit utilise TOML pour les définitions de metafields et connaît la différence entre les données appartenant à l’app et celles appartenant au marchand.

Fonctions et extensions

Créez des personnalisations backend - réductions, validation de panier, règles de livraison - et générez des extensions d’interface avec des composants Polaris. Les directives Functions de la skill savent que les Shopify Functions doivent être pures (pas d’appels réseau, pas de système de fichiers, pas d’aléatoire).

Pour des exemples pratiques sur les thèmes, consultez Comment ajouter une logique Liquid personnalisée dans Shopify.

Bonnes pratiques

Toujours interroger avant de muter

Avant de mettre quoi que ce soit à jour, lisez d’abord l’état actuel :

Montre-moi le titre, la description et les champs SEO actuels pour le produit avec le handle "classic-tee"

Cela vous donne une base de référence et aide à prévenir les écrasements involontaires.

Soyez précis avec les mutations

Des prompts vagues conduisent à des mutations trop larges. Au lieu de “Optimise mes produits pour le SEO”, soyez précis :

Mets à jour UNIQUEMENT la meta description pour le produit avec le handle "classic-tee" par "Achetez le Classic Tee - coton premium, 5 couleurs, livraison gratuite dès 50 €"

Poussez les thèmes en tant que non publiés

Lors du push de modifications de thème, poussez toujours en tant que non publié d’abord. Le toolkit supporte shopify theme push --unpublished, mais ne l’impose pas par défaut. Prenez-en l’habitude.

Une ressource à la fois pour les changements critiques

Pour les mises à jour importantes, exécutez-les produit par produit plutôt qu’en masse. Cela limite la zone d’impact si quelque chose tourne mal.

Conservez vos propres sauvegardes

Le toolkit n’a pas de fonction d’annulation. Avant d’exécuter des mutations qui mettent à jour du contenu existant, exportez ou notez les valeurs actuelles.

Limites

Celles-ci sont structurelles au toolkit, et non spécifiques à Claude Code. Pour l’analyse complète des risques, consultez notre présentation du Shopify AI Toolkit.

1. Pas de mode brouillon - Les mutations sur la boutique s’exécutent immédiatement sur votre boutique en ligne
2. Pas d’aperçu - Vous ne pouvez pas voir à quoi ressembleront les changements avant qu’ils ne se produisent
3. Pas d’annulation/rollback - Les modifications sont permanentes une fois exécutées
4. Pas de piste d’audit - Aucun registre au niveau du toolkit de ce qui a été modifié
5. Scopes larges - Les permissions OAuth s’appliquent à des types de ressources entiers, pas à des éléments individuels
6. Code envoyé à Shopify - Les payloads de validation incluent votre code par défaut (désactivez-le avec OPT_OUT_INSTRUMENTATION=true)
7. Obsolescence manuelle des skills - Si vous avez installé les skills manuellement, elles ne se mettront pas à jour automatiquement

Où Fudge intervient

Le AI Toolkit vous rend plus rapide pour écrire du code Shopify : schémas, thèmes, Hydrogen, apps sur mesure. Ce n’est pas la bonne interface pour l’équipe e-commerce qui gère les opérations quotidiennes, et ça n’ajoute pas le workflow dont les vrais changements sur la boutique ont besoin : brouillons, aperçus, approbations, historique des versions, rollbacks. Le code vit dans git ; l’état de la boutique, non.

C’est le vide que Fudge comble. Donnez-lui un objectif, comme plus de trafic de recherche ou un panier moyen plus élevé, et Fudge trouve ce qui vaut la peine d’être fait, prépare chaque changement comme un brouillon dans votre thème avec un aperçu et la raison qui le justifie, puis compare les chiffres avant et après la mise en ligne. Les requêtes ponctuelles passent par son éditeur de boutique de la même manière.

Vos développeurs peuvent garder Claude Code pour le travail sur mesure ; le reste de l’équipe n’aura jamais à écrire de GraphQL.

Référence rapide

Pour une vue d’ensemble des risques et de la gouvernance, lisez notre présentation du Shopify AI Toolkit. Pour la configuration sur d’autres plateformes, consultez notre guide Cursor et notre guide OpenAI Codex.

Nous avons revérifié pour la dernière fois les commandes et capacités de cette page par rapport à la doc actuelle de Shopify en septembre 2026.

FAQ