Tout ce qui suit s'applique dans un projet web existant (React / Next.js) ou dans une app que tu fais générer de zéro par Claude Code.
D'abord, ce que ça ne fait pas
Autant le dire tout de suite, ça t'évitera deux heures perdues :
- Claude Code ne sculpte pas un modèle organique. Il ne te fera pas un personnage ni une voiture détaillée.
- Ce qu'il fait très bien, c'est du 3D codé : formes géométriques, matériaux, lumières, animations, caméras. C'est 90% de ce dont tu as besoin sur une landing ou un portail client.
- Si tu veux un objet complexe, tu ne le génères pas : tu importes un fichier
.glbexistant et tu demandes à Claude de l'intégrer et de l'animer. Lui, il fait la mise en scène.
Donc : il ne remplace pas Blender. Il remplace les trois semaines de dev entre le fichier et la page en ligne.
Étape 1 — Installer la 3D dans ton app
La 3D dans le navigateur passe par Three.js. Dans un projet React, on l'utilise via React Three Fiber, et drei par-dessus pour les helpers (caméra, contrôles, environnement).
Tu n'installes rien à la main. Tu ouvres Claude Code à la racine de ton projet et tu lui donnes le prompt d'installation (dans le fichier joint).
Ce qu'il doit faire, et que tu vérifies :
- installer
three,@react-three/fiber,@react-three/drei - créer un composant
Sceneisolé, dans son propre fichier - le charger en dynamique côté client (en Next.js, la 3D ne doit pas être rendue côté serveur)
- te laisser un
<Scene />que tu peux coller n'importe où
Si ta page blanchit à ce stade, c'est presque toujours le rendu serveur. Dis-le lui tel quel, il corrige.
Étape 2 — Ton premier objet en un prompt
Ne demande pas « fais-moi un bel objet 3D ». Tu vas récupérer un cube gris.
Décris quatre choses, toujours les mêmes :
- La forme : sphère, tore, plan ondulé, grille de cubes, forme organique type blob.
- La matière : mate, métallique, verre, translucide, iridescente.
- La lumière : d'où elle vient, quelle couleur, s'il y a un reflet d'environnement.
- Le mouvement par défaut : rotation lente, respiration, flottement.
Le prompt complet est dans le fichier joint. Change les quatre variables, relance, tu as une autre direction artistique en trente secondes. C'est là que tu itères, pas après.
Étape 3 — Le mettre en hero de ta landing
Trois règles pour que ça ait l'air pro et pas « démo de dev » :
- L'objet ne doit JAMAIS passer devant ton texte. Le canvas est en fond, ton titre et ton bouton sont au-dessus, en z-index supérieur.
- Le fond du canvas est transparent, pas noir. Sinon tu te retrouves avec une boîte noire collée au milieu de ta page.
- L'objet occupe un côté, pas le centre. Texte à gauche, objet à droite, ou l'inverse. Un objet centré derrière un titre, c'est illisible.
Tu peux donner ces trois contraintes à Claude dans le même prompt, il les applique directement.
Étape 4 — Le faire réagir au scroll et à la souris
C'est le détail qui fait qu'on reste sur la page au lieu de passer.
Deux comportements à demander, séparément :
- Souris : l'objet suit légèrement le curseur. Légèrement. Si ça bouge beaucoup, ça fait cheap. Demande explicitement un amortissement et une amplitude faible.
- Scroll : l'objet tourne, se déplace ou change de couleur au fur et à mesure que tu descends. Utile pour accompagner une section « comment ça marche » en trois étapes.
Demande-les l'un après l'autre et teste entre les deux. Si tu demandes les deux d'un coup et que ça part en vrille, tu ne sauras pas lequel est en cause.
Étape 5 — Le réutiliser dans un portail client
C'est là que ça devient rentable. La scène que tu viens de faire est un composant isolé : tu la réutilises telle quelle.
Les usages qui tiennent la route :
- Un objet en fond de l'écran de connexion du portail.
- Une forme qui change de couleur selon l'état d'un projet (en cours, en attente de validation, livré).
- Un header de dashboard client, discret, qui tourne lentement.
- La même scène exportée en image fixe pour la couverture de tes propales et de tes slides, histoire que tout ait la même tête.
Pour le dernier point, demande à Claude un bouton temporaire qui exporte le canvas en PNG. Tu prends tes images, tu supprimes le bouton.
Ce qui plombe une page, et que personne ne vérifie
- Le mobile. La 3D tourne, mais elle chauffe le téléphone et vide la batterie. Demande systématiquement une version dégradée sur petit écran, voire une image fixe à la place.
- Le
dpr. Si tu ne le limites pas, un écran Retina rend la scène en résolution monstrueuse pour rien. Demande à Claude de le borner. - Le poids des modèles importés. Un
.glbnon compressé pèse plus lourd que toute ta page. Si tu importes un fichier, demande la compression. - L'animation qui tourne hors écran. Demande que la scène se mette en pause quand elle n'est pas visible.
Ces quatre points, tu peux les donner d'un bloc à Claude Code comme contraintes permanentes du projet. Il les applique à chaque nouvelle scène.
L'ordre dans lequel tu fais les choses
- Installation et composant isolé.
- Un objet moche mais qui s'affiche.
- Tu itères sur la direction artistique (forme, matière, lumière).
- Tu le poses dans la page, derrière le texte.
- Tu ajoutes la souris.
- Tu ajoutes le scroll.
- Tu passes les contraintes de perf.
Ne saute pas l'étape 2. Avoir un cube gris qui tourne à l'écran te dit que toute la chaîne fonctionne. Tout ce qui vient après, c'est du goût.












