Construire un site avec Claude Code, par une agence qui en livre
La plupart des guides disent encore de l'installer via npm. Voici le flux qui tient vraiment sur un site en production.
La plupart des guides publiés sur la création d'un site avec Claude Code se trompent dès leur premier paragraphe. Ils indiquent de l'installer via npm. Ce n'est plus le chemin d'installation depuis un moment, la documentation a migré de docs.claude.com vers code.claude.com, et l'outil tourne désormais sur cinq surfaces. Voici à quoi ressemble réellement le flux de travail en novembre 2026.
Ce qu'est réellement Claude Code
C'est un outil de codage agentique qui lit une base de code, modifie des fichiers, exécute des commandes et utilise vos outils de développement. Cette dernière partie le distingue d'une fenêtre de discussion qui renvoie des extraits : il lance le build, lit l'erreur et modifie à nouveau le fichier.
| Surface | À quoi il convient |
|---|---|
| Terminal | Le CLI complet. Installation par script shell, Homebrew, WinGet, apt, dnf ou apk. Idéal pour les builds longs. |
| Application de bureau | Diffs visuels, plusieurs sessions côte à côte, tâches planifiées. Inclut Claude Code, sans installation séparée. |
| VS Code et JetBrains | Diffs en ligne et revue de plan dans l'éditeur. Le plugin JetBrains requiert encore le CLI installé à part. |
| Web et mobile | claude.ai/code. Sans installation locale, utile pour les tâches parallèles. |
Commencez par le brief, pas par le prompt
La plus grande différence entre un site qui prend deux jours et un qui en prend deux semaines, c'est de savoir si les contraintes ont été écrites avant la création du premier fichier. Pas le design, les contraintes : quelles pages existent, ce que chacune doit accomplir, le modèle de contenu, qui l'édite ensuite, et quels faits ont le droit de figurer sur la page.
Ce brief a sa place dans un CLAUDE.md à la racine du projet, que Claude Code lit au début de chaque session. Ce n'est pas de la documentation pour humains que l'agent voit par hasard.
Choisissez la pile une fois et dites-le
Livré à lui-même, un agent ira vers ce qui est le plus courant dans son entraînement, ce qui pour un site vitrine signifie souvent un framework plus lourd que nécessaire. Décidez la pile vous-même et soyez précis sur la version.
- Nommez le framework et sa version majeure : un agent entraîné avant une rupture écrira l'ancienne API avec assurance.
- Nommez l'approche de style. Mélanger un framework utilitaire et du CSS de composants en cours de route est la cause la plus fréquente d'un site non maintenable.
- Nommez où vit le contenu. Un site dont les textes sont codés en dur dans les composants ne peut pas être édité par le client.
- Nommez l'hébergeur avant le premier déploiement : la sortie du build diffère entre export statique et runtime serveur.
Laissez-le planifier avant d'écrire
Demander un plan d'abord et le lire coûte quelques minutes et fait régulièrement gagner une journée. Le plan est l'endroit où vous découvrez qu'il compte installer trois dépendances non voulues. Voir les flux de travail courants et les bonnes pratiques.
La partie que tout le monde saute : la vérification
Un agent rapporte qu'il a construit la chose. Savoir s'il l'a vraiment construite est une autre question, et l'écart entre les deux abrite presque tous les mauvais résultats. La discipline qui marche : vérifier la sortie compilée plutôt que la source, et regarder la page rendue plutôt que la mesurer.
Ce que cela signifie en pratique est traité dans ce qu'il faut vérifier avant de croire que l'agent l'a construit.
Où les sites construits par agent perdent en recherche
Ils perdent là où personne ne regarde à l'écran. Des métadonnées héritées d'une route parente, un sitemap jamais généré, des données structurées valides qui décrivent la mauvaise chose. Rien de tout cela n'apparaît dans une revue de design. La liste complète est dans la checklist SEO d'un site construit par un agent.
Emballez les parties répétables
Au troisième site, vous redonnerez les mêmes instructions. C'est à cela que servent les skills : un dossier avec un SKILL.md qui emballe un flux de travail. Les hooks couvrent l'autre moitié. Voir les skills utiles sur un build de site.
Quand c'est le mauvais outil
Une base de code est un passif pour un client qui ne peut pas la maintenir. Voir quand une refonte est la mauvaise réponse et base de code construite par agent contre constructeur hébergé.
Pour approfondir l'outil, Anthropic propose des cours gratuits sur Claude Academy, et l'index complet de la documentation est publié sur code.claude.com/docs/llms.txt.
La suite de cette série
Chaque article ci-dessous prend une étape du flux décrit plus haut et va plus loin que cette page ne le permet. La configuration d'abord: un CLAUDE.md qui change les décisions, les skills qui valent la peine, en écrire un soi-même, et les trois serveurs MCP à connecter. Puis la boucle: les hooks qui verrouillent un dépôt de site, ce qu'il faut déléguer aux sous-agents, et comment vérifier le travail de l'agent. Puis le lancement: la liste SEO, les Core Web Vitals sur un site construit par agent, et la mise en production sans surprise.
