Le vibe coding devient fiable lorsque l’intention est transformée en petits changements vérifiables. Claude Code peut lire le dépôt, modifier des fichiers et lancer des commandes, mais vous restez responsable de l’architecture, des permissions et du résultat.
Installer et préparer
Installez Claude Code selon la méthode officielle, exécutez claude doctor, puis travaillez dans un dépôt Git avec un état propre :
~~~bash git switch -c feature/task-board npm test claude ~~~
N’utilisez pas sudo pour l’installation npm et n’activez pas le contournement global des permissions.
Écrire une spécification courte
Créez docs/spec.md avec : utilisateurs, trois parcours, données, contraintes, critères d’acceptation et hors périmètre. Exemple : une liste de tâches avec création, validation, persistance et navigation clavier ; pas d’authentification dans la première version.
Demandez d’abord : « Lis la spécification et le dépôt. Propose un plan sans modifier de fichier. Signale les décisions manquantes. » Le mode plan évite d’engager une architecture avant accord.
Avancer par tranches verticales
Première tâche : modèle de données et test. Deuxième : route API et test. Troisième : interface et test accessible. Pour chaque tranche, demandez :
- expliquer les fichiers concernés ;
- implémenter le plus petit changement ;
- lancer les tests ciblés ;
- résumer le diff et les risques.
Commitez une tranche validée avant la suivante. Un diff trop grand est un signal d’arrêt, pas une preuve de productivité.
Utiliser les permissions
Autorisez des commandes précises comme tests ou lint. Lisez toute demande touchant réseau, secrets, migrations ou suppression. Ne lancez pas dangerously-skip-permissions dans un environnement contenant des données ou credentials.
Revue
Inspectez git diff, puis demandez une seconde passe ciblée : sécurité, accessibilité, erreurs et tests manquants. Vérifiez vous-même dépendances ajoutées, code généré, migrations et variables publiques. Exécutez la suite complète dans un environnement propre.
Déployer
Créez une preview, testez les critères d’acceptation, sauvegardes et rollback. Le déploiement production reste une décision humaine explicite. Après livraison, documentez architecture et commandes de maintenance.
FAQ
Peut-on demander toute l’application en un prompt ?
Oui pour un prototype jetable, mais pas pour garder une revue fiable. Préférez des tranches courtes.
Que mettre dans CLAUDE.md ?
Commandes, conventions, architecture et contraintes stables ; pas de secrets ni d’instructions contradictoires avec les contrôles du dépôt.