TP1re année8 livrables
Coder avec l'IA : Claude & Artifacts
Aujourd'hui tu construis un vrai portfolio en ligne, en dialoguant avec Claude — et tu repars avec un lien à montrer. Pas de théorie : tu copies des prompts, tu regardes la page se construire, tu ajustes, tu publies.
Par Josselyn C., prof de BTS SIO. Publié le , mis à jour le .
- Ce que tu auras à la fin
- un portfolio (4 sections, cartes projets, responsive) publié, avec son lien
- On manipule
- `claude.ai` (compte gratuit) dans ton navigateur — rien à installer
- Pré-requis
- avoir vu HTML & CSS. C'est tout.
- Pour qui
- SLAM et SISR, 1re année
- Durée
- environ 3 h
Compétences : C1.6 Organiser son développement professionnel, C2.1 Concevoir et développer une solution applicative
Tu restes le pilote : tu relis et tu comprends ce que Claude produit — tu devras l'expliquer à l'oral.
Mode d'emploi (lis ça, 30 secondes)
| Règle | Concrètement |
|---|---|
| Avance dans l'ordre | chaque chapitre = une action sur ta page. Tu fais, tu ne lis pas que. |
| Copie les prompts | les blocs gris foncé sont des prompts à coller dans Claude (adapte le texte entre crochets […]). |
| Garde un journal | un fichier texte à côté : colles-y tes prompts + le lien final. Les Flags te les redemandent. |
| Bloqué ? | chapitre « Quand ça coince » (message exact → correctif). Un mot inconnu → glossaire final. |
0. Démarrer (2 minutes)
Étape 1 — Ouvre Claude
Dans ton navigateur : va sur claude.ai, crée un compte gratuit avec ton mail. Tu arrives sur une page avec un grand champ de saisie en bas.
Étape 2 — Colle ce premier prompt
Crée une page web complète (un seul fichier HTML avec le CSS
à l'intérieur) que je puisse prévisualiser : un portfolio
d'étudiant en BTS SIO SLAM. En-tête avec le nom "[TON NOM]"
et "BTS SIO SLAM". Style sobre et moderne. Commente le CSS.
Étape 3 — Regarde à droite
Après quelques secondes, une page web s'affiche dans un panneau à droite : c'est ton Artifact. En haut de ce panneau, deux onglets :
| Onglet | Ce que tu y vois | Tu l'utilises pour… |
|---|---|---|
| Aperçu (Preview) | la page telle qu'on la verra | vérifier le rendu |
| Code | le HTML/CSS généré | relire / comprendre (ch. 4) |
Il y a aussi un bouton plein écran (pour voir grand) et, en haut, un bouton Publier (on y vient au ch. 7).
Flag B1
Démarrage
Obtiens ta première page en Artifact. Rends : le prompt exact utilisé + une phrase décrivant ce qui s'affiche dans l'aperçu.
1. Les 3 gestes de base
Tout le TP tient sur 3 gestes. Fais-les tout de suite sur ta page.
Geste 1 — Modifier : tu le dis, ça change
Tu ne touches pas au code toi-même : tu décris le changement. Colle :
Change le fond de l'en-tête en gris très foncé (#1b2a4a)
et le texte en blanc.
L'aperçu se met à jour tout seul : l'en-tête devient
gris foncé, le texte passe en blanc.
Geste 2 — Revenir en arrière : les versions
Chaque modification crée une version. En haut de l'Artifact, des flèches permettent de parcourir les versions et de revenir à l'une d'elles. Tu peux aussi le demander :
reviens à la version précédente de la page
Geste 3 — Publier : un lien public
Quand la page te plaît, clique sur Publier (haut de l'Artifact) → Claude te donne une adresse (URL) publique que tu peux ouvrir et partager. On s'en sert pour de vrai au chapitre 7.
Flag C1
Les 3 gestes
Fais un changement, reviens en arrière, puis refais-le. Rends : le changement testé + comment tu es revenu à la version d'avant (flèches ou phrase) + comment tu as vérifié.
2. Le prompt qui marche
Un prompt vague = un résultat vague et 10 allers-retours. Un prompt précis = bon du premier coup. La différence, sur de vrais exemples portfolio :
| Vague (à éviter) | Précis (à viser) |
|---|---|
| « améliore ma page » | « ajoute sous l'en-tête une barre de navigation avec 4 liens : Accueil, À propos, Compétences, Projets » |
| « mets des couleurs » | « couleur principale en bleu nuit #1b2a4a pour les titres et la nav, texte en #222 » |
| « fais une belle section projets » | « dans la section Projets, 3 cartes côte à côte, chacune : un titre, une phrase, une ligne "compétences" » |
Le test « 1 humain »
Avant d'envoyer : « Si je donnais cette phrase à quelqu'un qui ne connaît pas mon projet, saurait-il quoi faire sans me reposer de question ? » Si non → il manque le Où, le Quoi ou le Comment.
Atelier (2 min) — répare ces 3 prompts
| Prompt vague | Ce qui manque |
|---|---|
| « rends ça plus joli » | le Quoi : changer quoi exactement ? |
| « ajoute une image » | où ? laquelle ? quelle taille / quel texte alternatif ? |
| « corrige le bug » | quel bug, sur quelle section, tu vois quoi vs tu veux quoi ? |
Flag B2
Prompts
Réécris les 3 prompts vagues en versions précises (Où + Quoi + Comment). Rends : tes 3 réécritures.
3. Construis ton portfolio (le build)
Le cœur de la séance. Tu enchaînes les prompts ci-dessous sur la même page, un par un, dans l'ordre. Après chaque prompt : regarde l'aperçu, puis passe au suivant. Adapte les […] à toi.
Prompt 1 — La structure
Structure la page en 4 sections avec les id : accueil,
apropos, competences, projets. Donne un titre (h2) à
chacune. Ajoute une barre de navigation collée en haut
avec 4 liens qui mènent vers ces sections. Ne supprime
pas le contenu déjà présent.
Aperçu : une barre de nav en haut + 4 sections titrées.
Cliquer un lien fait défiler vers la bonne section.
Prompt 2 — À propos
Dans la section À propos, écris un court texte (3 lignes) :
étudiant en BTS SIO SLAM à [TON ÉCOLE], j'aime [CE QUE TU AIMES],
objectif : [TON OBJECTIF]. Ajoute dessous un bouton
"Télécharger mon CV" (href="#" pour l'instant).
Prompt 3 — Compétences
Dans la section Compétences, fais une liste de 5 compétences
en cours : HTML, CSS, le terminal, créer une machine
virtuelle, travailler avec une IA.
Prompt 4 — Les cartes projets
Dans la section Projets, crée 3 cartes. Chaque carte :
un titre, une phrase de description, et une ligne
"Compétences : …".
Carte 1 : "Ma première page web" (HTML/CSS).
Carte 2 : "[UN AUTRE TP que tu as fait]".
Carte 3 : "Portfolio avec une IA" (ce TP).
Aperçu : 3 cartes… mais empilées les unes sous les autres.
On corrige au prompt suivant.
Prompt 5 — Mettre les cartes en grille
Mets les 3 cartes côte à côte en grille de 3 colonnes
égales, avec un espace de 16px entre elles.
Prompt 6 — Styliser les cartes
Donne aux cartes : fond blanc, une bordure fine gris clair,
coins arrondis, un peu de padding, et une légère ombre.
Au survol, la carte se soulève un peu.
Prompt 7 — Ta couleur
Change la couleur principale (titres, nav, bouton CV) en
[TA COULEUR, ex: #1b2a4a bleu nuit]. Garde un texte bien
lisible (contraste suffisant).
Prompt 8 — La version mobile
Sur écran mobile (largeur inférieure à 600px), passe les
3 cartes sur une seule colonne et réduis un peu la taille
des grands titres.
Claude ajoute une "media query" @media (max-width:600px).
Pour la tester : ouvre l'aperçu en grand → F12 → icône
téléphone → choisis "iPhone SE". Les cartes s'empilent.
Flag B3
Ton portfolio de base
Enchaîne les prompts 1 à 8 sur ta page. Rends : la liste de tes 4 sections, le contenu de tes 3 cartes, ta couleur choisie, et confirme que la version mobile marche (cartes sur 1 colonne).
4. Lire & comprendre le code
Ouvre l'onglet Code de ton Artifact. Tu dois pouvoir lire ce que Claude a écrit — sinon tu ne pourras pas le défendre. Entraîne-toi sur un vrai bout : le bouton CV du prompt 2.
<a href="#" class="btn-cv">Télécharger mon CV</a>
.btn-cv {
display: inline-block;
background-color: #1b2a4a;
color: #ffffff;
padding: 10px 24px;
border-radius: 6px;
text-decoration: none;
transition: background-color 0.2s ease;
}
.btn-cv:hover { background-color: #2c3f66; }
Flag B4
Tu lis ton code
Dans l'onglet Code, repère le CSS d'une de tes cartes (ou du bouton CV). Rends : le bloc + une explication avec TES mots de 3 propriétés.
5. Quand ça coince
Les blocages réels du jour, et le correctif exact. Repère ton cas, applique, continue.
| Ce que tu constates | Pourquoi | Ce que tu fais |
|---|---|---|
| Pas d'Artifact, juste du texte | la demande n'était pas « une page web » | « mets ça dans une page web complète que je puisse prévisualiser » |
| Une section a disparu / été réécrite | Claude a « réécrit » au lieu d'« ajouter » | reviens à la version d'avant, ou « remets mon contenu, ajoute seulement ce que j'ai demandé » |
| Page blanche / tout décalé | une balise ou une accolade oubliée | reviens à la version précédente, puis redemande le changement en plus petit |
Du !important dans le CSS | solution de facilité de l'IA | « n'utilise pas !important, corrige proprement avec un sélecteur plus précis » |
| « Limite de messages atteinte » | plan gratuit (quota par quelques heures) | regroupe tes demandes, reste sur UN Artifact ; sinon continue à la main |
| L'effet demandé n'apparaît pas | Claude a peut-être inventé (hallucination, ch. 6) | vérifie sur MDN, ou « cette propriété existe-t-elle vraiment ? » |
Flag C2
Un blocage résolu
Pendant le TP, tu rencontreras au moins un de ces cas. Rends : lequel, et le message exact que tu as envoyé pour t'en sortir.
6. Teste pour de vrai
« Ça a l'air bon » ≠ « ça marche ». Trois vérifs rapides, à chaque étape importante.
- L'aperçu : l'effet demandé est là, et le reste de la page n'a pas bougé ?
- Le mobile : aperçu en grand →
F12→ icône téléphone → « iPhone SE » (375px). Rien ne déborde ? - Les liens de nav : cliquer « Projets » emmène bien à la section Projets ?
Repérer une « hallucination »
L'IA peut inventer une propriété qui n'existe pas (ex. rounded-corners au lieu de border-radius). Le navigateur l'ignore en silence → l'effet n'apparaît pas, sans message d'erreur.
Bien signaler un bug (sinon Claude corrige mal)
| Faible | Fort |
|---|---|
| « ça marche pas » | « la section Projets ne s'affiche plus du tout ; les autres sont là » |
| « c'est moche » | « sur mobile, les 3 cartes se chevauchent et le texte dépasse » |
Règle : ce que tu vois vs ce que tu attendais, et où.
Flag C3
Vérification
Teste ta page (aperçu + mobile + liens). Rends : un problème trouvé + le message précis envoyé pour le corriger — ou « tout OK » avec la preuve (ce que tu as vérifié).
7. Publier & livrer
Publier
En haut de l'Artifact → Publier → tu obtiens une URL publique. Ouvre-la dans un nouvel onglet pour vérifier qu'elle marche. C'est le lien que tu montreras.
Récupérer le fichier
Dans le menu de l'Artifact → Télécharger le .html. Garde-le : à la prochaine séance (Git & GitHub), tu l'hébergeras sous ta propre adresse.
Flag B5
Livraison
Publie ton portfolio. Rends : l'URL publique + une capture de l'aperçu + 2 prompts clés que tu as utilisés.
Défis bonus (si tu as fini)
A — ajoute une section « Veille » avec 2 liens tech que tu suis.
B — demande à Claude 2 palettes de couleurs différentes, choisis-en une (et dis pourquoi).
C — fais-toi expliquer un terme CSS que tu ne connaissais pas, puis réutilise-le.
8. 3 règles (non négociables)
Pour finir
Antisèche — les réflexes
| Réflexe | Pourquoi |
|---|---|
| Demander « une page web » explicitement | pour obtenir un Artifact, pas du texte |
| Coller sa page / ses vrais textes | Claude ne voit que ce que tu lui donnes |
| Prompt précis : Où + Quoi + Comment | bon du premier coup, moins d'allers-retours |
| Lire l'onglet Code avant de garder | tu dois pouvoir l'expliquer |
| Revenir à une version si ça casse | rien n'est perdu |
| Tester l'aperçu + le mobile (F12) | « ça marche » ≠ « ça a l'air bon » |
| Avancer par petits pas (1 prompt = 1 vérif) | tu sais ce qui a cassé |
| « explique-moi » dès qu'un truc t'échappe | apprendre, pas copier |
| Jamais de secret / donnée réelle collés | tout part sur les serveurs |
Vérifie tes acquis
- Quelle phrase déclenche la création d'un Artifact plutôt qu'une réponse texte ?
- Tu as supprimé une section par erreur via un prompt : les 2 façons de la récupérer ?
- Les 3 ingrédients d'un bon prompt ?
- Où lis-tu le code généré, et pourquoi dois-tu le lire ?
- Comment tester la version mobile sans smartphone ?
- Une propriété CSS ne fait rien : comment vérifier si elle existe ?
- Cite 3 choses à ne jamais coller dans le chat.
- Comment obtiens-tu un lien public de ton portfolio ?
Corrigé du quiz
| Q. | Réponse |
|---|---|
| 1 | Demander une « page web complète que je puisse prévisualiser » (HTML + CSS dans un seul fichier). |
| 2 | Revenir à la version précédente (flèches en haut de l'Artifact) ; ou demander « reviens à la version d'avant / remets mon contenu ». |
| 3 | Où (quelle section) + Quoi (l'action) + Comment (les contraintes). |
| 4 | Dans l'onglet Code de l'Artifact. Parce que tu es responsable de ton code et devras l'expliquer à l'E6. |
| 5 | Aperçu en grand → F12 → icône téléphone → « iPhone SE » (375px). |
| 6 | Chercher mdn [propriété] : page officielle = réelle ; pas de page = inventée (hallucination). |
| 7 | Mot de passe · clé API · données personnelles réelles. |
| 8 | Bouton Publier en haut de l'Artifact → une URL publique. |
Glossaire
| Mot | Définition |
|---|---|
| Claude | l'assistant IA utilisé ici, dans le navigateur (claude.ai, gratuit) |
| Artifact | la page web vivante que Claude construit à droite ; onglets Aperçu / Code |
| Prompt | la demande que tu écris à Claude |
| Aperçu / Code | les 2 onglets de l'Artifact : le rendu / le HTML-CSS |
| Version | un état sauvegardé de la page ; on peut y revenir |
| Publier | générer l'URL publique de ta page |
| Media query | règle CSS @media qui adapte la page selon la largeur d'écran (responsive) |
| Hallucination | quand l'IA invente quelque chose de faux (ex. une propriété CSS qui n'existe pas) |