Guide gratuit6 min de lecture

Mettre de la 3D dans tes apps avec Claude Code

Les prompts exacts pour passer d'une page plate à une page qui bouge, sans motion designer.

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 .glb existant 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 Scene isolé, 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 :

  1. La forme : sphère, tore, plan ondulé, grille de cubes, forme organique type blob.
  2. La matière : mate, métallique, verre, translucide, iridescente.
  3. La lumière : d'où elle vient, quelle couleur, s'il y a un reflet d'environnement.
  4. 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 .glb non 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

  1. Installation et composant isolé.
  2. Un objet moche mais qui s'affiche.
  3. Tu itères sur la direction artistique (forme, matière, lumière).
  4. Tu le poses dans la page, derrière le texte.
  5. Tu ajoutes la souris.
  6. Tu ajoutes le scroll.
  7. 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.

Vous préférez qu'on le fasse pour vous ?

On le met en place dans votre boîte

30 minutes de call. On regarde vos outils et vos process, et on vous dit ce qu'on peut livrer en 7 jours.

Réserver un appel

Prêt à passer à l'action ?

30 minutes de call. On regarde votre stack, vos pain points, on vous dit ce qu'on peut livrer en 7 jours.

Avant

Treize outils. Aucun ne se parle.