Le refactoring avec Claude Code : un plan, de petites étapes et des tests au vert

Ce que Claude Code fait pour le refactoring

• Il avance dans un backlog de refactoring par petites étapes, chacune dans sa propre pull request.
• Il lance les tests avant et après chaque étape, et s’arrête quand ils échouent.
• Il fait la partie mécanique des migrations : renommages dans toute la base de code, mises à niveau d’API, passage à une nouvelle bibliothèque.
• Il supprime le code mort et la logique dupliquée, et explique chaque suppression.

Les fonctionnalités de Claude Code pour le refactoring

Comment configurer Claude Code pour le refactoring

1. Connectez les outils

   Il n’y a rien à connecter. Ce qui rend un refactoring sûr, c’est une commande de test que Claude peut lancer et une limite à la taille de chaque étape : mettez les deux dans CLAUDE.md et commencez dans un worktree.

   # Démarrer le refactoring dans son propre worktree
   claude --worktree billing-async
   
   # Valider le plan avant toute modification
   /plan Passe le module billing des callbacks à async/await

2. Écrivez les règles dans CLAUDE.md

   Claude Code lit CLAUDE.md au début de chaque session, y compris lors des exécutions claude -p. Mettez-y les règles de la tâche, ou dans une skill sous .claude/skills/ si elles sont longues. Voir le guide de CLAUDE.md.

   ## Règles de refactoring
   - Aucun changement de comportement. Si un test doit changer, arrête-toi et demande.
   - Lance `npm test` avant de commencer et après chaque étape.
   - Une étape par pull request, moins de 400 lignes modifiées.
   - Tiens REFACTOR.md à jour : coche ce qui est fait, ajoute ce
     que tu as trouvé.
   - Ne touche pas à migrations/, aux fichiers générés ni aux API
     publiques sans demander.

3. Lancez-le sans l’interface interactive

   claude -p exécute une tâche puis s’arrête : cron, la CI ou un autre outil peut donc le lancer. Choisissez ce qu’il peut faire sans demander avec --allowedTools ou --permission-mode ; --output-format json renvoie le résultat avec son coût.

   # Une étape par jour depuis le backlog de REFACTOR.md
   claude -p "Fais le prochain élément non coché de REFACTOR.md et garde les tests au vert" \
     --allowedTools "Bash(npm test),Read,Edit"

4. Planifiez-le

   Faites-en une tâche planifiée dans le cloud avec /schedule (Pro, Max, Ultra, Team et Enterprise), une tâche planifiée de bureau, ou utilisez /loop tant qu’une session reste ouverte. Voir comment rendre Claude Code proactif.

Source : documentation de Claude Code

Limites et sécurité

• Sans tests, il ne peut pas distinguer un refactoring d’un changement de comportement. Ajoutez d’abord des tests sur la zone concernée.
• Une grosse réécriture d’un seul coup est difficile à relire. De petites étapes mergées une à une sont plus sûres, et au final plus rapides.
• Il ne sait pas quel code étrange est voulu. Signalez ces endroits par un commentaire ou dans les règles.
• Depuis Claude Code v2.1.302, claude -p démarre en mode manuel (Manual) : une action qui demande une validation est refusée, sauf si une règle l’autorise. N’autorisez que les outils dont la tâche a besoin.

Claude Code ou Codex pour le refactoring ?

Les règles se transposent. Écrivez-les une fois dans AGENTS.md et mettez @AGENTS.md dans CLAUDE.md : les deux agents lisent alors le même fichier.

Pas à pas pour l’autre agent : le refactoring avec Codex.

Confiez le refactoring à quelqu’un dont c’est le travail

Les commandes tournent quand quelqu’un pense à les lancer. Crewmark transforme votre propre Claude Code en employé IA doté d’un rôle, d’un objectif chiffré, d’horaires de travail et d’une pulsation : le travail se fait selon un planning et apparaît sur un tableau.

1. Partez du rôle

   Prenez l’ingénieur logiciel IA et mettez ces règles dans sa fiche de poste.

2. Mettez le travail sur son tableau

   Ajoutez la tâche comme ticket récurrent. L’employé se réveille au rythme de sa pulsation, l’accomplit et rend compte dans un commentaire.

3. À voir aussi

   La revue de code vérifie chaque étape avant son merge.

FAQ