Skip to main content
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 référentiel possède déjà un AGENTS.md pour d’autres agents de codage, Claude Code peut le lire seul ou aux côtés de CLAUDE.md. Le reste du répertoire est optionnel : ajoutez des skills, des rules ou des subagents 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.
Plusieurs choses peuvent remplacer ce que vous mettez dans ces fichiers :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. Lorsque les paramètres gérés définissent cleanupPeriodDays, Claude Code supprime à la place ces transcriptions après cette période. Nécessite Claude Code v2.1.248 ou ultérieur ; les versions antérieures les suppriment après cleanupPeriodDays.
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.

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 project 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

Le balayage de nettoyage de rétention ne supprime pas les chemins ci-dessous. Claude Code les conserve jusqu’à ce que vous les supprimiez, à l’exception des deux caches qu’il supprime lorsque vous vous déconnectez. D’autres fichiers apparaissent selon les fonctionnalités que vous utilisez. Les caches et les fichiers de verrouillage peuvent être supprimés en toute sécurité. Conservez ces fichiers d’état :

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 project 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. 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 :
Le plan énumère chaque élément correspondant et pourquoi il est inclus :
Supprimez avec une seule invite de confirmation :
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 :
Passez --all au lieu d’un chemin pour purger l’état de chaque projet à 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. Vous pouvez également supprimer manuellement l’un des chemins de données d’application ci-dessus, à l’exception des fichiers d’état à conserver. Les nouvelles sessions ne sont pas affectées. Le tableau ci-dessous montre ce que vous perdez pour les sessions passées. Ne supprimez pas ~/.claude.json, ~/.claude/settings.json ou ~/.claude/plugins/ : ceux-ci contiennent votre authentification, vos préférences et vos plugins installés.