Explorez le répertoire .claude

Où Claude Code lit CLAUDE.md, settings.json, hooks, skills, commands, subagents, workflows, rules et auto memory. Explorez le répertoire .claude dans votre projet et ~/.claude dans votre répertoire personnel.

Claude Code lit les instructions, les paramètres, les skills, les subagents et la mémoire à partir de votre répertoire de projet et de ~/.claude dans votre répertoire personnel. Validez les fichiers du projet dans git pour les partager avec votre équipe ; les fichiers dans ~/.claude sont une configuration personnelle qui s'applique à tous vos projets.

Sur Windows, ~/.claude se résout en %USERPROFILE%\.claude. Si vous définissez CLAUDE_CONFIG_DIR, chaque chemin ~/.claude sur cette page se trouve sous ce répertoire à la place.

La plupart des utilisateurs ne modifient que CLAUDE.md et settings.json. Si votre dépôt possède déjà un AGENTS.md pour d'autres agents de codage, Claude Code peut le lire à la place d'un CLAUDE.md. Le reste du répertoire est optionnel : ajoutez des skills, des règles ou des sous-agents selon vos besoins.

Explorez le répertoire

Cliquez sur les fichiers dans l'arborescence pour voir ce que chacun fait, quand il se charge et un exemple.

Ce qui n'est pas affiché

L'explorateur couvre les fichiers que vous créez et modifiez. Quelques fichiers connexes se trouvent ailleurs :

~/.claude contient également les données que Claude Code écrit au fur et à mesure que vous travaillez : transcriptions, historique des invites, instantanés de fichiers, caches et journaux. Consultez données d'application ci-dessous.

Choisissez le bon fichier

Différents types de personnalisation se trouvent dans différents fichiers. Utilisez ce tableau pour trouver où une modification appartient.

Référence des fichiers

Ce tableau répertorie tous les fichiers que l'explorateur couvre. Les fichiers au niveau du projet se trouvent dans votre dépôt sous .claude/ (ou à la racine pour CLAUDE.md, .mcp.json et .worktreeinclude). Les fichiers au niveau global se trouvent dans ~/.claude/ et s'appliquent à tous les projets.

[!NOTE]

Plusieurs choses peuvent remplacer ce que vous mettez dans ces fichiers :

• Les paramètres gérés déployés par votre organisation ont la priorité sur chaque fichier de paramètres et chaque valeur --settings, à l'exception des exceptions décrites sous Priorité des paramètres
• Les flags CLI comme --permission-mode ou --settings remplacent settings.json pour cette session
• Certaines variables d'environnement ont la priorité sur leur paramètre équivalent, mais cela varie : consultez la référence des variables d'environnement pour chacune

Consultez précédence des paramètres pour l'ordre complet.

Cliquez sur un nom de fichier pour ouvrir ce nœud dans l'explorateur ci-dessus.

Champs de frontmatter par fichier

Les compétences, fichiers de commandes, sous-agents, styles de sortie et règles lisent leur configuration à partir du frontmatter YAML en haut du fichier, et chacun accepte son propre ensemble de champs. Ce tableau répertorie les noms de champs pour chaque fichier et établit des liens vers la référence qui les décrit.

Les agents fournis dans un plugin respectent un sous-ensemble des champs de sous-agent.

Dépannez votre configuration

Si un paramètre, un hook ou un fichier ne prend pas effet, consultez Déboguez votre configuration pour les commandes d'inspection et un tableau de recherche basé sur les symptômes.

Données d'application

Au-delà de la configuration que vous créez, ~/.claude contient les données que Claude Code écrit pendant les sessions. Ces fichiers sont en texte brut. Tout ce qui passe par un outil se retrouve dans une transcription sur disque : contenu des fichiers, sortie de commande, texte collé.

Nettoyés automatiquement

Claude Code supprime les fichiers dans les chemins ci-dessous une fois qu'ils sont plus anciens que cleanupPeriodDays, tant qu'il peut déterminer en toute sécurité la période de rétention. La valeur par défaut est 30 jours et le minimum est 1 ; définir 0 échoue avec une erreur de validation. Le même seuil d'âge s'applique à la suppression automatique des worktrees orphelins.

Les fichiers de session dans sessions/, la mémoire automatique, et les transcriptions Claude Desktop et Cowork suivent chacun leur propre règle de rétention :

• sessions/ : contient un petit fichier par session en cours d'exécution, utilisé pour détecter les sessions concurrentes et les crashes. Il ne fait pas partie du balayage basé sur l'âge : Claude Code supprime chaque fichier lorsque sa session se termine et efface les restes de crash au prochain lancement.

• Mémoire automatique : le balayage ne supprime pas les fichiers de mémoire dans le répertoire de mémoire automatique d'un projet, projects/<project>/memory/. Claude Code supprime ce répertoire uniquement s'il a été vide pendant toute la période de rétention. Avant v2.1.228, le balayage traitait les dossiers à l'intérieur du répertoire de mémoire comme des données de session et pouvait supprimer les anciens fichiers en dessous.

• Transcriptions Claude Desktop et Cowork : Claude Code conserve la transcription d'une session que vous avez démarrée ou continuée le plus récemment dans Claude Desktop ou Cowork à tout âge. Pour donner à ces transcriptions une limite d'âge, définissez desktopSessionCleanupPeriodDays. Nécessite Claude Code v2.1.248 ou ultérieur ; les versions antérieures les suppriment après cleanupPeriodDays.

  Claude Code supprime plutôt ces transcriptions après cleanupPeriodDays dans l'un ou l'autre de ces cas :

  • Les paramètres gérés définissent cleanupPeriodDays
  • La configuration HIPAA s'applique à vos sessions

Claude Code ignore le balayage basé sur l'âge dans ces cas :

• Mode bare : lorsque vous exécutez claude -p avec --bare, Claude Code n'exécute pas le balayage dans cette session.
• Balayage en pause : si Claude Code ne peut pas déterminer en toute sécurité la période de rétention, il met en pause le balayage de nettoyage de rétention ; l'événement retention_sweep énumère chaque configuration qui le met en pause. Lorsque la cause est un fichier de paramètres qui ne peut pas être lu ou analysé, ou des erreurs de paramètres avec cleanupPeriodDays ou desktopSessionCleanupPeriodDays explicitement définis, Claude Code affiche également un avertissement dans /status jusqu'à ce que vous corrigiez les erreurs de paramètres. Lorsque les paramètres gérés fournissent cleanupPeriodDays, Claude Code exécute le balayage à la valeur gérée dans les deux cas.

Pour vérifier que les machines de votre organisation exécutent le balayage avec la période de rétention que vous avez définie, consultez Vérifier le balayage de rétention.

Répertoire de bloc-notes de session

Le bloc-notes est un répertoire par session que Claude Code fournit à Claude pour les fichiers temporaires : résultats intermédiaires, scripts d'aide et brouillons qui n'appartiennent pas à votre projet. Lorsque Claude dit qu'il a enregistré quelque chose « dans le bloc-notes », le fichier s'y trouve. Claude l'utilise à la place de /tmp, et peut créer, modifier et lire des fichiers dedans sans invite de permission.

Le bloc-notes se trouve sous le répertoire temporaire de Claude Code plutôt que sous ~/.claude. Trouvez le chemin de la session actuelle pour votre plateforme :

• macOS : /private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/
• Linux : /tmp/claude-<uid>/<project>/<session-id>/scratchpad/, ou la même forme sous $TMPDIR lorsque votre système en définit un
• Windows : %TEMP%\claude\<project>\<session-id>\scratchpad\

<project> est le chemin de votre répertoire de travail avec chaque caractère autre que les lettres et les chiffres remplacé par -, par exemple -Users-you-my-project. Si vous définissez CLAUDE_CODE_TMPDIR, l'arborescence se déplace sous ce répertoire à la place. Les hooks reçoivent le chemin de la session actuelle en tant que scratchpad_dir.

Les fichiers du bloc-notes durent aussi longtemps que la transcription de la session : le balayage de rétention supprime le répertoire lorsqu'il supprime la transcription, et claude purge ne touche pas au répertoire temporaire. Parce que le répertoire se trouve sous l'emplacement temporaire du système, votre système d'exploitation peut également le supprimer, par exemple au redémarrage. Pour conserver quelque chose que Claude a écrit là, demandez à Claude de le déplacer dans votre projet.

Une session a un bloc-notes uniquement lorsque tous ces éléments sont vrais :

• Vous êtes connecté avec un compte claude.ai plutôt qu'une clé API
• La session utilise l'API Anthropic, pas Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry
• enableArtifact n'est pas défini sur false

Conservés jusqu'à ce que vous les supprimiez

À l'exception des lignes qui indiquent le contraire, le balayage de nettoyage de rétention ne supprime pas les chemins ci-dessous, et Claude Code les conserve jusqu'à ce que vous les supprimiez.

Fichiers d'état à conserver

Selon les fonctionnalités que vous utilisez, ~/.claude/ contient également des fichiers que les tableaux de la section Données d'application ne répertorient pas. Parmi ceux-ci, les caches et les fichiers de verrouillage peuvent être supprimés en toute sécurité. Conservez ces fichiers d'état :

• .credentials.json : vos identifiants de connexion
• agent-memory/ : mémoire subagent
• jobs/ et daemon/ : état de session en arrière-plan

Stockage en texte brut

Les transcriptions et l'historique ne sont pas chiffrés au repos. Les permissions de fichier du système d'exploitation sont la seule protection. Si un outil lit un fichier .env ou une commande imprime une identifiant, cette valeur est écrite dans projects/<project>/<session>.jsonl. Pour réduire l'exposition :

• Réduisez cleanupPeriodDays pour raccourcir la durée pendant laquelle Claude Code conserve les transcriptions
• Définissez desktopSessionCleanupPeriodDays pour donner également une limite d'âge aux transcriptions Claude Desktop et Cowork
• Définissez la variable d'environnement CLAUDE_CODE_SKIP_PROMPT_HISTORY pour ignorer l'écriture des transcriptions et de l'historique des invites dans n'importe quel mode. En mode non interactif, vous pouvez à la place passer --no-session-persistence à côté de -p, ou définir persistSession: false dans le SDK TypeScript Agent ; le SDK Python n'a pas d'option équivalente.
• Utilisez les règles de permission pour refuser les lectures des fichiers d'identifiants

Effacer les données locales

Exécutez claude purge pour supprimer l'état que Claude Code conserve pour un projet. Il supprime :

• Transcriptions et mémoire automatique sous projects/
• Entrées tasks/, debug/ et file-history/ par session
• Lignes d'invite correspondantes dans history.jsonl
• L'entrée du projet dans ~/.claude.json

Les images que vous avez collées ou jointes dans les sessions du projet et le bloc-notes de chaque session sont stockés sous le répertoire temporaire de Claude Code plutôt que sous ~/.claude, donc le purge ne les supprime pas. Le balayage de rétention supprime toujours les images une fois qu'elles sont plus anciennes que cleanupPeriodDays ; le bloc-notes d'une session purgée reste jusqu'à ce que vous le supprimiez ou que votre système d'exploitation efface le répertoire temporaire.

La commande imprime le plan de suppression complet et demande une confirmation avant de supprimer quoi que ce soit.

Avant v2.1.288, la commande était claude project purge.

Les exemples ci-dessous utilisent ~/work/my-repo comme espace réservé. Remplacez-le par le chemin de votre projet. Si aucun état ne correspond au chemin, la commande imprime une erreur et se termine avec le statut 1.

Prévisualisez le plan sans rien supprimer :

claude purge ~/work/my-repo --dry-run

Le plan énumère chaque élément correspondant et pourquoi il est inclus :

Purge plan for /home/user/work/my-repo:

  dir:    /home/user/.claude/projects/-home-user-work-my-repo
           project transcripts (.jsonl) and memory/
  config: projects["/home/user/work/my-repo"]
           project entry in ~/.claude.json (trust, history, MCP servers)
  filter: /home/user/.claude/history.jsonl
           12 prompt(s) typed in this project

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/home/user/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 3 item(s) would be deleted.

Supprimez avec une seule invite de confirmation :

claude purge ~/work/my-repo

La commande imprime le même plan, puis demande Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] et supprime uniquement si vous répondez y.

Omettez le chemin pour choisir un projet dans une liste interactive.

Ignorez l'invite de confirmation pour utilisation dans les scripts :

claude purge ~/work/my-repo --yes

Autres options :

• Passez --all au lieu d'un chemin pour purger l'état de tous les projets à la fois, ce qui supprime history.jsonl directement plutôt que de le filtrer.
• Passez -i pour parcourir le plan de suppression un élément à la fois.

La commande laisse shell-snapshots/ et backups/ seuls car ceux-ci ne sont pas limités au projet, et les avertit dans la sortie du plan. Si quelqu'un a exécuté /heapdump sur la machine, supprimez également les fichiers .heapsnapshot qu'il a écrits. Un snapshot de heap contient la conversation complète et tous les identifiants que le processus détenait, et ni le balayage de rétention ni la purge n'y touchent.

Vous pouvez également supprimer manuellement l'un des chemins de données d'application ci-dessus, à l'exception des fichiers d'état à conserver.

Ne supprimez pas ~/.claude.json, ~/.claude/settings.json ou ~/.claude/plugins/ : ceux-ci contiennent les informations de votre compte, vos préférences et vos plugins installés.

Ressources connexes

• Gérez la mémoire de Claude : écrivez et organisez CLAUDE.md, rules et auto memory
• Configurez les paramètres : définissez les permissions, hooks, variables d'environnement et paramètres par défaut du modèle
• Créez des skills : créez des invites et des workflows réutilisables
• Configurez les subagents : définissez des agents spécialisés avec leur propre contexte