# Vibecoder avec Claude Code : le guide complet

> Construire un outil interne ou une maquette avec Claude Code sans savoir coder : installation, prompt d’amorçage, coûts réels, sécurité puis passation.

Adresse : https://www.pilote-expertise.fr/guides/vibecoder-avec-claude-code/
Auteur : Rémi Doyen, pour l'équipe Pilote Expertise. Mise à jour : 2026-11-12.

Le vibecoding, c'est construire un logiciel en le décrivant en français à une IA, qui écrit et exécute le code à votre place. Installation, réglages, méga-prompt à copier, coûts réels et pièges à éviter : tout ce qu'il faut pour construire votre premier outil interne en une soirée, même sans une ligne de code.

Depuis deux ans, une promesse revient partout : « décrivez votre idée à une IA, elle code l'application ». Le mot qui va avec, c'est **vibecoding** : coder en discutant, en français, sans écrire une ligne de code soi-même.

Disons-le tout de suite : cela ne remplacera pas votre éditeur de logiciel et cela ne vous rendra pas riche. Les vidéos qui promettent « une app à 10 000 € par mois en un week-end » vendent du rêve. En revanche, pour **deux usages très précis** (la maquette qu'on montre au lieu de l'expliquer et le petit outil interne qui remplace un fichier Excel bricolé), c'est devenu redoutablement efficace.

Ce guide est le mode d'emploi que nous aurions aimé avoir. Il est écrit pour quelqu'un qui n'a jamais codé. Vous y trouverez l'installation écran par écran, le prompt d'amorçage que nous utilisons réellement, ce que ça coûte, ce qu'il ne faut surtout pas y mettre et à quel moment il faut passer la main à un vrai développeur.

## Ce que vous saurez faire

- Comprendre ce que le vibecoding sait faire et ce qu'il ne sait pas faire
- Installer et régler Claude Code de zéro, même sans expérience technique
- Lancer votre première session avec un prompt d'amorçage éprouvé
- Obtenir un résultat présentable, pas une maquette qui pique les yeux
- Maîtriser la facture et savoir où passe votre consommation
- Savoir quelles données ne doivent jamais entrer dans ce type de projet
- Préparer une passation propre à un développeur le jour où le projet grandit

- Un ordinateur Windows, macOS ou Linux
- Un abonnement Claude payant (Pro suffit pour démarrer)
- Sur Windows : Git installé, on voit comment plus bas
- Environ 40 minutes devant vous pour la première session
- Aucune connaissance en programmation

## Le vibecoding, c'est quoi exactement

*Et surtout : ce que ce n'est pas.*

Le vibecoding, c'est construire un logiciel en le décrivant en français à une IA, qui écrit et exécute le code à votre place. Vous ne lisez pas le code. Vous ne le comprenez pas. Vous regardez le résultat, vous dites ce qui ne va pas et vous recommencez jusqu'à ce que ça marche.

Le terme a été popularisé par Andrej Karpathy début 2025, dans un sens assez littéral : on se laisse porter par l'ambiance, on accepte le code sans le relire, on itère au clavier. C'est une méthode de *prototypage*, pas une méthode de production.

La confusion vient de là. Beaucoup de gens entendent « je peux créer un logiciel » et comprennent « je peux créer une entreprise de logiciel ». Ce sont deux choses très différentes. Écrire le code n'a jamais été la partie difficile : la partie difficile, c'est la sécurité, la fiabilité quand mille personnes s'en servent en même temps, la conformité, la maintenance sur cinq ans et le service client à 2 h du matin.

Le vibecoding ne vous transforme pas en développeur. Il vous transforme en **commanditaire capable de produire lui-même sa première version**. C'est déjà énorme : vous arrêtez d'attendre un devis pour tester une idée.

Pourquoi Claude Code plutôt qu'un autre outil ? Parce qu'il travaille directement dans un dossier de votre ordinateur, comme le ferait un développeur : il crée les fichiers, les modifie, lance l'application, lit les messages d'erreur et se corrige tout seul. Les générateurs de sites qui produisent un joli écran mais rien derrière plafonnent très vite. Ici, vous avez un vrai projet, que vous pourrez confier à quelqu'un plus tard.

## Les deux seuls usages qui valent vraiment le coup

*Tout le reste, c'est de la productivité de façade.*

Au fil des projets construits de cette façon, nous avons arrêté de chercher : deux cas d'usage donnent des résultats systématiquement bons et les autres finissent au fond d'un dossier.

Un responsable qualité passait deux heures par semaine à compiler les fiches de non-conformité de trois ateliers dans un tableau croisé dynamique. Trois soirées de vibecoding plus tard : un formulaire de saisie sur tablette au poste, un tableau de bord qui se met à jour tout seul, un export mensuel. Deux heures par semaine récupérées et surtout des données saisies une seule fois.

À l'inverse, si votre idée est « une application de réservation pour tous les coiffeurs de France », ce n'est pas du vibecoding qu'il vous faut, c'est une équipe et un financement. Le prototype vous servira à convaincre : il ne servira pas de produit.

## Ce qu'il vous faut avant de commencer

Réunissez ces quatre éléments avant d'ouvrir quoi que ce soit : la première session se passe beaucoup mieux quand on ne s'interrompt pas au milieu pour installer un outil manquant.

Tout ce qui se trouve dans le dossier choisi est lisible par Claude et donc transmis à ses serveurs quand la tâche l'exige. Un dossier dédié et vide au départ, c'est la garantie que rien d'autre ne part. On y revient en détail dans la section [Données et sécurité](#données-et-sécurité--les-règles-non-négociables).

## Installer et régler Claude Code, écran par écran

*Comptez dix minutes, une seule fois.*

Claude Code existe sous plusieurs formes : en ligne de commande dans un terminal, dans un éditeur de code, sur le web et dans **l'application de bureau Claude**. C'est cette dernière que nous recommandons sans hésiter à quelqu'un qui débute : tout est graphique, il n'y a pas de terminal à apprivoiser et vous voyez les modifications de fichiers dans une vue comparative avant de les accepter.

![Page de téléchargement de Claude : versions macOS, Windows, Linux et mobile](https://www.pilote-expertise.fr/images/guides/vibecoder-avec-claude-code/00-telecharger-claude.webp)
*La page claude.com/download. Le bouton du haut détecte votre système tout seul.*

- Le gros bouton propose directement la version correspondant à votre machine
- Plus bas, la liste complète : macOS, Windows, Windows ARM, Linux
- L'application mobile ne donne pas accès à Claude Code : il vous faut la version bureau

![Interface de Claude Code : zone de saisie, sélecteur d'environnement, mode d'autorisation et sélecteur de modèle](https://www.pilote-expertise.fr/images/guides/vibecoder-avec-claude-code/01-session-claude-code.webp)
*L'écran de départ d'une session Claude Code. Tout se joue dans la barre du bas. (Capture prise sur la version web, dont l'interface est identique à celle de l'application de bureau, à un détail près signalé ci-dessous.)*

- En haut de la barre : l'environnement et le projet. La version web travaille sur un dépôt de code ; l'application de bureau propose à la place « Sélectionner un dossier », qui ouvre l'explorateur de fichiers de votre ordinateur
- Au centre : la zone où vous écrivez, en français, ce que vous voulez
- En bas à gauche : le mode d'autorisation en cours
- En bas à droite : le modèle et son niveau de réflexion

![Menu des modes d'autorisation de Claude Code](https://www.pilote-expertise.fr/images/guides/vibecoder-avec-claude-code/02-modes-autorisation.webp)
*Les modes d'autorisation. C'est le curseur entre « je contrôle tout » et « laisse-le travailler ».*

- Manuel : Claude demande avant chaque modification de fichier ou commande. C’est le mode par défaut de l’application de bureau
- Accepter les modifications : les modifications de fichiers passent toutes seules, vous gardez la main sur le reste
- Plan : Claude réfléchit et vous présente sa démarche sans rien modifier. Idéal avant une grosse étape
- Auto : Claude décide lui-même quand demander. Pratique une fois en confiance, à éviter le premier jour

![Sélecteur de modèle de Claude Code](https://www.pilote-expertise.fr/images/guides/vibecoder-avec-claude-code/03-choix-modele.webp)
*Le sélecteur de modèle. Changer de modèle en cours de session est instantané et sans conséquence.*

- Opus : le plus capable, à réserver aux passages difficiles
- Sonnet : le meilleur compromis pour 90 % du travail
- Haiku : rapide et économique, pour les tâches simples et répétitives
- Fable : le modèle le plus récent de la liste, à essayer quand les autres bloquent
- À droite du modèle, le niveau de réflexion : plus il est élevé, plus Claude prend le temps et plus il consomme

Claude peut se connecter à Google Drive, Gmail, GitHub, Slack et bien d'autres. C'est très pratique *plus tard*. Pour une première session, n'y touchez pas : chaque connecteur ajoute des données dans le contexte, donc de la consommation et du bruit. Faites tourner un projet complet d'abord.

## Le méga-prompt d'amorçage à copier

*Le seul texte de ce guide que vous devez vraiment copier.*

Une session de vibecoding réussie se joue dans les trois premières minutes. Si vous démarrez par « fais-moi une application de suivi de production », vous obtiendrez quelque chose de générique que vous passerez deux heures à corriger. Si vous démarrez en **fixant le rôle, la méthode et les contraintes**, Claude vous interroge d'abord et construit ensuite dans le bon sens.

Voici le prompt que nous collons en tout premier message, systématiquement. Remplacez uniquement la dernière ligne.

Trois choses font le travail dans ce prompt et elles méritent d'être comprises plutôt que recopiées bêtement.

**L'inversion des rôles.** En vous posant comme dirigeant et Claude comme directeur technique, vous lui interdisez de vous renvoyer les décisions. Sans cela, il vous demandera « préférez-vous PostgreSQL ou SQLite ? » et vous serez bloqué.

**L'interrogatoire préalable.** Les cinq à huit questions valent tout le cahier des charges que vous n'écrirez pas. C'est là que sortent les contraintes que vous aviez oubliées : « ça doit marcher sur la tablette de l'atelier, sans réseau ».

**La demande de fichier CLAUDE.md.** C'est un simple fichier texte à la racine du projet, que Claude relit à chaque nouvelle session. Sans lui, chaque redémarrage repart de zéro et vous réexpliquez tout. Avec lui, vous reprenez où vous en étiez, même trois semaines plus tard.

Vous avez une capture d'écran d'un outil qui ressemble à ce que vous voulez ? Glissez-la directement dans la zone de saisie et écrivez : « Reconstruis quelque chose de cet esprit, mais pour mon usage. » Une image bien choisie remplace vingt lignes de description et le résultat est immédiatement plus présentable.

## Votre première session, minute par minute

*Ce qui va réellement se passer, pour ne pas être surpris.*

Si le même problème résiste à trois corrections d'affilée, arrêtez d'insister : vous êtes dans une boucle. Écrivez plutôt : *« On tourne en rond. Explique-moi en français simple d'où vient le problème, propose deux approches différentes et attends ma réponse. »* Neuf fois sur dix, ça débloque immédiatement.

## Les sept réflexes qui changent tout

*La différence entre un résultat correct et un résultat qu'on ose montrer.*

Le premier écran produit par une IA est presque toujours fade : polices par défaut, couleurs violettes, dégradés partout. Ce n'est pas une fatalité, c'est un manque d'instructions. Voici ce qui fait la différence.

Pour que tous vos projets se ressemblent, créez une fois pour toutes un fichier `DESIGN.md` décrivant vos couleurs, vos polices et vos règles d'espacement, puis déposez-le dans chaque nouveau dossier de projet. Une phrase suffit ensuite : « respecte DESIGN.md ». C'est la charte graphique de votre entreprise, en version lisible par une IA.

## Données et sécurité : les règles non négociables

*La partie que personne ne met dans les tutoriels et qui pose le plus de problèmes.*

C'est le sujet qui nous fait le plus intervenir en entreprise, souvent après coup. Un outil bricolé le week-end se retrouve en production le mois suivant, avec des données clients dedans, sans que personne n'ait posé la question. Quelques règles suffisent à éviter l'essentiel.

- Aucune donnée personnelle réelle dans le projet tant qu'il est au stade prototype : ni noms de salariés, ni fichiers clients, ni données de santé. Travaillez avec des exemples fictifs : Claude vous en génère à la demande.
- Le dossier de travail ne contient rien d'autre que le projet. Pas de sous-dossier « Compta », pas de sauvegarde de messagerie, pas de fichier RH oublié.
- Aucun mot de passe ni clé d'accès écrit directement dans le projet. Demandez explicitement : « mets les secrets dans un fichier .env et ajoute-le au .gitignore ».
- Si vous publiez l'outil en ligne, vérifiez qui peut y accéder. Une adresse compliquée n'est pas une protection : demandez une vraie page de connexion.
- Si l'outil traite des données personnelles au sens du RGPD, il vous faut une base légale, une durée de conservation et une entrée au registre des traitements. Ce n'est pas Claude qui le fera pour vous.
- Avant de montrer votre écran ou de publier une capture, vérifiez qu'aucun nom de client réel ne traîne dessus.

C'est le scénario le plus fréquent et le plus coûteux. Un outil interne monté en trois soirées finit par piloter un flux réel, avec de vraies données. Plus personne n'ose y toucher. Fixez-vous une règle simple dès le départ : **le jour où de vraies données entrent dans l'outil, il fait l'objet d'une relecture par quelqu'un dont c'est le métier.** Ce n'est pas une question de compétence, c'est une question de responsabilité.

## Ce que ça coûte vraiment

Le prix affiché n'est pas le sujet. Le sujet, c'est la vitesse à laquelle vous consommez votre quota, car Claude Code consomme bien plus vite qu'une conversation classique. À chaque échange, il relit des fichiers, exécute des commandes, lit les résultats : le contexte grossit et il est renvoyé à chaque tour.

| Formule | Prix indicatif | Pour qui |
| --- | --- | --- |
| Free | Gratuit | Découverte de Claude, mais l'onglet Code demande une formule payante |
| Pro | 15 €/mois en annuel, 18 €/mois en mensuel | Quelques heures par semaine. Le bon point de départ |
| Max 5× | À partir de 90 €/mois | Usage quotidien intensif, plusieurs sessions en parallèle |
| Max 20× | Au-delà | Usage professionnel à temps plein |

*Tarifs hors taxes, susceptibles d’évoluer. Vérifiez claude.com/pricing avant de vous engager.*

Cinq habitudes réduisent nettement la consommation, sans rien changer au résultat :

- **Une session par tâche.** Une conversation qui dure trois heures traîne tout son historique à chaque message. Ouvrez-en une nouvelle dès que vous changez de sujet.
- **Sonnet par défaut.** Gardez Opus pour les passages où vous bloquez vraiment. Le gain de qualité ne se voit pas sur les tâches courantes.
- **Désignez, ne collez pas.** Plutôt que de coller le contenu d'un fichier, écrivez son nom précédé de `@`. Claude ira le lire lui-même et seulement s'il en a besoin.
- **Un plan avant les grosses étapes.** Cinq minutes de plan valident la direction et évitent une heure de travail à jeter.
- **Surveillez votre consommation.** Tapez `/usage` dans la conversation, ou ouvrez Réglages → Utilisation. Deux minutes par semaine suffisent à ne jamais avoir de surprise.

![Écran Utilisation de Claude : limites de la session en cours et limites hebdomadaires](https://www.pilote-expertise.fr/images/guides/vibecoder-avec-claude-code/04-utilisation.webp)
*L'écran Utilisation, dans les réglages. À regarder une fois par semaine, pas une fois par heure.*

- Session actuelle : votre consommation sur la fenêtre en cours, avec l'heure de remise à zéro
- Limites hebdomadaires : la vraie contrainte quand on travaille plusieurs jours d'affilée
- Une jauge par famille de modèles : c'est là qu'on voit le coût réel d'un usage systématique du modèle le plus puissant

Un outil interne simple (formulaire, base de données, tableau de bord, export) représente en général trois à six soirées de travail réparties sur deux semaines. Sur un forfait Pro, c'est faisable en restant dans les limites si vous travaillez proprement. Comparez ce chiffre au devis d'un développeur pour le même besoin : c'est là que la décision se prend, dans un sens comme dans l'autre.

## Quand ne PAS utiliser Claude Code

*La compétence la plus rentable de toutes.*

La règle d'or tient en une phrase : **ne mettez jamais plus de temps à construire l'outil qu'à faire la tâche à la main.** Beaucoup de gens passent une journée à automatiser quelque chose qui leur prenait dix minutes par mois. C'est de la productivité de façade : on a l'impression d'avancer, on a surtout perdu une journée.

| Votre besoin | L'outil adapté |
| --- | --- |
| Un calculateur, un simulateur, un petit visuel interactif à usage unique | Un artefact dans la conversation Claude classique : instantané, rien à installer |
| Produire un document, une présentation, un tableur | L'onglet Cowork, ou tout simplement Claude en conversation |
| Une image, un schéma, une illustration | Un outil de génération d'images |
| Nettoyer ou croiser des données une seule fois | Une conversation Claude avec votre fichier en pièce jointe |
| Un logiciel destiné à des clients, avec des paiements ou des données sensibles | Un développeur professionnel, dès le départ |
| Un besoin déjà couvert par un logiciel du marché à 30 € par mois | Le logiciel du marché. Vraiment. |

Le dernier cas mérite qu'on s'y arrête. La tentation de tout reconstruire soi-même parce que c'est devenu possible est réelle. Mais un logiciel du marché apporte aussi les mises à jour, la conformité, le support et la reprise de vos données le jour où vous partez. Reconstruisez uniquement ce qui est *spécifique à votre métier* : c'est justement là que rien n'existe.

## Passer la main à un développeur

Trois signaux indiquent qu'il est temps : votre outil dépasse la dizaine d'utilisateurs réguliers, il contient des données réelles de clients ou de salariés, ou une interruption vous poserait un vrai problème d'exploitation. À partir de là, le prototype doit devenir un logiciel.

La bonne nouvelle : contrairement à un générateur de sites fermé, vous partez avec un vrai projet, dans un vrai dossier, avec son historique. Un développeur peut le reprendre. Encore faut-il lui donner de quoi comprendre en une heure ce que vous avez fait en trois semaines.

Transmettez ensuite le dossier complet, le fichier `HANDOFF.md`, le `CLAUDE.md` et surtout, dites la vérité sur la façon dont il a été construit. Un développeur qui sait qu'il reprend un prototype de vibecoding sait exactement quoi regarder. Un développeur à qui on présente ça comme un logiciel professionnel perdra trois jours à comprendre pourquoi rien ne ressemble à ce qu'il attend.

Nous reprenons régulièrement des outils construits en vibecoding pour les fiabiliser, les sécuriser et les déployer vraiment dans l'entreprise. Montrez-nous ce que vous avez fait : le premier échange sert à vous dire honnêtement si ça vaut le coup de continuer. [Parler de votre outil](/developpement-application-sur-mesure/application-metier/)

## Huit prompts prêts à l'emploi

*À coller après le prompt d'amorçage.*

Ces formulations donnent de bons résultats parce qu'elles précisent toutes la même chose : qui s'en sert, dans quelles conditions et ce qu'on doit voir à l'écran. Adaptez les mots entre crochets.

## Par où commencer cette semaine

Ne cherchez pas l'idée parfaite. Cherchez l'agacement le plus proche. La question qui marche le mieux, nous la posons à tous nos clients : **« Quelle est la tâche que vous faites toutes les semaines, qui vous prend entre vingt minutes et deux heures et que vous détestez ? »** La réponse arrive en général en moins de dix secondes. C'est votre premier projet.

- Installez l'application Claude et, sous Windows, Git. Vingt minutes.
- Créez un dossier vide dédié à votre premier projet.
- Écrivez votre idée en une seule phrase. Si elle contient « et aussi », coupez.
- Collez le prompt d'amorçage et répondez honnêtement aux questions.
- Arrêtez-vous dès que vous avez quelque chose qui tourne, même très moche.
- Faites-le essayer à la personne concernée et notez ses hésitations.
- Reprenez une soirée plus tard pour corriger uniquement ces points-là.

Une dernière chose. Le vibecoding a une valeur qu'on sous-estime largement : il vous apprend à formuler un besoin. Après trois projets, vous saurez décrire ce que vous voulez avec une précision qui changera aussi vos échanges avec vos prestataires, vos éditeurs et vos équipes. Ce bénéfice-là dure bien plus longtemps que l'outil que vous aurez construit.

Nous animons des sessions de prise en main du vibecoding pour les équipes de PME : une demi-journée, votre vrai sujet et chacun repart avec son outil. Rien de théorique. [Voir nos formations IA](/formation-ia/)
