(514) 447-8567Configurer votre projet

Nos expertises pour bâtir, faire croître et automatiser votre présence digitale.

Voir toutes nos expertises

Web et Mobile

Création de site webE-commerceApplications webAPI

SEO & Google Ads

SEO TechniqueSEO LocalGoogle AdsReporting

Digitalisation d'Entreprise

Implantation CRMOffice 365Google WorkspaceMonday.com

Intelligence Artificielle

Agents IAChatbotsIA GénérativeDéploiement RGPD

Super Blada

Super Blada
Voir l'étude de cas
  • Services
    • Web et Mobile
    • SEO & Google Ads
    • Digitalisation d'Entreprise
    • Intelligence Artificielle
  • Réalisations
  • Blog
Super Blada
Super BladaVoir l'étude de cas
Configurer votre projet
(514) 447-8567info@kabatis.com
  • Facebook
  • LinkedIn
  • Instagram
  • YouTube
  1. Accueil
  2. /
  3. Formations
  4. /
  5. Guide Claude Code

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 16 septembre 2026Mis à jour le 16 novembre 202645 min de lecture28 schémas

Sommaire

  1. Avant de commencer : la fiche de votre projet
  2. 1. Comment fonctionne le web
  3. 2. Les trois langages d'une page web
  4. 3. Front-end, back-end : ce qui se voit et ce qui ne se voit pas
  5. 4. La base de données, sans formule
  6. 5. Les outils du chantier
  7. 6. Du projet sur votre ordinateur au site en ligne
  8. 7. La sécurité minimale, non négociable
  9. 8. Le minimum légal
  10. 9. Le référencement (SEO) : ce que Google regarde vraiment
  11. 10. Les clés du design (et comment éviter le site « fait par une IA »)
  12. 11. Travailler avec Claude Code
  13. 12. Le glossaire
  14. 13. Votre liste avant l'atelier
  15. Questions fréquentes
  16. Passer à la pratique

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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 client, le DNS et le serveur Schéma en quatre étapes. Le navigateur, le client, demande au DNS où se trouve exemple.com (1). Le DNS répond : à l'adresse 76.76.21.21 (2). Le navigateur envoie alors une requête au serveur : donne-moi /contact (3). Le serveur, qui garde les fichiers du site, renvoie la page en réponse (4). LE WEB · CLIENT ET SERVEUR DNS l'annuaire du web exemple.com NAVIGATEUR Le client votre navigateur SERVEUR Le serveur garde les fichiers 1 Où est exemple.com ? 2 À l'adresse 76.76.21.21 3 Requête : donne-moi /contact 4 Réponse : la page
Ce qui se passe en moins d'une seconde quand vous tapez une adresse.

Le trajet d'une page, étape par étape

  1. Ouvrez la page Contact de Kabatis et repérez le chemin /contact dans la barre d'adresse.
  2. 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.com en adresse IP.
  3. Le navigateur envoie une requête au serveur : « donne-moi la page /contact ».
  4. Le serveur répond avec les fichiers de la page et un code de statut, qui dit comment la demande s'est passée.
  5. 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.
Les quatre codes de réponse HTTP à connaître Quatre cartes. 200 : tout va bien, personne n'est responsable, c'est normal. 301 : la page a déménagé, c'est voulu par le site. 404 : page introuvable, la faute à un lien ou une adresse erronée. 500 : erreur du serveur, la faute au code du site. LES CODES DE RÉPONSE HTTP 200 Tout va bien RESPONSABLE Personne : c'est normal 301 La page a déménagé RESPONSABLE Le site, c'est voulu 404 Page introuvable RESPONSABLE Un lien ou une adresse erronée 500 Erreur du serveur RESPONSABLE Le code du site
Les codes de statut les plus courants. Vous les croiserez dans les messages de Claude Code et dans Search Console.

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.

Anatomie d'une URL L'adresse https://www.exemple.com/blog/mon-article?page=2 découpée en quatre parties : « https:// » est le protocole, la langue utilisée, le s voulant dire sécurisé ; « www.exemple.com » est le nom de domaine, votre adresse ; « /blog/mon-article » est le chemin, la page précise ; « ?page=2 » sont les paramètres, des précisions supplémentaires. L'ADRESSE D'UNE PAGE · L'URL PROTOCOLE la langue, s = sécurisé CHEMIN la page précise https:// www.exemple.com /blog/mon-article ?page=2 NOM DE DOMAINE votre adresse PARAMÈTRES des précisions
Chaque morceau d'une adresse a un rôle précis.

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.

Nom de domaine, hébergement et DNS Une analogie en deux blocs reliés. À gauche, le nom de domaine, par exemple exemple.com, c'est l'adresse postale : on le loue chez un registraire et on le paie à l'année. À droite, l'hébergement, c'est le terrain et la maison : le serveur qui garde les fichiers du site. Entre les deux, le DNS est le panneau qui relie l'adresse au terrain. NOM DE DOMAINE · HÉBERGEMENT · DNS NOM DE DOMAINE exemple.com = l'adresse postale loué chez un registraire payé à l'année HÉBERGEMENT un serveur loué = le terrain et la maison le serveur qui garde les fichiers du site DNS le panneau qui relie l'adresse au terrain
L'adresse, le terrain, et le panneau qui les relie.
  • 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.

HTTP contre HTTPS Deux lignes. En HTTP, le message « mot de passe : soleil42 » circule en clair entre le navigateur et le serveur, et un tiers placé au milieu peut tout lire. En HTTPS, symbolisé par un cadenas, le même message devient illisible, par exemple « x9#Lq… », et le tiers ne peut rien lire. Le certificat qui permet le HTTPS est installé automatiquement par l'hébergeur. LA SÉCURITÉ · HTTP ET HTTPS HTTP le message circule en clair NAVIGATEUR mot de passe : soleil42 SERVEUR Un tiers peut tout lire HTTPS le message est codé NAVIGATEUR x9#Lq$7@vK… SERVEUR Un tiers ne peut rien lire Le certificat est installé automatiquement par l'hébergeur
Sans HTTPS, un mot de passe tapé dans un formulaire voyage en clair.

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, CSS et JavaScript La même carte « Boulangerie Martin » en trois étapes. Avec le HTML seul, on obtient un texte brut sans mise en forme : ce sont les murs, la structure. En ajoutant le CSS, la carte reçoit un bandeau foncé, un titre en gras et un vrai bouton : c'est la décoration, la mise en forme. En ajoutant JavaScript, un clic sur le bouton « Commander » ouvre un formulaire : c'est l'électricité, l'interactivité. LES 3 LANGAGES D'UNE PAGE WEB HTML Boulangerie Martin Pain, viennoiseries Ouvert 7 h – 19 h Commander les murs la structure + CSS Boulangerie Martin Pain, viennoiseries Ouvert 7 h – 19 h Commander la décoration la mise en forme + JAVASCRIPT Boulangerie Martin Commander clic Votre nom Votre commande l'électricité l'interactivité
HTML, ce sont les murs. CSS, la décoration. JavaScript, l'électricité.

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.

Le squelette d'une page web Une page découpée en blocs empilés, chacun avec sa balise HTML et son rôle : header, l'en-tête avec le logo ; nav, le menu de navigation ; main, le contenu principal, qui contient h1, le titre de la page ; footer, le pied de page. Ces balises disent à Google et aux lecteurs d'écran ce qu'est chaque zone. LE SQUELETTE D'UNE PAGE · HTML <header> LOGO <nav> <main> <h1> le grand titre <footer> En-tête et logo Menu de navigation Contenu principal Le titre de la page Pied de page Ces balises disent à Google et aux lecteurs d'écran ce qu'est chaque zone de la page.
Chaque zone de la page a sa balise.

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.
Front-end et back-end Deux zones. En haut, le front-end, visible par tous, dans le navigateur : les pages, le design, la saisie des formulaires. Il envoie des demandes au back-end, qui lui répond. En bas, le back-end, en coulisses, sur le serveur : il vérifie, envoie les courriels, encaisse les paiements et garde les secrets. Le back-end est relié à une base de données et à des services externes appelés API. Encadré : jamais de secret côté front-end, car tout ce qui arrive dans le navigateur est visible. CE QU'ON VOIT · CE QUI TOURNE EN COULISSES FRONT-END visible par tous · dans le navigateur Les pages Le design La saisie des formulaires demande réponse BACK-END en coulisses · sur le serveur Vérifier Envoyer les courriels Encaisser Garder les secrets BASE DE DONNÉES clients, commandes SERVICES EXTERNES API · ex. le paiement JAMAIS DE SECRET CÔTÉ FRONT-END Tout ce qui arrive dans le navigateur est visible
Le visiteur ne voit que le front-end. Le back-end et la base de données travaillent en coulisses.

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 ?

Site statique ou site dynamique Comparaison en deux colonnes. Un site statique affiche la même page pour tout le monde, comme un site vitrine, un portfolio ou un site de restaurant : c'est simple, rapide et sûr. Un site dynamique affiche une page qui dépend de qui regarde, comme un espace client, un système de réservation ou une boutique en ligne : c'est plus puissant, mais plus à surveiller. Question à se poser : ai-je vraiment besoin d'un back-end ? DEUX FAMILLES DE SITES STATIQUE La même page pour tout le monde EXEMPLES Site vitrine Portfolio Restaurant Simple, rapide, sûr DYNAMIQUE La page dépend de qui regarde Léa Marc Inès EXEMPLES Espace client Réservation Boutique en ligne Plus puissant, plus à surveiller Question à se poser : ai-je vraiment besoin d'un back-end ?
Commencez par la version la plus simple qui répond à votre besoin.
  • 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 relie votre site à d'autres services Votre site, à gauche, est relié par trois prises à trois services : le paiement avec Stripe, la carte avec Google Maps et le courriel avec une infolettre. Sur chaque lien, une étiquette « clé d'API ». En bas, la légende : une API est une prise entre deux logiciels, et la clé est le mot de passe de la prise. API · PRISES ENTRE LOGICIELS Votre site clé d'API clé d'API clé d'API Paiement Stripe Carte Google Maps Courriel Infolettre Une API = une prise entre deux logiciels. La clé = le mot de passe de la prise.
Une API est une prise entre deux logiciels. La clé d'API est le mot de passe de la prise.

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
Deux tables reliées par un identifiant À gauche, la table « clients » avec les colonnes id, nom et ville et trois lignes : 12 Léa Joseph à Cayenne, 13 Marc Roy à Montréal, 14 Inès Petit à Lyon. À droite, la table « commandes » avec les colonnes id, client et produit : la commande 501 du client 12 pour un Atelier IA, la 502 du client 14 pour un Audit SEO, la 503 du client 12 pour un Site vitrine. Les commandes 501 et 503 sont reliées par des pointillés à la ligne de Léa Joseph, numéro 12. Des étiquettes montrent ce qu'est une table, une ligne, une colonne et un identifiant. DONNÉES · TABLES RELIÉES clients commandes idnomville 12Léa JosephCayenne 13Marc RoyMontréal 14Inès PetitLyon idclientproduit 50112Atelier IA 50214Audit SEO 50312Site vitrine colonne ligne identifiant table Le numéro 12 relie chaque commande à sa cliente.
Les tables sont reliées entre elles : une commande garde le numéro du client au lieu de recopier toutes ses informations.

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.

Les quatre verbes de base du langage SQL Quatre cartes : SELECT veut dire lire, INSERT ajouter, UPDATE modifier et DELETE supprimer. UPDATE et DELETE sont mis en garde : sans condition, ils touchent toutes les lignes. En bas, un exemple : SELECT nom FROM clients WHERE ville = 'Cayenne', qui se traduit par « Donne-moi le nom des clients de Cayenne ». DONNÉES · LES 4 VERBES SQL Select « lire » Insert « ajouter » Update « modifier » Delete « supprimer » Consulter sans rien changer Crée une nouvelle ligne Sans condition, touche toutes les lignes Sans condition, touche toutes les lignes EXEMPLE SELECT nom FROM clients WHERE ville = 'Cayenne'; « Donne-moi le nom des clients de Cayenne »
Quatre verbes suffisent pour comprendre presque toutes les requêtes.
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 UPDATE ou un DELETE sans 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.

L'arborescence d'un projet de site Le dossier mon-site contient six éléments : app, les pages ; components, les morceaux réutilisables ; public, les images et le logo ; package.json, la liste des ingrédients ; .env, les secrets, jamais partagé ; et CLAUDE.md, la mémoire du projet pour Claude. PROJET · LES DOSSIERS ET FICHIERS mon-site/ app/ components/ public/ package.json .env CLAUDE.md les pages les morceaux réutilisables images, logo la liste des ingrédients les secrets, jamais partagé la mémoire du projet pour Claude
Les dossiers et fichiers que vous croiserez dans presque tous les projets.

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.

L'historique Git d'un projet Une ligne du temps horizontale avec quatre commits, représentés par des carrés : « Page d'accueil », « Page Contact », « Formulaire » et « Couleurs ». Après « Page Contact », une branche secondaire part vers le bas pour le test du nouveau menu, puis revient sur la ligne principale au commit « Couleurs ». Une flèche courbe en pointillés revient du commit « Couleurs » vers « Formulaire » : on peut revenir en arrière si ça casse. Légende : un commit est un point de sauvegarde. GIT · L'HISTORIQUE DES VERSIONS Retour en arrière si ça casse le temps test du nouveau menu Page d'accueil Page Contact Formulaire Couleurs Un commit = un point de sauvegarde
Chaque commit est un point de sauvegarde. Une branche permet de tester sans toucher à la version principale.

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.

Les paquets npm expliqués avec la cuisine Une analogie de cuisine en trois cartes : le fichier package.json est la liste d'ingrédients, npm est l'épicerie, et les paquets sont les ingrédients tout prêts, par exemple next, react et tailwind. En bas, deux commandes : npm install pour faire les courses, et npm run dev pour goûter en local. OUTILS · LES PAQUETS NPM package.json la liste d'ingrédients npm l'épicerie Paquets les ingrédients tout prêts next react tailwind npm install « faire les courses » npm run dev « goûter en local »
npm install fait les courses, npm run dev vous laisse goûter en local.

6. Du projet sur votre ordinateur au site en ligne

Les quatre étapes de la mise en ligne d'un site Quatre étapes reliées par des flèches. Un : en local, vous travaillez avec Claude sur localhost:3000. Deux : GitHub, où le commit et le push sauvegardent l'historique. Trois : l'hébergeur lance le build, qui vérifie et assemble le site. Quatre : en ligne, sur votre-domaine.com, pour vos visiteurs et Google. Sous la ligne : si le build échoue, l'ancienne version reste en ligne. DÉPLOIEMENT · DU LOCAL AU WEB 1 2 3 4 En local GitHub Hébergeur En ligne vous + Claude commit + push l'historique sauvegardé build : vérifie et assemble vos visiteurs et Google localhost:3000 votre-domaine.com Si le build échoue, l'ancienne version reste en ligne.
Vous modifiez en local, vous envoyez sur GitHub, l'hébergeur publie automatiquement.

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.

Où ranger les clés secrètes d'un site Le fichier de code page.jsx contient seulement le nom de la clé, process.env.STRIPE_SECRET_KEY, pas sa valeur. La vraie valeur est rangée dans deux coffres : le fichier .env sur votre ordinateur, et les réglages de l'hébergeur pour le site en ligne. Une flèche barrée vers GitHub indique que le fichier .env n'est jamais envoyé. En bas : si une clé est publiée par erreur, changez-la chez le fournisseur. SÉCURITÉ · LES CLÉS SECRÈTES .env (local) sk_live_… page.jsx process.env.STRIPE_SECRET_KEY le nom de la clé, pas sa valeur Réglages de l'hébergeur (en ligne) sk_live_… GitHub le code partagé .env n'est jamais envoyé Clé publiée par erreur ? Changez-la chez le fournisseur.
Le code connaît le nom de la clé, jamais sa valeur.
  • en local, dans un fichier .env qui 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 .env et chez l'hébergeur.
  • Vérifiez que le fichier .gitignore contient 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 jamais faire confiance au navigateur Un formulaire dans le navigateur envoie un prix trafiqué de 1 $. Le serveur applique trois contrôles : un, vérifier le format ; deux, recalculer le prix ; trois, vérifier qui a le droit. Résultat : le prix réel de 280 $ est appliqué. Tout ce qui vient du navigateur peut être modifié. SÉCURITÉ · CÔTÉ SERVEUR Ne jamais faire confiance au navigateur Navigateur Formulaire prix : 1 $ trafiqué Payer Serveur 1 2 3 Vérifier le format Recalculer le prix Vérifier qui a le droit Résultat Prix réel : 280 $ Tout ce qui vient du navigateur peut être modifié.
Tout ce qui vient du navigateur peut être modifié. Le serveur revérifie tout.
  • 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

Les 3 étapes de Google : explorer, indexer, classer Trois blocs reliés par des flèches. 1, Explorer : le robot suit les liens, il a besoin de liens internes et d'un fichier sitemap.xml. 2, Indexer : il range les pages utiles, il faut un contenu original et un sujet par page. 3, Classer, mis en valeur : il choisit l'ordre selon l'utilité, l'expérience réelle et la vitesse sur mobile. En bas : une page bloquée à l'étape 1 ou 2 n'est jamais visible. SEO · LES 3 ÉTAPES DE GOOGLE 1 Explorer Le robot suit les liens Il faut : liens internes sitemap.xml 2 Indexer Range les pages utiles Il faut : contenu original un sujet par page 3 Classer Choisit l'ordre Selon : utilité expérience réelle vitesse mobile Bloquée à l'étape 1 ou 2 = jamais visible
Explorer, indexer, classer : si une page bloque à l'une des deux premières étapes, elle n'apparaîtra jamais.
  1. L'exploration : des robots (Googlebot) parcourent le web en suivant les liens et lisent vos pages.
  2. 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.
  3. 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

Anatomie d'un résultat dans Google Maquette simplifiée d'un résultat de recherche. En haut, l'adresse de la page, reliée à l'étiquette « adresse lisible ». Au milieu, le titre en gros, relié à « balise title, environ 60 caractères ». Dessous, la description, reliée à « meta description, environ 155 caractères, donne envie de cliquer ». En bas : ce que Google affiche, c'est vous qui l'écrivez. SEO · CE QUE GOOGLE AFFICHE plombier-cayenne.fr › tarifs Plombier à Cayenne | Dépannage Intervention rapide, devis gratuit. Appelez-nous dès maintenant. Adresse lisible des mots, pas des chiffres Balise title ~60 caractères Meta description ~155 caractères donne envie de cliquer Ce que Google affiche, c'est vous qui l'écrivez
Le titre et la description de votre résultat viennent de deux balises que vous contrôlez.

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 fichier robots.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 hiérarchie des titres d'une page Plan d'une page présenté comme un sommaire en retrait. Un seul titre H1 : « Plombier à Cayenne ». En dessous, un H2 « Nos services » qui contient deux H3, « Dépannage » et « Installation », puis deux autres H2, « Tarifs » et « Contact ». Les barres raccourcissent à chaque niveau. Note : un seul H1, puis H2 et H3 dans l'ordre, comme le plan d'un document. SEO · LE PLAN D'UNE PAGE H1 Plombier à Cayenne Un seul H2 Nos services H3 Dépannage H3 Installation H2 Tarifs H2 Contact Un seul H1, puis H2 et H3 dans l'ordre, comme le plan d'un document
Les titres d'une page se lisent comme le sommaire d'un document.

La vitesse : les Core Web Vitals

Google mesure l'expérience réelle de vos visiteurs avec trois indicateurs, les Core Web Vitals.

Les 3 signaux Core Web Vitals Trois barres horizontales. LCP : le contenu principal s'affiche, bon en moins de 2,5 secondes. INP : la page réagit au clic, bon en moins de 200 millisecondes. CLS : rien ne saute à l'écran, bon en moins de 0,1. Sur chaque barre, la zone « bon » est en noir, le reste en gris clair. Légende : mesuré sur de vrais visiteurs, surtout sur mobile. SEO · LA VITESSE MESURÉE PAR GOOGLE LCP Le contenu principal s'affiche Bon : moins de 2,5 s trop lent INP La page réagit au clic Bon : moins de 200 ms trop lent CLS Rien ne saute à l'écran Bon : moins de 0,1 trop instable Mesuré sur de vrais visiteurs, surtout sur mobile
Affichage, réactivité, stabilité : les trois mesures de l'expérience réelle.

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.

Hiérarchie visuelle : écran confus contre écran clair Deux maquettes d'écran côte à côte. À gauche, l'écran confus : cinq blocs de même taille et trois boutons identiques, tout crie et rien ne ressort. À droite, l'écran clair : un grand titre, une phrase, un seul bouton noir « Prendre rendez-vous » et beaucoup d'espace : un message, une action. DESIGN · GUIDER LE REGARD Cliquez Cliquez Cliquez Un titre clair Une phrase qui explique. Prendre rendez-vous Confus Tout crie, rien ne ressort Clair Un message, une action
Quand tout crie, rien ne ressort.

Les quatre autres principes

  1. 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).
  2. 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.
  3. 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é.
  4. 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é.
La règle des couleurs 60-30-10 Une barre découpée en trois parts : 60 % de couleur dominante pour le fond, en crème ; 30 % de couleur secondaire pour les blocs, en gris clair ; 10 % de couleur d'accent pour les actions, en noir. En dessous, une mini-maquette de page applique ces proportions : un fond crème, deux blocs gris clair et un seul bouton noir « Réserver ». DESIGN · LA RÈGLE 60-30-10 60 % 30 % 10 % Dominante le fond Secondaire les blocs Accent les actions La même règle sur une page Votre titre Bloc Bloc Réserver
L'accent, rare, attire l'œil vers ce qui compte : vos boutons d'action.

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.

Concevoir d'abord pour le téléphone À gauche, un ordinateur affiche une page avec trois colonnes côte à côte, numérotées 1, 2 et 3. Une flèche pointillée mène à un téléphone qui affiche la même page : les trois colonnes s'empilent les unes sous les autres. En bas : concevez d'abord pour le téléphone, c'est là que se trouve la majorité de vos visiteurs. DESIGN · MOBILE D'ABORD 1 2 3 Ordinateur même page 1 2 3 Téléphone Concevez d'abord pour le téléphone : la majorité de vos visiteurs
Sur téléphone, les colonnes s'empilent. Concevez d'abord pour ce format.

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 | bash
    

    Sur Windows, dans PowerShell :

    irm https://claude.ai/install.ps1 | iex
    

    Ouvrez ensuite un nouveau terminal et tapez claude --version : un numéro de version doit s'afficher.

  • Vous le lancez en tapant claude dans 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

Le cycle de travail avec Claude Code Une boucle de six étapes numérotées, reliées par des flèches. 1, Demander : une chose à la fois. 2, Plan : Claude propose. 3, Valider : vous décidez. 4, Coder : Claude écrit. 5, Tester : en local et sur mobile. 6, Commit : un point de sauvegarde, puis on revient à l'étape 1. Au centre : vous dirigez, Claude exécute. CLAUDE CODE · LA BOUCLE DE TRAVAIL 1 Demander une chose à la fois 2 Plan Claude propose 3 Valider vous décidez 4 Coder Claude écrit 5 Tester en local, sur mobile 6 Commit point de sauvegarde Vous dirigez, Claude exécute
Vous dirigez, Claude Code exécute. Chaque tour de boucle se termine par un point de sauvegarde.
  1. Demandez une petite chose à la fois. Une page, une section, une fonction. Pas « tout le site ».
  2. Faites planifier avant d'exécuter pour tout ce qui est un peu gros.
  3. Validez le plan, ou corrigez-le avant qu'une ligne de code soit écrite.
  4. Laissez Claude Code coder, en lisant ce qu'il vous demande d'autoriser.
  5. 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 ».
  6. 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.

Les 4 parties d'une bonne demande à Claude Une demande précise découpée en quatre blocs numérotés. 1, Contexte : ostéopathe à Gatineau, patients sportifs de 25 à 50 ans. 2, Objectif : une page d'accueil qui fait prendre rendez-vous. 3, Contraintes : fond crème, texte anthracite, pas de dégradés. 4, Critère de réussite : proposer la structure et attendre mon accord. À côté, une demande floue barrée : « Fais-moi une page d'accueil », qui oblige Claude à deviner. CLAUDE CODE · BIEN FORMULER SA DEMANDE 1 Contexte Ostéopathe à Gatineau, sportifs 25-50 ans 2 Objectif Page d'accueil qui fait prendre rendez-vous 3 Contraintes Fond crème, texte anthracite, pas de dégradés 4 Critère de réussite Proposer la structure et attendre mon accord Demande floue « Fais-moi une page d'accueil » Claude doit deviner Une demande précise = un résultat utile
Une demande précise donne un résultat utile. Une demande floue oblige Claude à deviner.
  1. Le contexte : qui vous êtes, à qui s'adresse le site, ce qui existe déjà.
  2. L'objectif : ce que la page ou la fonction doit permettre, en une phrase.
  3. Les contraintes : le style, ce qu'il ne faut pas faire, les contenus à utiliser.
  4. 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.

Le fichier CLAUDE.md, mémoire du projet Un fichier nommé CLAUDE.md contient cinq lignes : but du site, public visé, ton et couleurs, toujours en français, commit après chaque étape. Une flèche mène au bloc « Claude le lit à chaque session ». Légende : la mémoire du projet, écrite une fois, appliquée toujours. CLAUDE CODE · LA MÉMOIRE DU PROJET CLAUDE.md - But du site - Public visé - Ton et couleurs - Toujours en français - Commit après chaque étape Claude le lit à chaque session La mémoire du projet : écrite une fois, appliquée toujours
Écrit une fois, appliqué à chaque session.

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.md garde 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 --version affiche un numéro)
  • Visual Studio Code installé
  • Git installé (git --version affiche un numéro ; sur Mac, il est proposé à la première utilisation)
  • Node.js installé, version LTS (node --version affiche 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.
Gladston Aristoverne

Gladston Aristoverne

Fondateur de Kabatis, Développeur Web & Spécialiste SEO

Découvrir son parcours

Prêts à créer
ensemble ?ensemble ?

Configurez votre projet en moins de 3 minutes ou prenez un rendez-vous découverte. Réponse en 24 h.

Configurer mon projetNous contacter

Entreprise

  • Expertises
  • Réalisations
  • Qui sommes-nous ?
  • Blog
  • Contact

Contact

info@kabatis.com(514) 447-8567
Kabatis0 0 1 1 0 0 1 1 0 1 0 0 1 1 0 1 1 0 1 1 0 0 0 0 0 1 0 0 1 1 0 0 1 1 0 1 0 0 1 1 0 1 1 0 1 1 0 0 0 0 0 10 0 0 1 1 0 0 0 1 1 1 0 1 1 0 0 0 0 1 0 1 1 1 0 0 0 0 0 0 1 1 0 0 0 1 1 1 0 1 1 0 0 0 0 1 0 1 1 1 0 0 00 1 1 1 0 1 1 0 0 1 0 1 1 1 1 1 0 0 0 0 1 0 0 0 0 1 0 1 1 1 0 1 1 0 0 1 0 1 1 1 1 1 0 0 0 0 1 0 0 0 0 10 1 1 1 0 1 0 0 1 1 1 0 1 1 1 0 0 0 1 0 0 1 0 1 0 0 0 1 1 1 0 1 0 0 1 1 1 0 1 1 1 0 0 0 1 0 0 1 0 1 0 00 1 0 1 1 0 0 0 0 1 0 0 0 1 0 1 0 0 1 0 1 0 1 1 1 0 0 1 0 1 1 0 0 0 0 1 0 0 0 1 0 1 0 0 1 0 1 0 1 1 1 00 1 1 1 0 0 1 0 1 1 1 1 0 1 0 0 1 0 0 1 1 1 0 1 1 1 0 1 1 1 0 0 1 0 1 1 1 1 0 1 0 0 1 0 0 1 1 1 0 1 1 10 1 1 1 0 1 0 0 0 1 1 1 0 1 1 1 1 0 0 1 0 0 0 1 1 0 0 1 1 1 0 1 0 0 0 1 1 1 0 1 1 1 1 0 0 1 0 0 0 1 1 00 0 0 1 1 1 1 1 1 0 0 0 0 0 1 0 1 0 1 1 0 0 1 1 1 1 0 0 0 1 1 1 1 1 1 0 0 0 0 0 1 0 1 0 1 1 0 0 1 1 1 10 0 1 0 0 0 0 1 0 0 1 1 0 0 0 1 0 0 0 1 1 1 0 1 0 0 0 0 1 0 0 0 0 1 0 0 1 1 0 0 0 1 0 0 0 1 1 1 0 1 0 00 0 1 0 0 0 1 1 1 0 0 1 0 0 0 0 0 0 0 1 0 0 0 1 0 1 0 0 1 0 0 0 1 1 1 0 0 1 0 0 0 0 0 0 0 1 0 0 0 1 0 10 0 0 0 1 1 0 1 0 0 1 0 0 0 1 1 0 0 1 0 0 1 1 0 0 0 0 0 0 0 1 1 0 1 0 0 1 0 0 0 1 1 0 0 1 0 0 1 1 0 0 00 0 0 0 0 1 1 1 1 0 0 1 0 0 1 0 1 0 1 0 1 0 0 0 0 1 0 0 0 0 0 1 1 1 1 0 0 1 0 0 1 0 1 0 1 0 1 0 0 0 0 10 0 1 0 0 0 1 1 0 0 1 1 0 0 1 1 1 1 0 0 1 1 0 0 1 0 0 0 1 0 0 0 1 1 0 0 1 1 0 0 1 1 1 1 0 0 1 1 0 0 1 00 1 0 0 1 0 0 0 1 0 0 0 0 0 0 0 1 1 1 0 0 0 1 0 1 0 0 1 0 0 1 0 0 0 1 0 0 0 0 0 0 0 1 1 1 0 0 0 1 0 1 00 1 0 0 0 1 1 0 0 0 1 0 0 0 0 1 0 1 1 1 1 1 0 0 1 1 0 1 0 0 0 1 1 0 0 0 1 0 0 0 0 1 0 1 1 1 1 1 0 0 1 10 1 1 0 0 1 0 0 1 1 0 1 0 0 1 1 0 1 0 1 1 1 0 0 1 0 0 1 1 0 0 1 0 0 1 1 0 1 0 0 1 1 0 1 0 1 1 1 0 0 1 00 1 0 0 1 0 1 0 0 1 1 0 0 0 1 0 0 1 0 1 0 0 1 0 0 1 0 1 0 0 1 0 1 0 0 1 1 0 0 0 1 0 0 1 0 1 0 0 1 0 0 10 1 0 0 0 0 0 0 1 1 1 0 0 0 0 1 0 1 1 1 1 1 0 1 0 0 0 1 0 0 0 0 0 0 1 1 1 0 0 0 0 1 0 1 1 1 1 1 0 1 0 00 0 1 0 0 1 1 0 0 1 0 1 0 1 0 0 1 1 0 0 1 0 0 1 0 1 0 0 1 0 0 1 1 0 0 1 0 1 0 1 0 0 1 1 0 0 1 0 0 1 0 10 0 1 0 1 1 1 1 1 1 1 0 0 1 1 1 1 1 0 0 0 1 1 1 0 0 0 0 1 0 1 1 1 1 1 1 1 0 0 1 1 1 1 1 0 0 0 1 1 1 0 00 0 0 0 0 0 0 1 0 1 0 0 0 1 1 0 1 1 1 0 0 0 0 1 0 1 0 0 0 0 0 0 0 1 0 1 0 0 0 1 1 0 1 1 1 0 0 0 0 1 0 10 0 1 0 0 0 1 1 1 1 1 1 0 1 0 1 0 1 1 0 1 1 0 1 1 1 0 0 1 0 0 0 1 1 1 1 1 1 0 1 0 1 0 1 1 0 1 1 0 1 1 10 0 1 1 1 1 0 1 0 1 0 0 0 1 0 0 0 1 0 0 0 0 1 1 1 0 0 0 1 1 1 1 0 1 0 1 0 0 0 1 0 0 0 1 0 0 0 0 1 1 1 00 0 0 1 0 1 1 1 1 1 1 0 0 1 0 1 0 1 1 1 0 0 0 1 1 1 0 0 0 1 0 1 1 1 1 1 1 0 0 1 0 1 0 1 1 1 0 0 0 1 1 10 1 1 1 0 0 0 1 0 0 0 1 0 1 1 0 1 1 1 1 1 1 0 0 1 0 0 1 1 1 0 0 0 1 0 0 0 1 0 1 1 0 1 1 1 1 1 1 0 0 1 00 1 1 1 1 0 1 0 1 0 1 1 0 1 1 1 1 1 0 1 0 0 1 0 0 1 0 1 1 1 1 0 1 0 1 0 1 1 0 1 1 1 1 1 0 1 0 0 1 0 0 10 1 0 1 0 1 1 0 0 0 0 0 1 1 0 0 1 1 0 1 0 1 0 0 0 0 0 1 0 1 0 1 1 0 0 0 0 0 1 1 0 0 1 1 0 1 0 1 0 0 0 00 1 1 1 0 1 0 0 1 0 1 1 1 1 0 1 1 1 1 0 1 0 0 0 0 1 0 1 1 1 0 1 0 0 1 0 1 1 1 1 0 1 1 1 1 0 1 0 0 0 0 10 1 1 1 1 0 1 0 0 0 1 1 1 0 1 0 0 1 0 0 1 1 1 0 0 0 0 1 1 1 1 0 1 0 0 0 1 1 1 0 1 0 0 1 0 0 1 1 1 0 0 00 1 0 1 0 0 0 0 1 0 0 0 1 0 1 0 0 1 0 0 0 0 1 0 1 1 0 1 0 1 0 0 0 0 1 0 0 0 1 0 1 0 0 1 0 0 0 0 1 0 1 10 0 0 1 0 1 1 0 0 0 1 1 1 0 0 1 0 1 1 0 1 1 0 0 1 1 0 0 0 1 0 1 1 0 0 0 1 1 1 0 0 1 0 1 1 0 1 1 0 0 1 10 0 1 1 1 1 0 1 1 0 0 1 1 0 0 0 1 1 1 0 1 1 1 1 1 0 0 0 1 1 1 1 0 1 1 0 0 1 1 0 0 0 1 1 1 0 1 1 1 1 1 00 0 0 1 0 0 1 1 0 0 1 0 1 0 1 1 1 1 0 1 0 0 1 1 1 1 0 0 0 1 0 0 1 1 0 0 1 0 1 0 1 1 1 1 0 1 0 0 1 1 1 10 0 0 1 0 0 1 1 1 1 0 0 1 0 1 0 1 1 1 1 0 1 0 1 0 0 0 0 0 1 0 0 1 1 1 1 0 0 1 0 1 0 1 1 1 1 0 1 0 1 0 00 0 1 1 1 1 0 1 0 1 1 1 1 0 1 1 0 1 1 1 1 0 1 1 0 1 0 0 1 1 1 1 0 1 0 1 1 1 1 0 1 1 0 1 1 1 1 0 1 1 0 10 1 0 0 0 1 1 1 1 1 0 0 1 0 0 0 0 1 0 1 0 1 1 1 0 0 0 1 0 0 0 1 1 1 1 1 0 0 1 0 0 0 0 1 0 1 0 1 1 1 0 0

© 2019 – 2026 Kabatis

·
  • Confidentialité
  • ·Plan du site
  • ·fr.kabatis.com
LinkedIn·Facebook·Instagram