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 quatre emplacements de mémoire dans une structure hiérarchique, chacun servant un objectif différent :

Type de MémoireEmplacementObjectifExemples de Cas d’UsagePartagé Avec
Politique d’entreprisemacOS: /Library/Application Support/ClaudeCode/CLAUDE.md
Linux: /etc/claude-code/CLAUDE.md
Windows: C:\ProgramData\ClaudeCode\CLAUDE.md
Instructions à l’échelle de l’organisation gérées par l’IT/DevOpsStandards de codage d’entreprise, politiques de sécurité, exigences de conformitéTous les utilisateurs de l’organisation
Mémoire de projet./CLAUDE.mdInstructions partagées par l’équipe pour le projetArchitecture de projet, standards de codage, flux de travail communsMembres de l’équipe via le contrôle de source
Mémoire utilisateur~/.claude/CLAUDE.mdPréférences personnelles pour tous les projetsPréférences de style de code, raccourcis d’outils personnelsVous seulement (tous les projets)
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éesVous seulement (projet actuel)

Tous les fichiers de mémoire sont automatiquement chargés dans le contexte de Claude Code au lancement. Les fichiers plus hauts dans la hiérarchie ont la priorité et sont chargés en premier, fournissant une base sur laquelle les mémoires plus spécifiques se construisent.

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 home de l’utilisateur est un moyen pratique pour les membres de votre équipe de fournir des instructions individuelles qui ne sont pas enregistrées dans le dépôt. Précédemment 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 récursivement importer 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 récursivement : en commençant dans le cwd, Claude Code remonte récursivement jusqu’à (mais sans inclure) le répertoire racine / 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.

Amorcez 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.

Gestion de la mémoire au niveau de l’organisation

Les organisations d’entreprise peuvent déployer des fichiers CLAUDE.md gérés centralement qui s’appliquent à tous les utilisateurs.

Pour configurer la gestion de la mémoire au niveau de l’organisation :

  1. Créez le fichier de mémoire d’entreprise dans l’emplacement approprié pour votre système d’exploitation :
  • macOS : /Library/Application Support/ClaudeCode/CLAUDE.md
  • Linux/WSL : /etc/claude-code/CLAUDE.md
  • Windows : C:\ProgramData\ClaudeCode\CLAUDE.md
  1. Déployez via votre système de gestion de configuration (MDM, Group Policy, Ansible, etc.) pour assurer une distribution cohérente sur toutes les machines de développeur.

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 groupez les mémoires liées sous des en-têtes 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.