Développer Shopify avec Claude Code, le guide

Dernière mise à jour : mai 2026 — Claude Code transforme le développement Shopify : refactoriser un thème, bâtir une app, lancer des opérations en masse, le tout depuis le terminal. Ce guide montre comment l'utiliser concrètement. Rédigé par BoostEcom, experts Shopify et e-commerce.

Qu'est-ce que Claude Code ?

Claude Code est un agent de développement conçu par Anthropic qui s'exécute dans votre terminal. Ce n'est pas un outil d'autocomplétion : il lit l'ensemble de votre dépôt, propose un plan, puis exécute de vraies actions — modifications de fichiers, commandes shell, opérations git, appels à des serveurs MCP — avec votre permission à chaque étape.

Il s'installe comme un paquet Node et se lance avec la commande claude depuis n'importe quel dossier de projet. Il ouvre une session interactive dans le terminal, lit votre fichier CLAUDE.md (les instructions du projet) et attend votre demande.

L'atout qui change tout pour Shopify : sa fenêtre de contexte d'un million de tokens. Elle peut contenir un thème Shopify entier — le dossier snippets/, sections/, locales/, config/ — sans découpage. L'agent raisonne sur tout le code à la fois, au lieu de deviner ce que fait un snippet à partir de son nom.

Pourquoi Shopify est un terrain idéal pour Claude Code

Le développement Shopify a trois caractéristiques qui en font un cas d'usage particulièrement adapté à un agent en terminal :

• Des projets riches en fichiers mais légers — un thème basé sur Dawn compte 200 à 400 fichiers, mais ce sont de petits snippets Liquid, des schémas JSON et des partiels SCSS. Tout tient dans le contexte de Claude Code.
• Des conventions strictes — syntaxe Liquid, règles de theme check, exigences de schéma, spécifications d'app blocks. Un agent qui valide contre les règles réelles produit du code conforme.
• Un travail répétitif — refactoriser six sections, réécrire des requêtes GraphQL, corriger des filtres Liquid dépréciés. C'est exactement le type de tâche qu'un agent absorbe.

Le gain n'est pas que l'agent « tape plus vite ». C'est que le nombre de corrections du type « cette fonction n'existe pas » tombe quasiment à zéro, parce que l'agent vérifie la source de vérité à chaque fois.

Installer Claude Code pour Shopify

Prérequis : Node.js 18 ou supérieur (la plupart des développeurs Shopify ont déjà la 20 ou 22 via le Shopify CLI) et Claude Code installé et authentifié.

La pièce maîtresse est le Shopify AI Toolkit, qui connecte Claude Code à la documentation et aux schémas Shopify. La voie recommandée — le plugin, qui se met à jour seul :

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

Ou, pour le serveur Dev MCP seul (documentation et schémas, sans clé API) :

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

Dernière étape, la plus négligée : le fichier CLAUDE.md à la racine du projet. C'est la « bible » de l'agent — voix de marque, conventions du projet, politiques, instructions d'appel d'outils. Un projet Shopify sans CLAUDE.md soigné exploite mal l'agent.

Le workflow Claude Code + Shopify, concrètement

Une session type ressemble à ceci :

1. Vous lancez Claude Code dans le dossier du projet. Le Dev MCP se charge automatiquement.
2. L'agent interroge la documentation Shopify pour savoir quelles API sont en jeu.
3. Vous décrivez une fonctionnalité en langage naturel. L'agent cherche dans la doc, inspecte le schéma GraphQL en direct, écrit un plan et valide le code contre le schéma avant de vous le proposer.
4. Vous relisez et acceptez.
5. Claude Code lance shopify theme push --development ou shopify app deploy via le CLI.
6. Vous committez et poussez. Workflow git standard.

C'est nettement plus rapide que le workflow d'avant le MCP — non parce que l'agent écrit plus vite, mais parce que les allers-retours de correction disparaissent. Sur une équipe, ce gain se compose vite.

Claude Code, Cursor, Sidekick : qui fait quoi

Trois outils reviennent souvent dans le même débat. Le modèle mental utile : Sidekick est l'assistant du marchand, dans l'admin Shopify ; Claude Code et Cursor sont des outils de développeur. En pratique, Claude Code excelle pour l'échafaudage et les builds initiaux (génération de routes, requêtes, extensions) ; Cursor brille pour l'itération et le débogage visuel dans l'IDE. Les deux valident contre les schémas Shopify. À noter : Sidekick lui-même tourne sur un modèle Claude.

Skills sur mesure : l'atout des agences

Claude Code lit un dossier .claude/skills/ — des compétences spécifiques au projet. Les agences y encodent déjà la voix de marque d'un client, ses tokens de design et ses checklists de lancement. Résultat : un nouveau développeur sur un projet client devient productif en heures plutôt qu'en jours, parce que le savoir-faire de l'agence est lisible par l'agent.

Questions fréquentes

Claude Code est-il gratuit ?

Claude Code est un produit d'Anthropic accessible via un abonnement Claude ou l'API. Le Shopify AI Toolkit qu'on lui associe est, lui, gratuit et open source. Le coût dépend donc de votre plan Claude.

Faut-il savoir coder pour utiliser Claude Code sur Shopify ?

Oui. Claude Code est un outil de développement en terminal. Pour un usage sans code dans l'admin Shopify, c'est Sidekick qu'il faut regarder. Claude Code s'adresse aux développeurs, freelances et agences.

Claude Code peut-il modifier ma boutique en production ?

Oui, via le Shopify CLI et les opérations du AI Toolkit. Mais ces opérations n'ont ni aperçu ni annulation : testez sur une boutique de développement et relisez chaque action avant de l'appliquer.

Quelle différence entre Claude Code et Cursor pour Shopify ?

Claude Code est un agent en terminal, fort pour l'échafaudage et les builds. Cursor est un IDE, fort pour l'itération visuelle. Les deux valident contre les schémas Shopify ; beaucoup d'équipes utilisent les deux selon la phase.

À quoi sert le fichier CLAUDE.md ?

C'est le fichier d'instructions du projet, lu à chaque session. Il contient la voix de marque, les conventions, les politiques et les règles d'appel d'outils. Un bon CLAUDE.md est ce qui sépare un agent utile d'un agent approximatif.

À lire aussi

• Shopify AI Toolkit : le guide complet 2026 — les trois composants et leurs usages
• Le guide ultime du MCP pour Shopify en 2026 — les 4 couches MCP et l'échéance du 15 juin
• Connecter Shopify à Claude et ChatGPT en 2026 — 6 méthodes et 10 prompts

En résumé

Claude Code fait du développement Shopify un travail d'agent : vous décrivez, l'agent exécute et valide, vous relisez. Couplé au AI Toolkit et piloté par un bon CLAUDE.md, il élimine les heures perdues en code de base et en corrections. Pour une agence ou un freelance Shopify, c'est l'outil qui change l'économie d'un projet.

Pour aller plus loin : maîtrisez d'abord le Shopify AI Toolkit, puis le protocole MCP qui rend tout cela possible.