Tuto pas à pas29/10/2026

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

Christophe Girard devant un plan de projet en verre avec une liste cochée, une fenêtre d'application protégée et trois étapes : cadrer, tester, publier
Ce que vous allez obtenir

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.

NiveauDébutant
Durée2 h pour cadrer et préparer les tests, puis le temps de construction
Coûtabonnement Claude Pro, environ 20 $ par mois (vérifié le 29/10/2026 sur des comparatifs, à confirmer sur la page tarifs de Claude) ; hébergement selon le projet
OutilsClaude (conversation), Claude Code, Un fichier CLAUDE.md, Un éditeur de texte
Fiche à téléchargerLes 7 prompts et la règle CLAUDE.md, prêts à copier

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 PDF

01 / avantAvant de commencer

Un abonnement Claude Pro ou supérieurenviron 20 $ par mois hors taxes (comparatifs consultés le 29/10/2026, non vérifié sur la page officielle)Claude Code n'est pas inclus dans l'offre gratuite. L'offre Pro suffit pour un petit outil interne.
Claude Code installéinclus dans l'abonnementDans l'application de bureau Claude ou dans le terminal, en suivant la page d'installation officielle d'Anthropic. Ouvrez-le dans un dossier vide créé pour votre projet.
Une idée d'outil et 30 minutes avec ses futurs utilisateursgratuitUn collègue, un prestataire, un client : les personnes qui utiliseront vraiment l'outil, pas seulement vous.
Données personnelles (RGPD)gratuitSi l'outil manipule des données de clients ou de salariés, listez-les dans le PRD, notez où elles seront stockées et ne collez jamais de vraies données dans les exemples envoyés à Claude.

02 / etapesLes étapes

1

Identifier les vrais utilisateurs

Un outil construit sans savoir pour qui il est finit avec des fonctions que personne n'utilise.

  1. Listez toutes les personnes qui pourraient utiliser l'outil : vous, vos équipes, vos prestataires, vos clients.
  2. Pour chacune, notez son problème actuel en une phrase et le temps qu'il lui fait perdre.
  3. Rayez celles à qui l'outil n'apporte rien de plus que leur façon de faire actuelle.
  4. Ouvrez une conversation dans Claude et collez le prompt ci-dessous pour vous faire challenger.
À copier
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.
C'est bon si

Vous avez une fiche besoin d'une page avec au plus 3 fonctionnalités, chacune reliée à un utilisateur et à un problème.

Le piège

Écrire directement un long prompt de 30 lignes dans Claude Code : il choisira seul les outils et ajoutera des fonctions inutiles.

2

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.

  1. Dans la même conversation Claude, collez le prompt ci-dessous.
  2. Relisez la section "Hors cadre" : chaque idée séduisante mais non prioritaire doit y figurer.
  3. Enregistrez le résultat dans votre dossier de projet sous le nom PRD.md.
À copier
À 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.
C'est bon si

Le fichier PRD.md contient les 6 sections et une section "Hors cadre" d'au moins 3 lignes.

Le piège

Oublier la section hors cadre : c'est elle qui empêche l'outil de devenir une usine à gaz.

3

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.

  1. Ouvrez Claude Code dans votre dossier de projet.
  2. Collez la demande ci-dessous.
  3. Ouvrez le fichier CLAUDE.md créé et vérifiez que la règle y figure mot pour mot.
À copier
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}}".
C'est bon si

Demandez à Claude Code une fonction absente du PRD : il refuse, l'ajoute à BACKLOG.md et vous le signale.

Le piège

Lever l'interdiction à la première idée nouvelle : notez-la au backlog et finissez la version 1 d'abord.

4

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.

  1. 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.
  2. Complétez la section 6 du PRD avec le paragraphe ci-dessous, rempli.
À copier
## 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.
C'est bon si

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é.

Le piège

Laisser Claude Code travailler seul pendant une demi-heure sur un brief vague : vous revenez avec une architecture surdimensionnée.

5

Construire une étape à la fois

Vérifier chaque étape avant la suivante évite d'empiler des erreurs invisibles.

  1. Collez le prompt ci-dessous dans Claude Code.
  2. Validez le plan, puis laissez-le réaliser l'étape 1 seulement.
  3. Testez vous-même ce qui est visible (écrans, boutons, textes) avant d'écrire "étape suivante".
À copier
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.
C'est bon si

Après chaque étape, vous avez testé ce qui s'affiche et vous savez ce qui a été fait côté invisible.

Le piège

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.

6

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.

  1. Collez le prompt d'audit ci-dessous dans Claude Code.
  2. Pour chaque point marqué "à corriger", demandez la correction puis relancez l'audit.
  3. Si l'outil est en ligne avec des données sensibles, faites relire ces quatre points par un développeur.
À copier
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.
C'est bon si

Les quatre points sont marqués OK, ou chaque point à corriger a été corrigé et vérifié par un second audit.

Le piège

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é.

7

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.

  1. Demandez à Claude Code un plan de test avec le prompt ci-dessous.
  2. Créez au moins deux comptes de rôles différents et vérifiez que chacun ne voit que ce qui le concerne.
  3. Chargez un volume réaliste de données (par exemple 300 projets au lieu de 5) et vérifiez l'affichage et les filtres.
À copier
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.
C'est bon si

Chaque ligne du plan de test a un résultat obtenu, et aucune ne montre une donnée visible par le mauvais compte.

Le piège

Se dire "ça marche chez moi, donc ça marchera chez les autres" et tester seulement avec les données de démonstration.

8

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.

  1. Faites une sauvegarde des données avant la première publication, puis avant chaque mise à jour.
  2. Demandez à Claude Code de séparer l'environnement de test de celui de production avec le prompt ci-dessous.
  3. Choisissez un hébergement dimensionné pour votre nombre d'utilisateurs et votre volume de données.
À copier
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.
C'est bon si

Vous savez reconnaître la version de test au premier coup d'oeil et vous avez restauré une sauvegarde au moins une fois.

Le piège

Supprimer des données en croyant être sur la démo alors que vous êtes en production.

9

Ouvrir l'outil progressivement

Deux ou trois premiers utilisateurs réels révèlent les problèmes avant qu'ils touchent tout le monde.

  1. Donnez l'accès à deux ou trois utilisateurs qui vont vraiment s'en servir.
  2. Notez leurs retours pendant une ou deux semaines, corrigez, puis ouvrez au reste de l'équipe.
  3. Rangez les nouvelles idées dans BACKLOG.md pour la version 2.
C'est bon si

Les premiers utilisateurs ont utilisé l'outil sur leurs vraies tâches sans blocage avant l'ouverture à tous.

03 / depannageSi ça ne marche pas

Claude Code ajoute quand même une fonction que vous n'avez pas demandée.Vérifiez que CLAUDE.md est à la racine du dossier ouvert, rappelez-lui la règle de périmètre et demandez-lui d'annuler le changement.
L'architecture proposée comporte plusieurs services payants.Renvoyez-le à la section Niveau d'ambition du PRD et demandez la version la plus simple, sans service payant, avec ce qu'elle ne permet pas.
L'outil marche chez vous mais plante chez un collègue.Faites-lui reproduire le geste, notez le message d'erreur exact et collez-le dans Claude Code avec ce qu'il a fait juste avant.
Claude Code vous demande de coller une clé ou un mot de passe.Ne la collez pas dans la conversation : demandez-lui où créer le fichier de configuration local, puis saisissez la clé vous-même dans ce fichier.

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.

Formation IA QualiopiAudit IAAutomatisationsMicro-SaaS
Découvrir mes services

"Avec l'IA, le futur, c'est maintenant !"

- ATLANTICOM

Leave a Comment

Comments

No comments yet. Why don’t you start the discussion?

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *