Les modes de Claude Code

Claude Code propose trois modes d'interaction. Les maîtriser, c'est la différence entre tourner en rond pendant une heure et livrer une feature en 15 minutes.

Vue d'ensemble

Tu bascules entre les trois avec Shift+Tab, qui cycle dans l'ordre : Normal, Auto-accept, Plan.

Chat Mode (par défaut)

Le mode standard. Tu poses une question ou demandes une modification, Claude propose le changement, et tu valides avant qu'il l'applique.

Quand l'utiliser :

• Poser une question sur le code existant
• Faire une modification simple (renommer une variable, corriger un bug évident)
• Explorer une partie du codebase que tu ne connais pas

Le formulaire d'inscription à la waitlist ne reset pas après soumission.
Le state `email` reste affiché. Corrige le composant WaitlistForm.tsx.

La règle : si ta modification touche un seul fichier et que tu sais exactement ce que tu veux, le Chat Mode suffit.

Plan Mode

Le mode le plus important pour construire un MVP. Au lieu de coder directement, Claude analyse ton codebase, pose des questions, et propose un plan détaillé. Il ne touche à aucun fichier tant que tu n'as pas validé.

Activer Plan Mode

Shift+Tab      # Cycle entre les modes
               # Normal → Auto-accept → Plan → Normal

Tu peux aussi taper /plan directement dans le prompt.

Quand utiliser Plan Mode

• Ta modification touche 2 fichiers ou plus
• Tu dois prendre une décision architecturale (choix de pattern, structure de données)
• Tu n'es pas sûr de l'approche et tu veux que Claude réfléchisse d'abord
• La feature est complexe (intégration Stripe, flux d'authentification, système d'emails)

Quand Plan Mode est inutile

Ne perds pas de temps à planifier des modifications triviales. Si tu veux renommer une variable, corriger une typo, ou ajouter un champ à un schéma, utilise directement le Chat Mode. Plan Mode ajouterait de la friction sans valeur.

Auto-accept Mode

Une fois que tu as un plan validé, active l'auto-accept pour laisser Claude implémenter sans te demander confirmation à chaque fichier modifié.

Shift+Tab      # Depuis le mode Normal, un seul Shift+Tab active Auto-accept
               # Normal → Auto-accept

Scénario complet : le dashboard de LaunchList

Voyons comment les trois modes s'enchaînent sur un cas réel. On veut construire le dashboard qui affiche les waitlists d'un utilisateur avec leurs statistiques (nombre d'inscrits, taux de conversion, revenus Stripe).

Je veux créer le dashboard principal de LaunchList.

Ce dashboard doit afficher :
- La liste des waitlists de l'utilisateur connecté
- Pour chaque waitlist : nombre d'inscrits, taux de conversion, revenus Stripe
- Un bouton "Créer une waitlist" si l'utilisateur n'en a aucune
- Un état vide avec un message d'onboarding

Stack : Next.js 16 (App Router), Drizzle ORM, Better-Auth pour la session,
Stripe pour les paiements, Tailwind CSS v4.

Le schéma Drizzle existant a les tables : users, waitlists, waitlistEntries, orders.

Analyse le code existant et propose un plan détaillé.

git diff --stat

Dans src/lib/queries/dashboard.ts, la requête getWaitlistsByUser ne filtre
pas les waitlists avec status "deleted". Du coup si un utilisateur a supprimé
toutes ses waitlists, il voit un dashboard vide au lieu du message d'onboarding.

Corrige la requête pour exclure les waitlists supprimées, et vérifie que le
composant Dashboard utilise bien le bon état vide.

Les pièges de chaque mode

Savoir interrompre Claude

C'est un réflexe que tu dois développer dès maintenant. Quand Claude commence à générer du code et que tu vois dès les premières lignes qu'il part dans la mauvaise direction, n'attends pas qu'il finisse. Chaque ligne générée dans la mauvaise direction, c'est du contexte pollué et du temps perdu.

Appuie sur Escape immédiatement. Pas dans 30 secondes, pas après avoir lu la suite "pour voir". Tout de suite.

Après l'interruption, reformule ton prompt en étant plus précis sur ce que tu veux. Souvent, Claude partait dans la mauvaise direction parce que ton prompt était ambigu ou manquait de contexte.

Situations typiques où tu dois interrompre :

• Claude crée un nouveau fichier alors que tu voulais modifier un fichier existant
• Claude installe une dépendance que tu n'as pas demandée
• Claude restructure du code qui fonctionnait déjà
• Claude part sur une approche complètement différente de ce que tu avais en tête

Revenir en arrière avec /rewind

Quand Claude a modifié plusieurs fichiers et que le résultat ne convient pas, tu as deux options :

/rewind est plus puissant que git : il restaure le code et le contexte de conversation à n'importe quel point précédent. Claude oublie tout ce qui s'est passé après ce point, ce qui évite de polluer le contexte avec des tentatives ratées.

Quand utiliser /rewind :

• Claude a modifié 5 fichiers dans la mauvaise direction et tu veux tout annuler proprement
• Tu veux essayer une approche alternative sans que Claude soit influencé par la tentative précédente
• Claude est parti en boucle et son contexte est pollué par des corrections en chaîne

Raccourcis essentiels

Le workflow recommandé

Répète ce cycle pour chaque feature. Une feature = un cycle. Ne mélange pas plusieurs features dans le même cycle, tu perdras en clarté et Claude perdra le fil.

Prochaine étape

Les modes sont tes outils d'interaction avec Claude. Mais pour que Claude soit efficace dès le premier prompt, il a besoin de contexte sur ton projet. C'est le rôle du fichier CLAUDE.md, la mémoire persistante de ta collaboration avec Claude.