Claude Code peut se souvenir de vos préférences à travers les sessions, comme les directives de style et les commandes courantes dans votre flux de travail.

Déterminer le type de mémoire

Claude Code offre trois emplacements de mémoire, chacun servant un objectif différent :

Type de MémoireEmplacementObjectifExemples de Cas d’Usage
Mémoire de projet./CLAUDE.mdInstructions partagées par l’équipe pour le projetArchitecture de projet, normes de codage, flux de travail communs
Mémoire utilisateur~/.claude/CLAUDE.mdPréférences personnelles pour tous les projetsPréférences de style de code, raccourcis d’outils personnels
Mémoire de projet (locale)./CLAUDE.local.mdPréférences personnelles spécifiques au projet(Déprécié, voir ci-dessous) Vos URLs de sandbox, données de test préférées

Tous les fichiers de mémoire sont automatiquement chargés dans le contexte de Claude Code lors du lancement.

Importations CLAUDE.md

Les fichiers CLAUDE.md peuvent importer des fichiers supplémentaires en utilisant la syntaxe @chemin/vers/import. L’exemple suivant importe 3 fichiers :

Voir @README pour l'aperçu du projet et @package.json pour les commandes npm disponibles pour ce projet.

# Instructions Supplémentaires
- flux de travail git @docs/git-instructions.md

Les chemins relatifs et absolus sont autorisés. En particulier, importer des fichiers dans le répertoire personnel de l’utilisateur est un moyen pratique pour que les membres de votre équipe fournissent des instructions individuelles qui ne sont pas enregistrées dans le dépôt. Auparavant, CLAUDE.local.md servait un objectif similaire, mais est maintenant déprécié en faveur des importations car elles fonctionnent mieux à travers plusieurs arbres de travail git.

# Préférences Individuelles
- @~/.claude/my-project-instructions.md

Pour éviter les collisions potentielles, les importations ne sont pas évaluées à l’intérieur des spans de code markdown et des blocs de code.

Cette span de code ne sera pas traitée comme une importation : `@anthropic-ai/claude-code`

Les fichiers importés peuvent importer récursivement des fichiers supplémentaires, avec une profondeur maximale de 5 sauts. Vous pouvez voir quels fichiers de mémoire sont chargés en exécutant la commande /memory.

Comment Claude recherche les mémoires

Claude Code lit les mémoires de manière récursive : en commençant dans le cwd, Claude Code remonte récursivement jusqu’à / et lit tous les fichiers CLAUDE.md ou CLAUDE.local.md qu’il trouve. Ceci est particulièrement pratique lorsque vous travaillez dans de grands dépôts où vous exécutez Claude Code dans foo/bar/, et avez des mémoires dans foo/CLAUDE.md et foo/bar/CLAUDE.md.

Claude découvrira également CLAUDE.md imbriqué dans les sous-arbres sous votre répertoire de travail actuel. Au lieu de les charger au lancement, ils ne sont inclus que lorsque Claude lit des fichiers dans ces sous-arbres.

Ajouter rapidement des mémoires avec le raccourci #

Le moyen le plus rapide d’ajouter une mémoire est de commencer votre saisie avec le caractère # :

# Toujours utiliser des noms de variables descriptifs

Vous serez invité à sélectionner dans quel fichier de mémoire stocker ceci.

Éditer directement les mémoires avec /memory

Utilisez la commande slash /memory pendant une session pour ouvrir n’importe quel fichier de mémoire dans votre éditeur système pour des ajouts ou une organisation plus étendus.

Configurer la mémoire de projet

Supposons que vous vouliez configurer un fichier CLAUDE.md pour stocker des informations importantes du projet, des conventions et des commandes fréquemment utilisées.

Initialisez un CLAUDE.md pour votre base de code avec la commande suivante :

> /init 

Conseils :

  • Incluez les commandes fréquemment utilisées (build, test, lint) pour éviter les recherches répétées
  • Documentez les préférences de style de code et les conventions de nommage
  • Ajoutez des modèles architecturaux importants spécifiques à votre projet
  • Les mémoires CLAUDE.md peuvent être utilisées à la fois pour les instructions partagées avec votre équipe et pour vos préférences individuelles.

Meilleures pratiques de mémoire

  • Soyez spécifique : “Utiliser une indentation de 2 espaces” est mieux que “Formater le code correctement”.
  • Utilisez la structure pour organiser : Formatez chaque mémoire individuelle comme une puce et regroupez les mémoires liées sous des titres markdown descriptifs.
  • Révisez périodiquement : Mettez à jour les mémoires à mesure que votre projet évolue pour vous assurer que Claude utilise toujours les informations et le contexte les plus à jour.