Créer son site avec Claude Code : tout comprendre avant de se lancer
Vous voulez créer le site de votre entreprise, ou même la petite application qui gère vos réservations, vos clients ou vos commandes, avec l'intelligence artificielle ? Claude Code peut écrire tout le code à votre place. Encore faut-il qu'il construise ce dont vous avez vraiment besoin, et pas un site générique, fragile ou invisible sur Google.
Pour ça, pas besoin d'apprendre à programmer. Il vous faut un socle : comprendre comment fonctionne le web, à quoi sert une base de données, quelles règles de sécurité respecter, ce que Google attend d'une page et ce qui fait un bon design. C'est ce que ce guide vous apporte, sans jargon, notion par notion, avec un schéma pour chacune.
Lisez-le dans l'ordre, une feuille à côté de vous : à la fin de chaque partie, vous aurez une décision de plus pour votre projet, et une meilleure demande à confier à Claude Code.
Par Gladston AristovernePublié le Mis à jour le 45 min de lecture28 schémas
Il y a encore quelques années, une petite application sur mesure pour une entreprise coûtait facilement 40 000 $ : un outil de réservation, un tableau de suivi des commandes, un espace client. En 2026, ce n'est plus le cas. Ce genre de projet est devenu abordable, de deux façons.
- Vous passez par un professionnel. Avec l'intelligence artificielle, il produit plus vite et vous facture beaucoup moins qu'avant pour le même résultat.
- Vous le faites vous-même. Vous investissez du temps pour vous former, et vous bâtissez votre site ou votre outil avec Claude Code, l'agent de programmation d'Anthropic.
La deuxième voie est à la portée de tous, à une condition : savoir ce que l'on fait. Claude Code écrit le code, mais il ne sait pas ce que vous voulez, ne voit pas toujours ce qui cloche et ne prendra pas les bonnes décisions à votre place. Pour ça, pas besoin d'apprendre à programmer. Il faut comprendre comment un site fonctionne.
C'est le but de ce guide : vous donner le socle à connaître avant de mettre la main dans Claude Code pour bâtir votre site, voire l'application qui pilote une partie de votre activité. Il part de zéro, chaque mot technique est expliqué, et chaque notion a son schéma. Comptez trois quarts d'heure de lecture, idéalement avant notre atelier en direct.
L'image à garder en tête. Avec Claude Code, vous êtes le chef de chantier, pas le maçon. Claude pose les briques très vite. Vous, vous devez lire le plan, savoir ce qu'est un mur porteur et refuser une fenêtre au mauvais endroit. Ce guide vous apprend à lire le plan.
À la fin, vous saurez :
- ce qui se passe entre le moment où quelqu'un tape votre adresse et l'affichage de votre page ;
- à quoi servent HTML, CSS et JavaScript, et lire un bout de code sans paniquer ;
- quand un site a besoin d'une base de données, et ce qu'on y range ;
- quels outils vous allez utiliser (terminal, éditeur, Git, hébergement) et pourquoi ;
- les règles de sécurité qu'on ne négocie pas ;
- ce que Google regarde pour référencer un site ;
- les principes de design qui évitent le site « fait par une IA » ;
- comment donner des instructions claires à Claude Code, et vérifier son travail.
Avant de commencer : la fiche de votre projet
Avant d'ouvrir Claude Code, prenez une feuille et décrivez ce qu'une personne doit pouvoir faire sur votre site. « Je veux un site pour mes ateliers » laisse beaucoup de choses à deviner. « Une participante choisit un atelier, voit les places disponibles et reçoit une confirmation après son inscription » vous donne déjà un parcours à dessiner et un résultat à vérifier.
- Qui vient et pourquoi ? Choisissez une personne et une tâche. Pour un atelier de cuisine, ce pourrait être une cliente qui cherche une place le samedi.
- Que doit-elle voir ? Dessinez trois écrans sur papier : les ateliers, le détail d'une séance, puis la confirmation. Sur chaque écran, écrivez ce qu'elle doit savoir pour continuer.
- Que faut-il préparer ? Rassemblez une description, un prix, une date, une capacité et une photo. Notez qui tient déjà le calendrier et où sont enregistrées les places.
- Comment vérifierez-vous le résultat ? Donnez votre dessin à quelqu'un. Peut-il choisir le samedi et dire comment il saura que sa place est réservée ? Demandez-lui aussi ce qui devrait se passer si la séance est complète.
Gardez cette feuille pendant la lecture et ajoutez-y une décision à chaque partie. Les questions sans réponse formeront votre première demande à Claude Code.
1. Comment fonctionne le web
Un site, ce sont des fichiers sur un ordinateur allumé en permanence
Un site internet, c'est un ensemble de fichiers (textes, images, code) rangés sur un ordinateur relié à internet jour et nuit : un serveur. Quand vous visitez un site, votre navigateur (Chrome, Safari, Firefox…) demande ces fichiers au serveur, les reçoit et les affiche.
Votre navigateur, c'est le client : celui qui demande. Le serveur, c'est celui qui répond. Tout le web repose sur ce dialogue client-serveur.
Le trajet d'une page, étape par étape
- Ouvrez la page Contact de Kabatis et repérez le chemin
/contactdans la barre d'adresse. - Le navigateur cherche le serveur. Les ordinateurs ne se repèrent pas avec des noms mais avec des numéros, les adresses IP. Le DNS est l'annuaire d'internet : il traduit
www.kabatis.comen adresse IP. - Le navigateur envoie une requête au serveur : « donne-moi la page
/contact». - Le serveur répond avec les fichiers de la page et un code de statut, qui dit comment la demande s'est passée.
- Le navigateur affiche la page. Il lit le code reçu et dessine ce que vous voyez à l'écran. S'il manque des images ou des styles, il les redemande au fur et à mesure.
Pour aller plus loin : le guide Comment fonctionne le web de MDN, la référence des développeurs web.
Décortiquer une adresse (URL)
Une adresse web se lit de gauche à droite, comme une adresse postale qui irait du pays à la porte.
Exemple réel : https://www.kabatis.com/api/formations?featured=true
| Morceau | Nom | Rôle |
|---|---|---|
https:// |
Protocole | La langue du dialogue. Le « s » veut dire « sécurisé » : les échanges sont chiffrés. |
www.kabatis.com |
Nom de domaine | L'adresse du site, louée à l'année. |
/api/formations |
Chemin | La ressource demandée, ici le catalogue de formations. |
?featured=true |
Paramètres | Un filtre qui demande uniquement les formations mises en avant. |
Nom de domaine et hébergement : deux choses différentes
On confond souvent les deux, alors qu'on les paie souvent à deux endroits différents.
- Le nom de domaine (
kabatis.com), c'est votre adresse postale. Vous le louez chez un registraire (OVH, Gandi, Namecheap, GoDaddy…) pour quelques dizaines de dollars ou d'euros par an. - L'hébergement, c'est le terrain où votre maison est construite : le serveur qui garde vos fichiers. Pour un site créé avec Claude Code, on utilise un hébergeur moderne comme Vercel, qui a une offre gratuite pour démarrer.
- Le DNS fait le lien entre les deux : on y indique « mon domaine pointe vers tel hébergeur ».
HTTP et HTTPS
HTTP est le protocole, c'est-à-dire la règle de conversation entre le navigateur et le serveur. HTTPS est sa version chiffrée : personne entre les deux ne peut lire ce qui passe, ni le modifier.
Le chiffrement repose sur un certificat SSL/TLS, que les hébergeurs modernes installent automatiquement et gratuitement, souvent grâce à Let's Encrypt. En 2026, un site sans HTTPS est signalé « non sécurisé » par les navigateurs. Ce n'est pas une option.
2. Les trois langages d'une page web
Chaque page que vous voyez est écrite avec trois langages qui ont chacun un rôle bien précis. Pensez à une maison.
HTML : la structure
HTML décrit ce que contient la page : un titre, un paragraphe, une image, un bouton, un formulaire. Il fonctionne avec des balises, des mots entre chevrons qui encadrent le contenu.
<h1>Boulangerie Martin</h1>
<p>Pains au levain cuits chaque matin à Fort-de-France.</p>
<a href="/contact">Nous écrire</a>
<h1>: le titre principal de la page (il n'y en a qu'un).<p>: un paragraphe.<a href="…">: un lien vers une autre page.
Les balises servent aussi à découper la page en grandes zones. Ce découpage compte beaucoup pour le référencement et l'accessibilité : c'est lui qui dit à Google et aux lecteurs d'écran ce qui est un menu, le contenu principal ou le pied de page.
Pour aller plus loin : la documentation HTML de MDN.
CSS : l'apparence
CSS décide de l'allure : couleurs, polices, tailles, espacements, disposition en colonnes, adaptation au téléphone.
h1 {
font-size: 48px;
color: #161413;
}
Traduction : « les titres principaux font 48 pixels et sont presque noirs ». Avec Claude Code, on utilise souvent Tailwind CSS, une façon d'écrire le CSS directement dans le HTML avec de petits mots-clés (text-4xl, font-bold). Vous en verrez partout dans votre code : ce n'est que du style.
JavaScript : le comportement
JavaScript rend la page interactive : ouvrir un menu sur mobile, vérifier un formulaire avant l'envoi, afficher un carrousel, charger des données sans recharger la page.
bouton.addEventListener('click', () => {
menu.classList.toggle('ouvert');
});
Traduction : « quand on clique sur le bouton, on ouvre ou ferme le menu ».
Et les « frameworks » ?
Écrire un site entier en HTML, CSS et JavaScript « à la main », c'est long. Les développeurs utilisent des frameworks : des boîtes à outils qui fournissent la structure de base et les fonctions courantes. Pour un site créé avec Claude Code, on utilise souvent Next.js, basé sur React. Retenez juste ceci : Next.js produit au bout du compte du HTML, du CSS et du JavaScript, comme n'importe quel site.
3. Front-end, back-end : ce qui se voit et ce qui ne se voit pas
Un site se divise en deux grandes parties.
- Le front-end, c'est tout ce qui s'exécute dans le navigateur du visiteur : la page, ses couleurs, ses boutons. C'est le HTML, le CSS et le JavaScript vus plus haut.
- Le back-end, c'est ce qui tourne sur le serveur, à l'abri des regards : enregistrer un formulaire, envoyer un courriel, vérifier un mot de passe, encaisser un paiement, lire une base de données.
Règle d'or. Tout ce qui est dans le front-end est visible par n'importe qui : un visiteur curieux peut lire le code JavaScript de votre page en deux clics. Donc rien de secret côté front-end : ni mot de passe, ni clé d'accès, ni calcul de prix qu'on pourrait trafiquer.
Site statique ou site dynamique ?
- Statique : les pages sont les mêmes pour tout le monde et changent seulement quand vous les modifiez. Une vitrine d'entreprise, un portfolio, un site de restaurant. Simple, rapide, peu cher, très sûr.
- Dynamique : le contenu dépend de qui regarde ou de ce qui a été enregistré. Un espace client, une réservation, une boutique, un blog que vous mettez à jour depuis une interface.
Demandez-vous toujours : ai-je vraiment besoin d'un back-end ? Un formulaire de contact peut passer par un service externe. Une prise de rendez-vous peut passer par Calendly. Chaque fonction côté serveur ajoute de la complexité, des coûts et des risques. L'IA vous construira volontiers une usine à gaz si vous ne la cadrez pas.
Les API : des prises entre logiciels
Une API est une porte d'entrée qu'un service offre à d'autres logiciels. Stripe a une API pour encaisser des paiements, Google Maps pour afficher une carte, un service d'infolettre pour inscrire quelqu'un. Votre site « branche » ces services au lieu de tout refaire.
Une API en pratique : lire le catalogue de formations Kabatis
Ouvrez le catalogue de formations, puis les données publiques des formations. La première adresse présente les formations aux visiteurs. La seconde renvoie des données qu'un autre logiciel peut lire : le service indique quelle adresse appeler, ce qu'on peut lui demander et sous quelle forme il répond.
Dans le deuxième onglet, recherchez "title". Vous devriez reconnaître un titre du catalogue. Les crochets [ ] délimitent une liste, les accolades { } regroupent les informations d'un élément. Ce format s'appelle JSON. Essayez maintenant le catalogue filtré. Si vous voyez [], la requête a réussi et aucune formation ne correspond au filtre.
Voici la même lecture depuis un terminal. Vous pouvez aussi faire tout l'exercice dans le navigateur.
curl "https://www.kabatis.com/api/formations"
De votre outil actuel à une petite application
Reprenez l'atelier de cuisine. Aujourd'hui, une employée consulte le logiciel de réservation et recopie les séances du samedi sur le site. Pour une première version, dessinez un écran « Prochains ateliers » avec la date et les places disponibles. Le logiciel de réservation continue de gérer les inscriptions.
- Vérifiez ce que permet votre outil. Dans sa documentation, cherchez « API », puis « lister les séances ». Il vous faut la date, le nombre de places restantes et le lien de réservation. Si l'outil fournit déjà un calendrier intégrable, essayez-le sur votre maquette : il peut suffire.
- Commencez avec deux séances fictives. Une séance a trois places et affiche « Réserver ». L'autre est complète. Faites valider ces deux affichages avant de connecter un compte.
- Branchez la lecture. Votre serveur demande les séances au logiciel de réservation et transmet à la page les champs utiles. Si le fournisseur exige une clé secrète, gardez-la sur le serveur et accordez seulement le droit de lecture.
- Testez une modification et une panne. Modifiez une capacité dans le compte de test et actualisez la page. Lorsque le service est indisponible, affichez « Disponibilités momentanément indisponibles » avec un lien vers le calendrier. Afficher « Complet » ferait perdre des réservations.
Votre première demande à Claude Code pourrait être : « Je gère des ateliers de cuisine. Voici mes deux séances fictives et mon dessin. Propose les champs nécessaires et décris ce que verra la cliente pour une séance disponible, complète ou impossible à charger. Attends ma validation avant de coder. »
Plus tard, si vous voulez que l'équipe reçoive une notification à chaque réservation, cherchez dans la documentation si le logiciel propose un webhook. Avec l'API, votre site demande les séances. Avec un webhook, le logiciel de réservation prévient votre serveur quand une inscription a lieu.
4. La base de données, sans formule
Un classeur très bien rangé
Une base de données est un endroit où le site range des informations de façon organisée pour les retrouver vite. La plus courante ressemble à un classeur Excel :
- une table est une feuille (les clients, les commandes, les articles du blog) ;
- une ligne est un élément (un client) ;
- une colonne est une information sur cet élément (son nom, son courriel, sa date d'inscription) ;
- chaque ligne a un identifiant unique, comme un numéro de dossier.
Les relations
La force d'une base de données, ce sont les relations. Plutôt que de recopier le nom et l'adresse du client dans chaque commande, la commande garde seulement son identifiant. Si le client change d'adresse, on la modifie à un seul endroit.
SQL : la langue des bases de données
On parle à une base de données en SQL. Vous n'aurez pas à l'écrire, mais savoir le lire vous aidera à comprendre ce que fait Claude Code.
SELECT nom, courriel FROM clients WHERE ville = 'Cayenne';
Traduction : « donne-moi le nom et le courriel des clients qui habitent Cayenne ».
Attention aux deux derniers verbes. Un
UPDATEou unDELETEsans condition précise touche toutes les lignes. Quand Claude Code vous propose une commande qui modifie ou supprime des données réelles, lisez-la, et ayez une sauvegarde.
Ce que vous devez décider vous-même
- Quelles informations vous gardez, et pourquoi. Chaque donnée personnelle conservée est une responsabilité légale. Ne collectez que ce qui sert.
- Qui peut les voir. Le visiteur ne doit jamais pouvoir lire les données d'un autre.
- Les sauvegardes. Vérifiez que votre fournisseur de base de données en fait automatiquement, et combien de temps il les garde.
Pour un site créé avec Claude Code, on utilise souvent PostgreSQL hébergé chez Neon ou Supabase, avec Prisma, un outil qui sert d'interprète entre le code et la base.
5. Les outils du chantier
Fichiers, dossiers et projet
Votre site est un dossier sur votre ordinateur, rempli de fichiers : c'est le projet. Claude Code va lire et écrire dans ce dossier. Prenez l'habitude de savoir où il se trouve (par exemple Documents/mon-site) et de ne jamais y mettre autre chose que le site.
Le terminal
Le terminal est une fenêtre où l'on donne des ordres à l'ordinateur en tapant du texte au lieu de cliquer. Il fait peur au début. En réalité, vous n'y taperez presque rien vous-même : c'est là que vit Claude Code, et c'est là qu'il lance les commandes.
- Sur Mac : application Terminal (Cmd + Espace, puis tapez « Terminal »).
- Sur Windows : PowerShell (menu Démarrer, tapez « PowerShell »).
Trois commandes suffisent pour vous repérer : pwd (où suis-je ?), ls (qu'y a-t-il ici ? dir sur Windows), cd mon-dossier (entrer dans un dossier). Jamais ouvert de terminal ? Le guide du terminal de Claude Code montre chaque étape.
L'éditeur de code
Un éditeur de code est un traitement de texte pour le code : il colore la syntaxe, affiche l'arborescence du projet et repère les erreurs. Le plus répandu, gratuit, est Visual Studio Code (VS Code). Vous vous en servirez surtout pour regarder : ouvrir un fichier, voir ce que Claude Code a changé.
Git et GitHub : l'historique qui vous sauve
Git enregistre l'historique de votre projet, comme des points de sauvegarde dans un jeu vidéo. Chaque sauvegarde s'appelle un commit, avec un petit message qui dit ce qui a changé (« Ajout de la page Contact »). Si Claude Code casse quelque chose, vous revenez au commit précédent.
GitHub est un site qui garde une copie de cet historique en ligne. Ça sert de sauvegarde, et c'est de là que l'hébergeur récupère votre site pour le mettre en ligne. Le vocabulaire minimum :
- dépôt (repository, « repo ») : le projet suivi par Git ;
- commit : un point de sauvegarde ;
- push : envoyer vos commits sur GitHub ;
- branche : une version parallèle pour tester sans toucher à la version principale.
Le réflexe qui change tout. Demandez à Claude Code de faire un commit à chaque étape qui fonctionne. « Ça marche, fais un commit » devrait être votre phrase la plus fréquente.
Pour aller plus loin : le livre gratuit Pro Git, en français, et la documentation de GitHub.
Node.js et npm : les ingrédients
Node.js permet de faire tourner du JavaScript sur votre ordinateur, et pas seulement dans le navigateur. npm est son magasin de paquets : des morceaux de code écrits par d'autres, qu'on ajoute au projet au lieu de les réécrire. La liste des paquets utilisés est dans le fichier package.json.
npm install fait les courses, npm run dev vous laisse goûter en local.6. Du projet sur votre ordinateur au site en ligne
Local et production
- En local, le site tourne sur votre ordinateur, à une adresse du type
http://localhost:3000. Vous seul le voyez. C'est votre atelier : on peut tout casser. - En production, c'est la version publique, celle que voient vos visiteurs et Google.
On teste toujours en local avant d'envoyer en production. Toujours.
Le déploiement
Déployer, c'est publier une nouvelle version du site. Avec un hébergeur comme Vercel relié à GitHub, c'est automatique : à chaque push, il récupère le code, le prépare (étape de build, où il vérifie et assemble tout) et met la nouvelle version en ligne en une minute ou deux. Si le build échoue, l'ancienne version reste en ligne : rien n'est cassé pour vos visiteurs.
Il crée aussi une préversion (preview) à une adresse temporaire pour chaque branche : pratique pour montrer une modification à quelqu'un avant de la publier.
Les variables d'environnement
Votre site a besoin de secrets pour fonctionner : l'adresse et le mot de passe de la base de données, la clé de l'API de paiement, celle du service de courriel. On ne les écrit jamais dans le code. On les met dans des variables d'environnement.
- en local, dans un fichier
.envqui n'est jamais envoyé sur GitHub ; - en production, dans les réglages de l'hébergeur.
7. La sécurité minimale, non négociable
Un site créé avec l'IA n'est pas moins sûr qu'un autre… à condition de respecter quelques règles. L'IA écrit du code qui marche ; elle n'a pas toujours le réflexe de demander « et si quelqu'un essaie de tricher ? ». Ce réflexe, c'est vous.
Les secrets
- Jamais de clé ou de mot de passe dans le code, même « juste pour tester ». Uniquement dans
.envet chez l'hébergeur. - Vérifiez que le fichier
.gitignorecontient bien.env: c'est la liste des fichiers que Git ne doit jamais enregistrer. - Si une clé a fuité (publiée sur GitHub, collée dans un message public), changez-la immédiatement chez le fournisseur. La supprimer du code ne suffit pas : elle reste dans l'historique.
Les données des visiteurs
- Ne faites jamais confiance à ce qui arrive du navigateur. Un formulaire peut être rempli par un robot, un prix peut être modifié avant l'envoi. Le serveur doit tout revérifier : format du courriel, longueur des textes, et surtout les montants, recalculés côté serveur.
- Les mots de passe ne se stockent jamais en clair. Mieux : n'en gérez pas vous-même. Utilisez une solution de connexion éprouvée (connexion par Google, par lien magique, ou une bibliothèque reconnue) et demandez-la explicitement à Claude Code.
- Chaque utilisateur ne voit que ses propres données. Testez-le : connectez-vous avec deux comptes et essayez d'ouvrir la page de l'autre en changeant l'adresse.
Le site lui-même
- HTTPS partout (automatique chez les hébergeurs modernes).
- Protégez les formulaires contre les robots : un champ piège invisible, une limite de tentatives, ou un captcha discret.
- Mettez à jour les paquets régulièrement : les failles connues sont corrigées dans les nouvelles versions. Demandez à Claude Code de vérifier avec
npm audit. - Sauvegardes : le code est sur GitHub, mais la base de données ? Vérifiez.
Votre façon de travailler avec Claude Code
- Lisez ce que Claude Code s'apprête à exécuter, surtout s'il veut supprimer des fichiers, modifier une base de données en production ou installer quelque chose. Il vous demande la permission avant les actions sensibles : ne validez pas à l'aveugle.
- Ne collez pas de secrets dans la conversation quand ce n'est pas nécessaire. Dites plutôt « la clé est dans le fichier .env, sous le nom X ».
- Demandez une revue de sécurité avant la mise en ligne : « Relis le projet comme un expert en sécurité et liste les risques, du plus grave au moins grave. »
Pour aller plus loin : le Top 10 de l'OWASP recense les failles les plus fréquentes des applications web.
8. Le minimum légal
Ce qui suit est un repère général, pas un avis juridique. Faites valider votre situation par un professionnel.
Dès que votre site collecte des données personnelles (un formulaire de contact suffit), vous avez des obligations :
- Au Québec, la Loi 25 : désigner un responsable de la protection des renseignements personnels, publier une politique de confidentialité claire, obtenir le consentement avant les témoins (cookies) qui ne sont pas indispensables. La Commission d'accès à l'information publie des guides pour les entreprises.
- En France et dans l'Union européenne, le RGPD : mêmes principes, plus des mentions légales obligatoires (identité de l'éditeur, hébergeur) et un bandeau de consentement conforme aux recommandations de la CNIL sur les traceurs.
- Partout : ne pas utiliser de textes, photos, polices ou logos dont vous n'avez pas les droits. Une image trouvée sur Google n'est pas libre de droits.
Claude Code peut rédiger une première version de vos pages légales à partir de vos informations réelles. Relisez-les : c'est votre responsabilité, pas la sienne.
9. Le référencement (SEO) : ce que Google regarde vraiment
Le référencement naturel (SEO) regroupe tout ce qui aide votre site à apparaître dans les résultats de Google sans payer de publicité. Un site magnifique que personne ne trouve ne sert à rien.
Les trois étapes de Google
- L'exploration : des robots (Googlebot) parcourent le web en suivant les liens et lisent vos pages.
- L'indexation : Google range les pages qu'il juge utiles dans son index, une immense bibliothèque. Une page hors de l'index ne peut pas apparaître dans les résultats.
- Le classement : pour chaque recherche, Google choisit l'ordre des pages selon leur pertinence et leur qualité.
Google l'explique lui-même dans Comment fonctionne la recherche Google.
Ce que Google demande, en clair
Google le répète dans ses consignes : il veut des contenus utiles, fiables et écrits pour les personnes, pas pour les moteurs de recherche. Il ne pénalise pas un texte parce qu'il a été écrit avec l'aide d'une IA. Il pénalise les contenus sans valeur, produits en masse pour manipuler le classement.
Concrètement, votre contenu doit montrer votre expérience réelle : vos vrais projets, vos photos, vos chiffres, vos clients, votre territoire. C'est exactement ce que l'IA ne peut pas inventer, et c'est ce qui vous distingue des sites génériques.
Ce que voit l'internaute dans Google
Les bases techniques à exiger de Claude Code
- Une page = un sujet = une intention de recherche. La page « Plombier à Cayenne » ne parle pas aussi de chauffe-eau solaires à Kourou.
- Une balise title unique par page (autour de 60 caractères) et une meta description qui donne envie de cliquer (autour de 155 caractères).
- Un seul H1 par page, puis des H2 et H3 dans l'ordre logique, comme le plan d'un document.
- Des adresses lisibles :
/services/renovation-salle-de-bain, pas/page?id=8273. - Des liens internes entre vos pages, avec des textes de lien qui disent où ils mènent (pas « cliquez ici »).
- Des images optimisées : légères (format WebP ou AVIF), avec un texte alternatif qui décrit l'image.
- Un plan du site (
sitemap.xml) et un fichierrobots.txt, que Google lit pour savoir quoi explorer. - Des données structurées : un code invisible qui décrit votre entreprise à Google (nom, adresse, horaires, avis), et peut enrichir votre affichage dans les résultats.
La vitesse : les Core Web Vitals
Google mesure l'expérience réelle de vos visiteurs avec trois indicateurs, les Core Web Vitals.
Après la mise en ligne
Testez la page Contact de Kabatis dans PageSpeed Insights et repérez le temps d'affichage du contenu principal sur mobile. Pour suivre votre propre site, inscrivez-le dans Google Search Console, l'outil gratuit de Google. Il vous dit quelles pages sont indexées, sur quelles recherches vous apparaissez, et ce qui pose problème. Envoyez-y votre sitemap. Si vous avez une entreprise locale, créez aussi votre fiche Google Business Profile : pour les recherches près de chez vous, elle compte autant que le site.
Pour aller plus loin : le guide de démarrage SEO de Google. Et si vous préférez déléguer, voyez notre accompagnement en référencement.
10. Les clés du design (et comment éviter le site « fait par une IA »)
Demandez à une IA « un site moderne pour mon entreprise » sans plus de précisions : vous obtiendrez le même site que tout le monde. Dégradé violet, icônes dans des ronds, trois cartes alignées, des phrases creuses (« Propulsez votre croissance »). Le design ne se délègue pas. Il se décrit.
La hiérarchie : un message, une action
Sur chaque écran, le visiteur doit comprendre en trois secondes ce qui est le plus important. Un seul message principal, un seul bouton d'action principal.
Les quatre autres principes
- La typographie. Deux polices maximum : une pour les titres, une pour le texte. Un texte courant d'au moins 16 pixels, des lignes pas trop longues (autour de 70 caractères).
- Les couleurs. Une couleur dominante (souvent un fond neutre), une secondaire, une couleur d'accent réservée aux actions. La règle 60-30-10 est un bon départ.
- L'espace. Le vide n'est pas du gaspillage. Des marges généreuses rendent un site haut de gamme ; tout coller le rend bon marché.
- Le contraste et l'accessibilité. Le texte doit se lire facilement sur son fond, les boutons doivent être assez grands pour un pouce, le site doit fonctionner au clavier. Ce n'est pas un bonus : c'est pour tout le monde. Le W3C en donne les bases de l'accessibilité.
Pensez mobile d'abord
La majorité de vos visiteurs arriveront sur téléphone. Regardez chaque page sur un téléphone avant de la valider. Dans Chrome, les outils de développement ont un mode « appareil mobile » pour simuler un écran de téléphone.
Ce qui rend un site unique
- Vos vraies photos : votre équipe, vos locaux, vos réalisations. Une photo de téléphone bien cadrée vaut mieux qu'une image de banque d'images.
- Vos vrais textes : votre façon de parler, vos arguments, vos exemples. Donnez à Claude Code votre matière première, il la mettra en forme.
- Des références : montrez-lui deux ou trois sites que vous aimez (de n'importe quel secteur) et dites précisément ce qui vous plaît dans chacun.
- Une identité : votre logo, vos couleurs, vos polices, écrites noir sur blanc avant de commencer.
11. Travailler avec Claude Code
Claude, Claude Code : de quoi parle-t-on ?
Claude est l'assistant d'intelligence artificielle d'Anthropic. Dans la conversation classique (sur claude.ai), il répond et peut produire du code que vous copiez vous-même.
Claude Code va plus loin : c'est un agent qui travaille directement dans le dossier de votre projet. Il lit vos fichiers, les modifie, lance les commandes (installer, tester, publier) et vous explique ce qu'il fait. C'est l'outil que nous utilisons pour créer un site complet.
Ce qu'il faut savoir avant l'atelier :
-
Vérifiez que votre compte donne accès à Claude Code. Anthropic l'inclut dans certains abonnements Claude payants et l'ouvre aussi aux comptes Console avec des crédits. L'offre gratuite de claude.ai n'y donne pas accès.
-
Il s'installe en une commande, à copier dans le terminal. Sur Mac :
curl -fsSL https://claude.ai/install.sh | bashSur Windows, dans PowerShell :
irm https://claude.ai/install.ps1 | iexOuvrez ensuite un nouveau terminal et tapez
claude --version: un numéro de version doit s'afficher. -
Vous le lancez en tapant
claudedans le dossier de votre projet. La première fois, il ouvre votre navigateur pour vous connecter à votre compte. -
Vous préférez éviter le terminal ? L'application de bureau Claude permet aussi d'utiliser Claude Code avec une interface graphique.
Les commandes et les offres évoluent souvent : en cas de doute, le guide de démarrage officiel fait foi.
Le cycle de travail
- Demandez une petite chose à la fois. Une page, une section, une fonction. Pas « tout le site ».
- Faites planifier avant d'exécuter pour tout ce qui est un peu gros.
- Validez le plan, ou corrigez-le avant qu'une ligne de code soit écrite.
- Laissez Claude Code coder, en lisant ce qu'il vous demande d'autoriser.
- Regardez le résultat en local (
npm run dev), sur ordinateur et sur téléphone. Corrigez en précisant : « le titre est trop gros sur mobile », plutôt que « c'est moche ». - Faites un commit quand ça marche, puis publiez quand une série de changements est prête.
Bien demander : la méthode en quatre temps
La qualité de ce que produit Claude Code dépend directement de la qualité de vos demandes.
- Le contexte : qui vous êtes, à qui s'adresse le site, ce qui existe déjà.
- L'objectif : ce que la page ou la fonction doit permettre, en une phrase.
- Les contraintes : le style, ce qu'il ne faut pas faire, les contenus à utiliser.
- Le critère de réussite : comment vous saurez que c'est réussi.
Demande floue :
Fais-moi une page d'accueil.
Demande utile :
Je suis ostéopathe à Gatineau. Ma clientèle : des sportifs amateurs de 25 à 50 ans. Crée la page d'accueil avec, dans l'ordre : une accroche (« Retrouvez votre mobilité, sans attendre trois semaines »), mes trois spécialités (textes dans le fichier contenu.md), un bouton « Prendre rendez-vous » qui mène vers mon lien de réservation, et mes coordonnées. Style sobre : fond blanc cassé, texte anthracite, accent vert sapin, police Inter. Pas d'icônes génériques ni de dégradés. Avant de coder, propose-moi la structure et attends ma validation.
Le fichier CLAUDE.md : la mémoire du projet
Claude Code lit un fichier nommé CLAUDE.md à la racine du projet. Écrivez-y une fois pour toutes ce qu'il doit toujours savoir. Vous éviterez de tout répéter à chaque séance. La documentation explique comment Claude Code gère sa mémoire.
Les pièges classiques
- Accepter sans regarder. Claude Code se trompe parfois avec beaucoup d'assurance. Vérifiez toujours le résultat dans le navigateur.
- Les conversations interminables. Après une longue séance, l'agent peut perdre le fil. Commencez une nouvelle session pour une nouvelle tâche ; le
CLAUDE.mdgarde l'essentiel. - Tourner en rond sur un bug. Si deux tentatives échouent, demandez à Claude Code d'expliquer la cause avant de corriger, ou revenez au dernier commit qui fonctionnait.
- Ajouter des fonctions « tant qu'on y est ». Chaque ajout est à maintenir. Un site simple et terminé vaut mieux qu'un site ambitieux et cassé.
- Laisser l'IA inventer le contenu. Les textes, les chiffres, les témoignages doivent venir de vous. Un faux témoignage peut vous coûter cher, légalement comme en réputation.
12. Le glossaire
| Terme | En une phrase |
|---|---|
| API | Une porte d'entrée qu'un service offre aux autres logiciels (paiement, carte, courriel). |
| Back-end | La partie du site qui tourne sur le serveur, invisible pour le visiteur. |
| Base de données | L'endroit où le site range ses informations, en tables. |
| Branche | Une version parallèle du projet pour tester sans risque. |
| Build | L'étape où le code est vérifié et assemblé avant la mise en ligne. |
| Cache | Une copie gardée de côté pour aller plus vite ; parfois la raison pour laquelle « rien n'a changé ». |
| Client | Le navigateur qui demande les pages. |
| Commit | Un point de sauvegarde dans l'historique Git. |
| Core Web Vitals | Les mesures de vitesse et de stabilité utilisées par Google. |
| CSS | Le langage de l'apparence : couleurs, polices, mise en page. |
| Déploiement | La publication d'une nouvelle version du site. |
| DNS | L'annuaire qui traduit un nom de domaine en adresse de serveur. |
| Framework | Une boîte à outils qui donne la structure d'un site (ex. Next.js). |
| Front-end | Ce qui s'exécute dans le navigateur du visiteur. |
| Git / GitHub | L'outil d'historique du projet / le site qui le garde en ligne. |
| Hébergement | Le serveur qui garde et sert les fichiers du site. |
| HTML | Le langage de la structure : titres, paragraphes, liens, images. |
| HTTPS | La version chiffrée du dialogue entre navigateur et serveur. |
| Indexation | L'ajout d'une page dans la bibliothèque de Google. |
| JavaScript | Le langage du comportement : ce qui bouge et réagit. |
| JSON | Un format de données lisible par les logiciels, avec des listes [ ] et des fiches { }. |
| Local | La version du site qui tourne sur votre ordinateur. |
| Nom de domaine | L'adresse de votre site, louée à l'année. |
| npm / paquet | Le magasin de morceaux de code réutilisables / un de ces morceaux. |
| Production | La version publique du site. |
| Requête | Une demande envoyée par le navigateur au serveur. |
| Serveur | L'ordinateur, allumé en permanence, qui répond aux demandes. |
| SQL | La langue utilisée pour parler aux bases de données. |
| Terminal | La fenêtre où l'on donne des ordres à l'ordinateur en texte. |
| Variable d'environnement | Un réglage secret (clé, mot de passe) gardé hors du code. |
| Webhook | Un message qu'un service envoie à votre serveur quand un événement se produit. |
13. Votre liste avant l'atelier
Les comptes :
- Un accès à Claude Code (abonnement qui l'inclut ou crédits Console)
- Un compte GitHub (gratuit)
- Un compte Vercel, créé avec votre compte GitHub (gratuit pour démarrer)
- Votre nom de domaine, si vous en avez déjà un (sinon, on en parlera)
Sur votre ordinateur :
- Claude Code installé (
claude --versionaffiche un numéro) - Visual Studio Code installé
- Git installé (
git --versionaffiche un numéro ; sur Mac, il est proposé à la première utilisation) - Node.js installé, version LTS (
node --versionaffiche un numéro)
Votre matière première (le plus important) :
- La fiche de votre projet, remplie au début de ce guide
- La liste des pages que vous voulez (5 maximum pour commencer)
- Vos textes, même bruts : Claude Code vous aidera à les mettre en forme
- Votre logo et 5 à 10 vraies photos
- Deux ou trois sites que vous aimez, avec ce qui vous plaît dans chacun
- La recherche Google sur laquelle vous aimeriez être trouvé (« coiffeur à Saint-Laurent », « traiteur créole Montréal »)
Questions fréquentes
Faut-il savoir programmer pour créer son site avec Claude Code ?
Non. Claude Code écrit le code. En revanche, il faut comprendre les notions de ce guide pour lui donner des instructions précises, vérifier son travail et éviter les erreurs de sécurité ou de référencement.
Peut-on créer un site avec la version gratuite de Claude ?
La version gratuite permet de générer du code dans la conversation, que vous devez ensuite copier et assembler vous-même. Claude Code, qui travaille directement dans votre projet et le met en ligne avec vous, nécessite un accès compatible, par exemple un abonnement qui l'inclut ou des crédits Console.
Combien coûte un site ou une petite application créés avec l'intelligence artificielle ?
Si vous le faites vous-même : l'accès à Claude Code et le nom de domaine (quelques dizaines de dollars ou d'euros par an). L'hébergement et la base de données ont des offres gratuites suffisantes pour démarrer un site vitrine ou un petit projet. Si vous passez par un professionnel qui travaille avec l'IA, le budget reste bien inférieur à ce qu'il était il y a quelques années pour un outil sur mesure.
Quelle différence avec Wix ou Squarespace ?
Un constructeur de site vous fait choisir parmi des modèles et vous enferme dans sa plateforme. Avec Claude Code, le code vous appartient : vous pouvez tout personnaliser, l'héberger où vous voulez et le faire évoluer sans limite. En contrepartie, vous devez comprendre un minimum de choses, d'où ce guide.
Un site créé avec l'IA peut-il bien se référencer sur Google ?
Oui. Google évalue l'utilité et la fiabilité du contenu, pas l'outil qui a servi à l'écrire. Un site rapide, bien structuré et nourri de votre expérience réelle a toutes ses chances. Un site rempli de textes génériques, non.
Passer à la pratique
Deux façons de continuer :
- Vous voulez le faire vous-même ? Dans notre atelier en direct « Créez votre site web avec l'IA », vous repartez avec votre site en ligne : on applique tout ce guide, ensemble, sur votre projet.
- Vous préférez confier le projet ? Nous concevons des sites et des outils sur mesure avec l'IA, à un coût bien inférieur à celui d'un développement classique. Découvrez notre offre en création web ou décrivez-nous votre projet.
