Anthropic vient de publier le guide officiel d'utilisation de Claude Code sur les grands codebases. Pour les équipes tech qui passent du POC à la mise en production sur des projets de plus de cent mille lignes, c'est le document de référence. Voici la synthèse des douze patterns mis en avant, et la lecture qu'on en fait chez BusinessDigital.fr en tant que partenaire certifié Anthropic.
Anthropic recommande un fichier CLAUDE.md racine minimaliste qui décrit uniquement le big picture, et des fichiers locaux dans chaque sous-répertoire avec les conventions et commandes propres au scope. Claude charge le racine puis additionne les CLAUDE.md des dossiers traversés, sans dupliquer le contexte. C'est exactement le pattern Russian Doll qu'on enseigne dans notre parcours Claude Architect Prep.
Lancer Claude Code dans le dossier où se trouve le code à modifier, pas à la racine. Claude remonte automatiquement l'arborescence et récupère les CLAUDE.md des niveaux supérieurs. Le bénéfice : pas de charge cognitive inutile, latence réduite, focus sur le scope.
Dans chaque CLAUDE.md local, déclarer les tests qui s'appliquent à ce sous-projet uniquement. Évite que Claude lance la suite complète quand seule une partie est concernée. Pratique standard chez les équipes de plus de cinquante développeurs.
Committer le fichier .claude/settings.json avec des règles permissions.deny qui excluent les fichiers générés, les build artifacts, le code tiers. Tout nouveau développeur cloné reçoit la configuration partagée immédiatement.
Installer un plugin code-intelligence pour le langage du projet. Claude suit les références exactes via le LSP au lieu de faire du text matching. La différence est massive sur les refactorings cross-files.
Packager les workflows métier (déploiement, sécurité, documentation) sous forme de skills. Claude les charge uniquement quand pertinent, ce qui évite la pollution du contexte. Pattern testé en production sur les équipes Stripe et GitHub selon Anthropic.
Lier une skill au dossier qui la concerne uniquement. Une skill de déploiement paiements pointée sur payments/ ne sera jamais auto-chargée sur le dossier marketing/. Filtrage intelligent du contexte.
Utiliser stop hooks pour capturer ce qui s'est passé en session et proposer des mises à jour CLAUDE.md pendant que la mémoire est fraîche. Boucle d'amélioration continue sans intervention humaine. C'est la mécanique qu'on déploie chez nos clients.
Bundler skills + hooks + configs MCP dans un plugin installable. Nouveaux développeurs reçoivent le contexte jour un sans setup manuel. Standardisation des bonnes pratiques à travers l'équipe.
Exposer la recherche structurée interne, les docs propriétaires, les APIs métier via des serveurs MCP. Claude appelle ces outils directement au lieu de demander aux développeurs de copier-coller du contexte.
Une instance Claude en read-only mappe un sous-système et écrit ses findings dans un fichier. L'agent principal édite ensuite avec le contexte synthétisé. Pattern crucial pour les codebases de plus de cinq cent mille lignes où le contexte direct dépasse la fenêtre.
Assigner la propriété centralisée de la configuration Claude Code à une personne ou une équipe : conventions CLAUDE.md, plugins approuvés, gouvernance MCP. Anthropic appelle cette fonction agent manager, un rôle hybride PM/ingénieur que les équipes mature en 2026.
Nous formons les équipes tech françaises sur ces douze patterns dans notre parcours Claude Architect Prep, qui prépare à la certification officielle Claude Certified Architect Foundations (CCA-F) d'Anthropic. Quinze heures de contenu, examen blanc de soixante questions au format officiel, gratuit, certificat partageable sur LinkedIn.
Pour les développeurs juniors qui n'ont pas encore le niveau Architect, notre parcours Claude Practitioner couvre les bases : Claude Code en pratique, API Claude, MCP basics, patterns prompt engineering. Huit heures, gratuit.
Parcours Claude Architect Prep : https://businessdigital.fr/academie/parcours/claude-architect-prep
Parcours Claude Practitioner : https://businessdigital.fr/academie/parcours/claude-practitioner
Article Anthropic source : https://claude.com/blog/how-claude-code-works-in-large-codebases-best-practices-and-where-to-start
Franck PARIENTI BusinessDigital.fr Organisme Qualiopi RNQ-25/10/2579 Partenaire certifié Anthropic