Tuto Claude Code : cadrer, tester et publier votre première app pas à pas

Un outil interne construit avec Claude Code qui répond à un vrai besoin, reste dans son périmètre, a été testé hors du chemin parfait et part en production sans perte de données.
La fiche PDF ATLANTICOM : la règle anti-dérive à poser dans CLAUDE.md et les 7 prompts dans l'ordre du tuto (besoin, PRD, ambition, construction, audit, tests, production), avec les {{variables}} à remplacer.
Télécharger la fiche PDF01 / avantAvant de commencer
02 / etapesLes étapes
Identifier les vrais utilisateurs
Un outil construit sans savoir pour qui il est finit avec des fonctions que personne n'utilise.
- Listez toutes les personnes qui pourraient utiliser l'outil : vous, vos équipes, vos prestataires, vos clients.
- Pour chacune, notez son problème actuel en une phrase et le temps qu'il lui fait perdre.
- Rayez celles à qui l'outil n'apporte rien de plus que leur façon de faire actuelle.
- Ouvrez une conversation dans Claude et collez le prompt ci-dessous pour vous faire challenger.
Je veux créer un outil interne pour {{description_courte_de_l_outil}}.
Voici les utilisateurs que j'envisage et leur problème actuel :
{{liste_utilisateurs_et_problemes}}
Pose-moi une question à la fois pour vérifier, pour chaque utilisateur : son vrai problème, ce que l'outil lui ferait gagner, et s'il en a réellement besoin. À la fin, rédige une fiche besoin d'une page : utilisateurs retenus, problème de chacun, 3 fonctionnalités maximum qui y répondent.Vous avez une fiche besoin d'une page avec au plus 3 fonctionnalités, chacune reliée à un utilisateur et à un problème.
Écrire directement un long prompt de 30 lignes dans Claude Code : il choisira seul les outils et ajoutera des fonctions inutiles.
Rédiger le PRD avec sa section hors cadre
Le PRD dit à Claude Code ce qu'il construit, pour qui, et surtout ce qu'il ne construit pas maintenant.
- Dans la même conversation Claude, collez le prompt ci-dessous.
- Relisez la section "Hors cadre" : chaque idée séduisante mais non prioritaire doit y figurer.
- Enregistrez le résultat dans votre dossier de projet sous le nom PRD.md.
À partir de la fiche besoin ci-dessus, rédige un PRD (product requirement document) en Markdown avec ces sections : 1. Objectif de l'outil en une phrase 2. Utilisateurs et leur problème 3. Fonctionnalités de la version 1 (3 maximum), chacune avec un critère de réussite vérifiable 4. Hors cadre : tout ce qui ne sera pas fait en version 1, même si c'est tentant 5. Données manipulées et qui a le droit de voir quoi 6. Niveau d'ambition (à compléter à l'étape suivante) Écris simplement, pour une personne qui ne code pas.
Le fichier PRD.md contient les 6 sections et une section "Hors cadre" d'au moins 3 lignes.
Oublier la section hors cadre : c'est elle qui empêche l'outil de devenir une usine à gaz.
Poser la règle anti-dérive dans CLAUDE.md
Claude Code lit le fichier CLAUDE.md à chaque session : la règle l'empêche d'ajouter des fonctions hors du PRD.
- Ouvrez Claude Code dans votre dossier de projet.
- Collez la demande ci-dessous.
- Ouvrez le fichier CLAUDE.md créé et vérifiez que la règle y figure mot pour mot.
Crée un fichier CLAUDE.md à la racine du projet avec cette règle :
## Règle de périmètre
Le fichier PRD.md fait foi. Tu ne développes aucune fonctionnalité absente de sa section "Fonctionnalités de la version 1". Si je te demande autre chose, tu ne le codes pas : tu l'ajoutes au fichier BACKLOG.md avec la date, tu me le dis en une phrase, et tu attends que je lève l'interdiction explicitement en écrivant "j'autorise : {{nom_de_la_fonction}}".Demandez à Claude Code une fonction absente du PRD : il refuse, l'ajoute à BACKLOG.md et vous le signale.
Lever l'interdiction à la première idée nouvelle : notez-la au backlog et finissez la version 1 d'abord.
Fixer le niveau d'ambition
Sans cette précision, Claude Code peut monter serveur, base de données et déploiement automatique pour un simple site statique.
- Répondez à quatre questions : combien d'utilisateurs, en local ou en ligne, faut-il un compte de connexion, que se passe-t-il si les données sont perdues.
- Complétez la section 6 du PRD avec le paragraphe ci-dessous, rempli.
## Niveau d'ambition
- Utilisateurs : {{nombre_utilisateurs}}
- Usage : {{local_ou_en_ligne}}
- Connexion par compte : {{oui_ou_non}}
- Perte des données : {{acceptable_ou_grave}}
Consigne : choisis l'architecture la plus simple qui répond à ce niveau. Avant d'ajouter un serveur, une base de données, un service payant ou un déploiement automatique, explique-moi pourquoi et attends mon accord.Demandez à Claude Code "Quelle architecture proposes-tu et combien coûte-t-elle par mois ?" : la réponse correspond au niveau écrit et chaque service payant est justifié.
Laisser Claude Code travailler seul pendant une demi-heure sur un brief vague : vous revenez avec une architecture surdimensionnée.
Construire une étape à la fois
Vérifier chaque étape avant la suivante évite d'empiler des erreurs invisibles.
- Collez le prompt ci-dessous dans Claude Code.
- Validez le plan, puis laissez-le réaliser l'étape 1 seulement.
- Testez vous-même ce qui est visible (écrans, boutons, textes) avant d'écrire "étape suivante".
Lis PRD.md et CLAUDE.md. Découpe la version 1 en étapes courtes, chacune avec ce que je pourrai vérifier moi-même à l'écran. Réalise uniquement l'étape 1, puis arrête-toi et dis-moi comment la tester. Pour toute partie invisible (base de données, gestion des erreurs, accès), explique en deux phrases ce que tu as fait et ce qui pourrait mal tourner.
Après chaque étape, vous avez testé ce qui s'affiche et vous savez ce qui a été fait côté invisible.
Croire que tout est bon parce que l'écran est joli : l'interface est ce que l'IA réussit le mieux, les données et les erreurs beaucoup moins.
Vérifier les quatre angles morts
Droits d'accès, clés secrètes, gestion des pannes et dépendances sont les failles les plus fréquentes des apps faites avec l'IA.
- Collez le prompt d'audit ci-dessous dans Claude Code.
- Pour chaque point marqué "à corriger", demandez la correction puis relancez l'audit.
- Si l'outil est en ligne avec des données sensibles, faites relire ces quatre points par un développeur.
Fais un audit de sécurité simple de ce projet, en langage non technique, sur quatre points : 1. Droits d'accès : un utilisateur peut-il lire des données qui ne le concernent pas en contournant l'interface (adresse directe, appel à l'API) ? Si une base Supabase est utilisée, la sécurité par ligne (Row Level Security) est-elle activée sur chaque table ? 2. Clés secrètes : y a-t-il une clé, un mot de passe ou un jeton écrit dans le code ou dans un fichier envoyé sur GitHub ? 3. Pannes : que se passe-t-il si le réseau coupe, si un formulaire est mal rempli, si un service externe ne répond pas ? Des données peuvent-elles être perdues ? 4. Dépendances : liste les bibliothèques ajoutées et dis lesquelles pourraient casser le projet lors d'une mise à jour. Pour chaque point : OK ou à corriger, et pourquoi.
Les quatre points sont marqués OK, ou chaque point à corriger a été corrigé et vérifié par un second audit.
Coller une clé secrète dans la conversation ou dans le code pour aller plus vite : elle doit rester dans un fichier de configuration jamais publié.
Tester hors du chemin parfait
Une app générée par l'IA marche presque toujours avec l'utilisateur idéal ; les vrais problèmes arrivent avec les autres.
- Demandez à Claude Code un plan de test avec le prompt ci-dessous.
- Créez au moins deux comptes de rôles différents et vérifiez que chacun ne voit que ce qui le concerne.
- Chargez un volume réaliste de données (par exemple 300 projets au lieu de 5) et vérifiez l'affichage et les filtres.
Rédige un plan de test pour la version 1, sous forme de tableau : action, résultat attendu, résultat obtenu (vide). Inclus : champs vides, fautes de frappe, coupure réseau au milieu d'une action, {{volume_realiste}} enregistrements chargés, et un test par rôle d'utilisateur pour vérifier qu'il ne voit que ses données. Ajoute des données de test fictives pour ce volume.Chaque ligne du plan de test a un résultat obtenu, et aucune ne montre une donnée visible par le mauvais compte.
Se dire "ça marche chez moi, donc ça marchera chez les autres" et tester seulement avec les données de démonstration.
Préparer la mise en production
La publication n'est pas la ligne d'arrivée : c'est là que les vraies données arrivent et qu'une erreur coûte cher.
- Faites une sauvegarde des données avant la première publication, puis avant chaque mise à jour.
- Demandez à Claude Code de séparer l'environnement de test de celui de production avec le prompt ci-dessous.
- Choisissez un hébergement dimensionné pour votre nombre d'utilisateurs et votre volume de données.
Avant de publier, mets en place deux environnements séparés : test et production, avec deux bases de données distinctes et un nom visible "TEST" sur la version de test. Explique-moi comment faire une sauvegarde des données de production et comment la restaurer. Propose l'hébergement le plus simple adapté au niveau d'ambition du PRD, avec son coût mensuel.
Vous savez reconnaître la version de test au premier coup d'oeil et vous avez restauré une sauvegarde au moins une fois.
Supprimer des données en croyant être sur la démo alors que vous êtes en production.
Ouvrir l'outil progressivement
Deux ou trois premiers utilisateurs réels révèlent les problèmes avant qu'ils touchent tout le monde.
- Donnez l'accès à deux ou trois utilisateurs qui vont vraiment s'en servir.
- Notez leurs retours pendant une ou deux semaines, corrigez, puis ouvrez au reste de l'équipe.
- Rangez les nouvelles idées dans BACKLOG.md pour la version 2.
Les premiers utilisateurs ont utilisé l'outil sur leurs vraies tâches sans blocage avant l'ouverture à tous.
03 / depannageSi ça ne marche pas
04 / plus-loinAller plus loin
- Réutiliser le même PRD et le même CLAUDE.md comme modèle pour votre prochain outil.
- Faire relire l'audit des angles morts par un développeur avant d'ouvrir l'outil à des clients.
- Transformer le plan de test en liste à rejouer avant chaque mise à jour.
05 / lexiqueLexique
- Claude Code
- L'assistant de développement d'Anthropic qui lit et écrit les fichiers de votre projet à partir de vos demandes en français.
- PRD
- Product requirement document : le document qui décrit à qui sert l'outil, ce qu'il fait et ce qu'il ne fait pas encore.
- CLAUDE.md
- Un fichier texte placé dans le dossier du projet, que Claude Code relit à chaque session pour suivre vos règles.
- Backlog
- La liste des idées et fonctions repoussées à plus tard.
- Architecture
- L'ensemble des briques techniques choisies pour faire tourner l'outil : serveur, base de données, hébergement.
- Base de données
- L'endroit où l'outil range ses informations (clients, projets, factures).
- API
- La porte d'entrée technique par laquelle un programme lit ou écrit des données, sans passer par les écrans.
- Row Level Security
- Un réglage de certaines bases de données, dont Supabase, qui vérifie pour chaque ligne si l'utilisateur connecté a le droit de la voir.
- Clé secrète
- Un code qui donne accès à un service payant ou à vos données ; il ne doit jamais être visible dans le code publié.
- GitHub
- Un site où l'on stocke et partage le code d'un projet ; un dépôt public est lisible par tout le monde.
- Dépendance
- Une bibliothèque de code externe ajoutée au projet ; sa mise à jour peut casser l'outil.
- Chemin parfait
- Le parcours de l'utilisateur idéal qui remplit tout correctement ; on l'appelle aussi happy path.
- Environnement de test et de production
- Deux copies séparées de l'outil : l'une pour essayer, l'autre utilisée par les vrais utilisateurs avec les vraies données.
06 / faqQuestions fréquentes
Faut-il savoir coder pour suivre ce tuto ?
Non pour un outil interne simple : Claude Code écrit le code et l'interface se vérifie à l'oeil. Dès que l'outil est en ligne avec des données sensibles, faites relire les droits d'accès et la gestion des erreurs par un développeur.
Combien ça coûte ?
L'abonnement Claude Pro (environ 20 $ par mois, à vérifier sur la page tarifs) suffit pour construire. L'hébergement dépend du niveau d'ambition : un outil local ne coûte rien de plus, un outil en ligne avec base de données a un coût mensuel à faire chiffrer à l'étape 8.
Pourquoi ne pas tout décrire en un seul long prompt ?
Parce que l'IA choisit alors seule les langages, les bases de données et parfois des services payants inutiles, et ajoute des fonctions non demandées. Le PRD et la règle de périmètre gardent la main sur ces choix.
Mes données partent-elles chez Anthropic ?
Le code et ce que vous collez dans Claude Code sont envoyés au service pour être traités. Travaillez avec des données fictives pendant la construction et n'y mettez jamais de clé secrète ni de données clients réelles.
Combien de temps pour une première version ?
Comptez environ deux heures pour cadrer (fiche besoin, PRD, CLAUDE.md, niveau d'ambition) et préparer les tests. La construction dépend du nombre de fonctionnalités : c'est pour cela que la version 1 se limite à trois.
07 / retenirCe qu'il faut retenir
- Commencez par les utilisateurs et leur problème, pas par Claude Code.
- Le PRD vaut surtout par sa section hors cadre, que la règle de CLAUDE.md fait respecter.
- Fixez le niveau d'ambition pour éviter une architecture et des abonnements surdimensionnés.
- Vérifiez droits d'accès, clés secrètes, pannes et dépendances, puis testez hors du chemin parfait.
- Sauvegardez, séparez test et production, et ouvrez l'outil à deux ou trois utilisateurs d'abord.
Christophe Girard
Consultant IA, Formateur & Créateur de Micro-SaaS, Fondateur d'ATLANTICOM
Basé en région nantaise, je crée des logiciels sur mesure et des Micro-SaaS pour les TPE/PME grâce au Vibe-Coding (Cursor, Codex, Claude Code, Lovable). Formations certifiées Qualiopi, audits IA, automatisations et outils internes sur-mesure : je vous aide à remplacer vos fichiers Excel par de vrais outils métier : en jours, pas en mois.
Découvrir mes services"Avec l'IA, le futur, c'est maintenant !"
- ATLANTICOM
