Gérer la mémoire de Claude
Apprenez à gérer la mémoire de Claude Code à travers les sessions avec différents emplacements de mémoire et les meilleures pratiques.
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émoire | Emplacement | Objectif | Exemples de Cas d’Usage | Partagé Avec |
---|---|---|---|---|
Politique d’entreprise | macOS: /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/DevOps | Standards de codage d’entreprise, politiques de sécurité, exigences de conformité | Tous les utilisateurs de l’organisation |
Mémoire de projet | ./CLAUDE.md | Instructions partagées par l’équipe pour le projet | Architecture de projet, standards de codage, flux de travail communs | Membres de l’équipe via le contrôle de source |
Mémoire utilisateur | ~/.claude/CLAUDE.md | Préférences personnelles pour tous les projets | Préférences de style de code, raccourcis d’outils personnels | Vous seulement (tous les projets) |
Mémoire de projet (locale) | ./CLAUDE.local.md | Pré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 | Vous 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 :
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.
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.
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 #
:
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 :
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 :
- 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
- 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.