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. 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 :
  • Les paramètres gérés déployés par votre organisation ont la priorité sur tout
  • 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.

​
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 de fichiers, sortie de commande, texte collé.

​
Nettoyés automatiquement

Les fichiers dans les chemins ci-dessous sont supprimés au démarrage une fois qu’ils sont plus anciens que cleanupPeriodDays. La valeur par défaut est 30 jours.

​
Conservés jusqu’à ce que vous les supprimiez

Les chemins suivants ne sont pas couverts par le nettoyage automatique et persistent indéfiniment. D’autres petits fichiers de cache et de verrouillage apparaissent selon les fonctionnalités que vous utilisez et peuvent être supprimés en toute sécurité.

​
Stockage en texte brut

Les transcriptions et l’historique ne sont pas chiffrés au repos. Les permissions de fichiers du système d’exploitation sont la seule protection. Si un outil lit un fichier .env ou qu’une commande imprime une credential, cette valeur est écrite dans projects/<project>/<session>.jsonl. Pour réduire l’exposition :
  • Réduisez cleanupPeriodDays pour raccourcir la durée de conservation des transcriptions
  • 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 aux côtés de -p, ou définir persistSession: false dans le SDK Agent.
  • Utilisez les règles de permissions pour refuser les lectures des fichiers de credentials

​
Effacer les données locales

Exécutez claude project purge pour supprimer l’état que Claude Code maintient pour un projet. La commande nécessite Claude Code v2.1.124 ou version ultérieure. Elle 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
La commande affiche le plan de suppression complet et demande une confirmation avant de supprimer quoi que ce soit. Prévisualisez le plan sans supprimer quoi que ce soit :
Supprimez avec une seule invite de confirmation :
Omettez le chemin pour choisir un projet dans une liste interactive. Ignorez l’invite de confirmation pour une utilisation dans les scripts :
Passez --all à la place d’un chemin pour purger l’état de tous les projets à la fois, ce qui supprime history.jsonl complètement 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 à un projet, et les avertit dans la sortie du plan. Elle se termine avec le statut 1 si aucun état ne correspond au chemin donné. Vous pouvez également supprimer manuellement l’un des chemins de données d’application ci-dessus. 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.