Construisez votre site web avec Claude Code
C'est un processus, pas un modèle. Il apprend à quelqu'un à construire un site web dont il serait fier — selon ses goûts, avec son propre contenu, sur la pile qui lui convient — en utilisant Claude Code comme constructeur. Vous fournissez le cadre et les actions ; ils fournissent la vision.
Tout repose sur un changement : la personne est le réalisateur, Claude est l'équipe. Ils décident de l'ambiance et de ce qui est suffisamment bien ; Claude échafaude, écrit, stylise, vérifie et publie. Votre travail lorsque vous utilisez cette compétence est d'extraire le goût d'eux, de le transformer en instructions que Claude peut exécuter, d'obtenir quelque chose en ligne rapidement, puis de boucler.
La règle d'or qui gouverne tout : obtenez d'abord un site réel, moche, en ligne, puis améliorez-le par petites étapes que vous pouvez voir. Un site qui est en ligne le jour 1 et itéré 50 fois bat un chef-d'œuvre qui n'est jamais publié.
L'état d'esprit (dites-le à voix haute tôt)
- Vous dirigez, Claude construit. La personne n'a jamais à écrire de code — ni même à connaître les mots. Elle décrit des sensations ("plus chaud", "c'est trop serré", "trop corporate") et indique ; Claude traduit en pixels.
- En ligne d'abord, beau ensuite. Déployez une coquille vide avant de styliser quoi que ce soit, pour déboguer le pipeline une fois, alors qu'il n'y a rien à casser.
- Codifiez le goût dans des fichiers. Une fois qu'ils aiment un look, inscrivez-le comme un système de conception qu'eux et Claude lisent à chaque session — c'est ce qui empêche le site de dériver.
- Petites étapes visibles. Un changement cohérent à la fois ; regardez-le ; validez-le. Les gros changements invisibles sont là où les sites meurent.
- Fermez la boucle. Publiez tôt, mettez-le devant de vraies personnes, nourrissez leurs retours directement à Claude comme la prochaine liste de tâches.
- Quand vous êtes bloqué, demandez à Claude. Chaque étape ci-dessous — création de comptes, correction d'une erreur de terminal en rouge, un écran d'hébergement déroutant — est quelque chose à confier à Claude, pas à résoudre seul. "Je n'ai jamais fait ça, guide-moi" et "voici une capture d'écran de ce que je vois" sont les deux choses les plus utiles que la personne puisse dire.
Comment utiliser cette compétence
Travaillez les phases dans l'ordre, mais ce n'est pas une cascade rigide — la Phase 4 (la boucle d'itération) est le moteur qui tourne en continu sous les autres :
Phase 0 → 1 cadrer et mettre en ligne · Phase 2 → 3 personnaliser et remplir · Phase 5 → 6 rendre mémorable et écouter · Phase 4 tourne tout le temps.
Chaque phase vous donne l'objectif, les actions, une invite copier-coller pour que la personne la donne à Claude, et le piège qui la ruine le plus souvent. Le matériel plus profond se trouve dans les fichiers de référence — utilisez-les quand une phase devient sérieuse.
Permission de s'arrêter. Un site d'une seule page apaisant — leur nom, une ligne à propos d'eux, un lien — est un site web réel et terminé. S'ils ont fini après la Phase 4, ils ont fini. Les phases 5 à 6 sont pour quand ils veulent plus, pas une barre à franchir.
Avant de commencer (Claude peut aider avec tout ça)
La personne a besoin de quatre choses gratuites en place avant la Phase 1. Tout cela peut être configuré en demandant à Claude de les guider — ne supposez pas qu'ils ont déjà fait quoi que ce soit :
- Claude Code, installé et ouvert dans un dossier pour le projet.
- Node.js + npm (pour la plupart des piles modernes) — Claude peut vérifier avec
node -vet l'installer. - Un compte GitHub (gratuit) — où le code vit et que l'hébergeur surveille.
- Un compte d'hébergement — Vercel, Netlify ou Cloudflare Pages (les niveaux gratuits sont généreux ; certains demandent une carte même pour le gratuit — pas de frais pour un site personnel normal).
Si l'un de ces éléments n'est pas familier, la toute première invite devrait être :
Je n'ai jamais configuré de projet de codage auparavant. Vérifie si Node, npm et git sont installés sur ma machine, et guide-moi — une étape à la fois — pour installer ce qui manque et créer des comptes GitHub et [Vercel/Netlify] gratuits. Dis-moi exactement sur quoi cliquer, et attends-moi à chaque étape.
Démarrage rapide (un site en ligne en un après-midi)
Si la personne veut de l'élan maintenant :
- Tirez le brief de goût. Posez les cinq questions de la Phase 0 ; écrivez les réponses dans un court
BRIEF.md. (~15 min) - Échafaudez + déployez une coquille vide. Choisissez une pile + un hébergeur push-to-deploy (si incertain, dites Next.js + Vercel et passez à autre chose), générez le starter avec son CLI officiel, poussez sur GitHub, connectez l'hébergeur, et confirmez que le site vierge est en ligne à une URL réelle. (~30 min, plus la première fois — les inscriptions aux comptes et la connexion de GitHub à l'hébergeur ajoutent ~20–30 min)
- Ajoutez le fichier de garde-fou. Créez
AGENTS.mddisant à Claude de lire la documentation du framework installé avant d'écrire du code (Phase 1). (~2 min) - Construisez juste le héros. Un écran : leur nom, une ligne à propos d'eux, un appel à l'action, couleurs du brief. Regardez-le dans le navigateur. (~20 min)
- Ajustez et validez. "agrandis le titre", "fond plus chaud", validez, poussez — c'est en ligne. (~15 min)
Ils ont maintenant un vrai site web à une vraie URL. Tout ce qui suit est une amélioration — la partie facile. (Les durées supposent que les comptes ci-dessus existent déjà ; la configuration initiale ajoute du temps, et c'est normal, pas un échec.)
Phase 0 — Cadrez : goût et portée
Objectif : être capable de décrire, en mots simples et images, comment le site doit se sentir et de quelles pages il a besoin — avant qu'un seul composant ne soit construit.
Actions
- Interviewez la personne. Ne concevez pas encore ; extrayez. Posez ces cinq questions :
- À qui est-il destiné, et que voulez-vous qu'ils fassent ou ressentent ? (vous embaucher, acheter ceci, lire vos écrits, "me prendre au sérieux", "voir que je suis amusant")
- Nommez l'ambiance en 2–3 mots. ("chaleureux et éditorial", "propre et technique", "bruyant et ludique", "calme et cher", "sombre et brutaliste"). Poussez pour des ressentis, pas des fonctionnalités.
- Montrez-moi ce que vous aimez. URLs de 2–3 sites, et captures d'écran, moodboards, ou toute image qui capture le sentiment — le goût de la plupart des gens est visuel, pas verbal, alors laissez-les coller des images. Et un site qu'ils détestent. Volez structure et ambiance, jamais le contenu.
- Quelle est la seule chose que ce site doit absolument réussir ? (l'écriture, les visuels, les échantillons de travail, être rapide)
- De quelles pages/sections avez-vous réellement besoin ? Résistez à l'expansion du périmètre — la plupart des sites personnels sont Accueil + une ou deux de plus.
- Écrivez les réponses dans un
BRIEF.mdà la racine du dépôt — l'étoile du nord que vous et Claude consultez. S'ils ont donné des images, notez quoi en retenir.
Invite à donner à Claude
Avant de construire quoi que ce soit, interviewe-moi sur le site web que je veux. Demande-moi, une par une : à qui il est destiné et ce que je veux que les visiteurs ressentent ou fassent ; l'ambiance en 2–3 mots ; les sites que j'aime (je vais coller des liens ET des captures d'écran/images de moodboard — réagis aussi aux images) plus un que je déteste ; la seule chose que ce site doit absolument réussir ; et de quelles pages j'ai réellement besoin. Écris ensuite mes réponses dans un BRIEF.md comme mon étoile du nord. N'écris pas encore de code de site.
Le piège : commencer à construire avant que quelqu'un puisse décrire le sentiment. S'ils ne peuvent pas nommer l'ambiance ou montrer une image de celle-ci, Claude revient par défaut à un modèle SaaS générique et chaque correction ultérieure lutte contre cette gravité. Obtenez le sentiment — en mots ou en images — d'abord.
Phase 1 — Fondation : mettez un site vide en ligne, puis protégez-le
Objectif : un site vierge mais réel, déjà déployé à une vraie URL avec un déploiement automatique configuré — pour que chaque changement ultérieur soit publié gratuitement — plus un garde-fou qui maintient Claude sur la vérité de base.
Vous n'avez pas besoin de savoir comment faire tout cela. Claude vous donne les clics et commandes exacts et attend pendant que vous les exécutez. Quand un écran vous déroute, faites-en une capture d'écran et collez-la — c'est tout le flux de travail, pas un échec.
Actions
- Choisissez la pile et l'hébergeur à l'avance (tableau ci-dessous). Préférez un hébergeur par les mêmes personnes que le framework pour que les valeurs par défaut fonctionnent. N'importe quelle voie est correcte ; le pire choix est de passer une journée à choisir.
- Échafaudez avec le CLI officiel du framework, pas à la main.
- Déployez le modèle vide d'abord. Poussez sur GitHub, connectez l'hébergeur, confirmez que le site vierge est en ligne avant de toucher au code — pour déboguer le pipeline alors que rien d'autre ne peut casser.
- Attachez un nom de domaine personnalisé tôt s'ils en ont un (c'est l'adresse réelle ; l'URL
*.host.appgratuite est temporaire). DNS — le paramètre qui pointe un nom de domaine vers le site — peut prendre quelques heures à prendre effet, alors commencez tôt. Pas encore de domaine ? L'URL de l'hébergeur est un bon endroit pour commencer ; achetez-en un plus tard. - Ajoutez le garde-fou de la vérité de base. Écrivez un
AGENTS.md(et un fichierCLAUDE.mdd'une ligne qui dit juste@AGENTS.md) disant à tout agent d'IA que le framework installé peut être plus récent que ses données d'entraînement, et de lire la documentation réelle dansnode_modules/<framework>/dist/docsavant d'écrire du code. Ce seul fichier empêche toute une classe de bugs d'API hallucinées. - Gardez les secrets hors de git dès le début. Un
.gitignoredoit exclure les fichiers d'environnement et la sortie de build ; ne validez jamais les clés API ou les adresses privées — gardez-les dans les paramètres d'environnement de l'hébergeur. Demandez à Claude de configurer cela avec le dépôt. - Écrivez les faits de déploiement que Claude ne peut pas déduire : URL de production, hébergeur, quelle branche se déploie automatiquement, le slug exact du dépôt, les éventuels pièges. Sauvegardez dans un fichier de notes/mémoire — le domaine en ligne n'est généralement pas découvrable à partir du code.
- Configurez l'aperçu local + une vérification de santé : une configuration d'exécution (ou une commande
devdocumentée + port) et une vérification d'une ligne que l'URL locale renvoie HTTP 200, pour pouvoir regarder avant de pousser.
Tableau de décision — choisissez une voie et passez à autre chose
| Si le site est… | Pile par défaut raisonnable | Hébergeur |
|---|---|---|
| Un portfolio / site personnel / CV | Next.js ou Astro | Vercel / Netlify |
| Principalement de l'écriture / un blog | Astro ou Next.js | Vercel / Netlify |
| Une simple page d'atterrissage / marketing | Astro ou Vite + React | Netlify / Cloudflare Pages |
| Quelque chose que vous voulez éditer à la main en fichiers simples | HTML + CSS simple (sans étape de build) | Netlify / CF / GitHub Pages |
| "Je ne sais pas, fais-le fonctionner" | Next.js + Vercel | Vercel |
(La dernière ligne choisit Next.js + Vercel uniquement parce que c'est le chemin le plus documenté pour que Claude s'appuie dessus — chaque voie ci-dessus est également légitime.)
Invite à donner à Claude
Échafaude un tout nouveau site [Next.js / Astro / HTML+CSS simple] avec son outil officiel, garde le starter intact, puis guide-moi à travers : git init + premier commit (avec un .gitignore qui exclut les fichiers d'environnement/secrets), création d'un dépôt GitHub, et connexion de [Vercel / Netlify] pour que chaque push sur main se déploie automatiquement. Confirme que le site vide est en ligne à une vraie URL avant que nous écrivions du code. Crée ensuite un AGENTS.md disant à tout agent d'IA que le framework installé peut être plus récent que ses données d'entraînement et de LIRE la documentation dans node_modules/[framework]/dist/docs avant d'écrire du code, plus un CLAUDE.md contenant juste @AGENTS.md. Enfin, sauvegarde mon URL de production, mon hébergeur, ma branche de déploiement et mon dépôt dans un fichier de notes. Donne-moi les clics exacts et attends-moi à chaque étape.
Le piège : construire tout le site avant de déployer une fois (alors vous déboguez le code et le pipeline en même temps), ou faire confiance à la mémoire du modèle d'un framework en évolution rapide au lieu de le fixer aux docs installés.
→ Média, limites de taille, commandes d'encodage, vérification de la production : references/PLAYBOOK.md.
Phase 2 — Codifiez votre langage de conception
Objectif : un système de conception écrit et lisible par machine — couleur, typographie, espacement, mouvement, voix — que la personne et Claude lisent à chaque session, pour que chaque nouvelle page reste cohérente avec la marque au lieu de dériver en cinq looks légèrement différents.
Faites cela après avoir une page que vous aimez vraiment, pas avant. Vous extrayez le système à partir de quelque chose de bon ; vous ne l'inventez pas dans le vide.
Actions
- Nommez l'ambiance en mots d'abord, puis dérivez chaque règle de celle-ci. Deux courtes phrases ; si deux ambiances sont en tension, cette tension devient une règle. (Une vraie construction avait pour phrases "calme éditorial chaleureux + artisanat pixel ludique" — mais un site "calme et cher" ou "bruyant et brutaliste" nommerait les siennes et dériverait des règles très différentes.)
- Utilisez la couleur délibérément et de manière cohérente. Une palette restreinte — souvent un seul accent — maintient la hiérarchie lisible et est la valeur par défaut sûre. Mais si le goût est maximaliste, rétro ou brutaliste, un système multicolore est un choix légitime. La règle n'est pas "exactement un accent" ; c'est que chaque couleur a un rôle défini et est utilisée de la même manière partout.
- Couleur en jetons nommés par rôle, pas en hexadécimal disséminé dans le balisage. Exprimez le texte doux et les bordures comme une couleur d'encre à opacité réduite, plutôt que d'inventer cinq gris presque identiques.
- Associez la typographie par rôle, pas par police (corps/UI, titres/"voix", mono, affichage). Référencez le rôle pour que la police réelle puisse changer plus tard sans réécriture.
- Fixez un rythme d'espacement et une échelle z-index, et écrivez "n'inventez pas de nouvelles valeurs."
- Énoncez une philosophie de mouvement qui correspond à l'ambiance : boucles d'ambiance bon marché en CSS, retour interactif dans une librairie JS ; bloquez le mouvement non essentiel derrière
prefers-reduced-motion. - Définissez une base accessible (cela fait partie de la qualité, pas un ajout) : contraste du texte du corps ≥ 4.5:1, véritable ordre des titres, états de focus visibles, repères sémantiques, texte alternatif sur les images significatives. Une palette audacieuse/sombre est exactement là où le contraste échoue silencieusement.
- Écrivez la voix et le ton comme conception — la copie fait partie du look (casse des phrases ? ludique ? mots simples ? pas de remplissage corporate ?).
- Codifiez dans deux fichiers validés : un
DESIGN_SYSTEM.mden prose (principes + recettes de composants + une checklist de build) et un fichiertokens(les valeurs brutes). Marquez-le comme à partir de maintenant seulement — extrait des pages existantes, pas une cible de migration — pour que Claude ne "refactore" pas utilement du code fonctionnel. - Intégrez-le au contexte : référencez le fichier de tokens dans le build et/ou les props par défaut de l'UI sans le rendre obligatoire tant que vous êtes en train d'itérer.
Invite à donner à Claude
Regarde ma première page en ligne — l'URL est [URL]. J'aime son look. Fais une liste de vérification de 5 questions sur mon ambi…
[Le texte a été tronqué pour la traduction]