Technique~7 min · intermédiaire

Les erreurs courantes avec Claude Code

Claude Code décuple un bon dev et amplifie les mauvaises habitudes d'un dev pressé. Voici les erreurs que je vois le plus, et le réflexe qui corrige chacune.

StackClaude CodeCLAUDE.mdgittestscontexte
01

Le top des erreurs

Le méga-prompt

« Construis toute l'app » en un message. L'agent dérive, mélange tout. Découpe en tâches cadrées.

Pas de CLAUDE.md

Sans mémoire de projet, il redevine ta stack à chaque session et refait les mêmes choix contraires aux tiens.

Accepter sans lire

Valider les diffs sans les relire, c'est déléguer la responsabilité du code. Tu restes le pilote.

Jamais de tests

Sans lui faire lancer les tests, l'agent ne sait pas s'il a cassé quelque chose — et toi non plus.

02

Le contexte mal géré

L'erreur la plus subtile : laisser une session s'éterniser jusqu'à ce que le contexte soit saturé de vieilles pistes abandonnées. L'agent devient confus, lent, contradictoire.

mauvais réflexe
une session sans fin.
·contexte pollué de tâches finies
·réponses de plus en plus vagues
bon réflexe
une session par tâche.
·repartir propre entre deux gros sujets
·résumer l’état dans le CLAUDE.md
03

Les réflexes qui corrigent

·une tâche = une boucle = un commit : tout se réverte proprement ;
·fais-lui décrire son plan avant d'éditer, et corrige le plan, pas le code ;
·fais-lui lancer tests et build, et lire sa propre sortie d'erreur ;
·range les procédures répétées en skills, les règles permanentes en CLAUDE.md.
À retenir

La plupart de ces erreurs disparaissent avec les bases bien posées : les bases de Claude Code.

04

Sources & ressources

Sources & ressources
01Best practices for Claude Code — documentation officielleLa page de référence : fenêtre de contexte, /clear entre deux tâches, plan mode, vérification par les tests, et une section « common failure patterns » qui recense les mêmes erreurs.02How Claude remembers your project (CLAUDE.md & auto memory)Où placer un CLAUDE.md, quoi y mettre, et pourquoi viser moins de 200 lignes : au-delà, l'adhérence aux instructions chute.03Extend Claude with skillsLa règle de partage : les faits permanents en CLAUDE.md, les procédures répétées en SKILL.md — chargées à la demande, donc gratuites tant qu'on ne s'en sert pas.04Configure permissions — Claude CodeRègles d'autorisation, allowlists et sandbox : comment réduire les prompts d'approbation sans cliquer « oui » à l'aveugle.05Common workflows — Claude CodeLes recettes concrètes : tests, refactor par petits incréments, création de PR, délégation de la recherche à des sous-agents.06Effective context engineering for AI agents — AnthropicPourquoi un contexte saturé dégrade le modèle (« context rot »), et les trois parades : compaction, notes structurées, sous-agents.07Effective harnesses for long-running agents — AnthropicLe retour d'expérience sur les agents longue durée : une fonctionnalité à la fois, commits git et journal de progression pour survivre d'une session à l'autre.
En résumé

Aucune de ces erreurs n'est technique : ce sont des raccourcis de méthode. Petites boucles, CLAUDE.md à jour, diffs relus, tests lancés. L'agent ne remplace pas la rigueur — il la récompense.

Doc Claude Code ↗
À lire ensuite