~/.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 :| Fichier | Emplacement | Objectif |
|---|---|---|
managed-settings.json | Au niveau du système, varie selon le système d’exploitation | Paramètres appliqués par l’entreprise que vous ne pouvez pas remplacer. Consultez paramètres gérés par le serveur. |
CLAUDE.local.md | Racine du projet | Vos préférences privées pour ce projet, chargées aux côtés de CLAUDE.md. Créez-le manuellement et ajoutez-le à .gitignore. |
| Plugins installés | ~/.claude/plugins | Marchés clonés, versions de plugins installées et données par plugin, gérées par les commandes claude plugin. Les versions orphelines sont supprimées 7 jours après une mise à jour ou une désinstallation de plugin. Consultez mise en cache des plugins. |
~/.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.| Vous voulez | Modifier | Portée | Référence |
|---|---|---|---|
| Donner à Claude le contexte et les conventions du projet | CLAUDE.md | projet ou global | Mémoire |
| Autoriser ou bloquer des appels d’outils spécifiques | settings.json permissions ou hooks | projet ou global | Permissions, Hooks |
| Exécuter un script avant ou après les appels d’outils | settings.json hooks | projet ou global | Hooks |
| Définir les variables d’environnement pour la session | settings.json env | projet ou global | Paramètres |
| Garder les remplacements personnels hors de git | settings.local.json | projet uniquement | Portées des paramètres |
Ajouter une invite ou une capacité que vous invoquez avec /name | skills/<name>/SKILL.md | projet ou global | Skills |
| Définir un subagent spécialisé avec ses propres outils | agents/*.md | projet ou global | Subagents |
| Orchestrer de nombreux subagents à partir d’un script | workflows/*.js | projet ou global | Workflows dynamiques |
| Connecter des outils externes via MCP | .mcp.json | projet uniquement | MCP |
| Modifier la façon dont Claude formate les réponses | output-styles/*.md | projet ou global | Styles de sortie |
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-modeou--settingsremplacentsettings.jsonpour 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
| Fichier | Portée | Valider | Ce qu’il fait | Référence |
|---|---|---|---|---|
CLAUDE.md | Projet et global | ✓ | Instructions chargées à chaque session | Mémoire |
rules/*.md | Projet et global | ✓ | Instructions limitées à un sujet, optionnellement limitées par chemin | Rules |
settings.json | Projet et global | ✓ | Permissions, hooks, variables d’environnement, paramètres par défaut du modèle | Paramètres |
settings.local.json | Projet uniquement | Vos remplacements personnels, auto-gitignorés | Portées des paramètres | |
.mcp.json | Projet uniquement | ✓ | Serveurs MCP partagés par l’équipe | Portées MCP |
.worktreeinclude | Projet uniquement | ✓ | Fichiers gitignorés à copier dans les nouveaux worktrees | Worktrees |
skills/<name>/SKILL.md | Projet et global | ✓ | Invites réutilisables invoquées avec /name ou auto-invoquées | Skills |
commands/*.md | Projet et global | ✓ | Invites sur un seul fichier ; même mécanisme que les skills | Skills |
output-styles/*.md | Projet et global | ✓ | Sections de système-prompt personnalisées | Styles de sortie |
agents/*.md | Projet et global | ✓ | Définitions de subagents avec leur propre invite et outils | Subagents |
workflows/*.js | Projet et global | ✓ | Scripts de flux de travail dynamiques écrits par Claude et enregistrés à partir de /workflows ; chaque fichier devient une commande /<name> | Flux de travail dynamiques |
agent-memory/<name>/ | Projet et global | ✓ | Mémoire persistante pour les subagents | Mémoire persistante |
~/.claude.json | Global uniquement | État de l’application, OAuth, bascules d’interface utilisateur, serveurs MCP personnels | Configuration globale | |
projects/<project>/memory/ | Global uniquement | Auto memory : notes de Claude à lui-même entre les sessions | Auto memory | |
keybindings.json | Global uniquement | Raccourcis clavier personnalisés | Keybindings | |
themes/*.json | Global uniquement | Thèmes de couleurs personnalisés | Thèmes personnalisés |
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 quecleanupPeriodDays. La valeur par défaut est 30 jours.
Chemin sous ~/.claude/ | Contenu |
|---|---|
projects/<project>/<session>.jsonl | Transcription complète de la conversation : chaque message, appel d’outil et résultat d’outil |
projects/<project>/<session>/subagents/ | Transcriptions de conversation des sous-agents, supprimées avec la transcription de session parente lorsqu’elle expire |
projects/<project>/<session>/tool-results/ | Les grandes sorties d’outils sont versées dans des fichiers séparés |
file-history/<session>/ | Instantanés pré-édition des fichiers que Claude a modifiés, utilisés pour restauration de checkpoint |
plans/ | Fichiers de plan écrits pendant le mode plan |
debug/ | Journaux de débogage par session, écrits uniquement lorsque vous démarrez avec --debug ou exécutez /debug |
paste-cache/, image-cache/ | Contenu des grands collages et images jointes |
session-env/ | Métadonnées d’environnement par session |
tasks/ | Listes de tâches par session écrites par les outils de tâche |
shell-snapshots/ | Environnement shell capturé utilisé par l’outil Bash. Supprimé à la fermeture correcte. Le balayage efface tout ce qui reste après un crash. |
backups/ | Copies horodatées de ~/.claude.json prises avant les migrations de configuration |
feedback-bundles/ | Archives de transcription expurgées écrites par /feedback sur les fournisseurs tiers, pour envoi à votre équipe de compte Anthropic |
todos/, statsig/, logs/ | Répertoires hérités des versions plus anciennes. Ne sont plus écrits. Le balayage supprime leur contenu puis le répertoire vide. |
Conservés jusqu’à ce que vous les supprimiez
Les chemins suivants ne sont pas couverts par le nettoyage automatique et persistent indéfiniment.Chemin sous ~/.claude/ | Contenu |
|---|---|
history.jsonl | Chaque invite que vous avez tapée, avec horodatage et chemin du projet. Utilisé pour le rappel de la flèche vers le haut. |
stats-cache.json | Nombres de tokens et de coûts agrégés affichés par /usage |
remote-settings.json | Copie en cache des paramètres gérés par le serveur pour votre organisation. Présent uniquement lorsque votre organisation les a configurés. Actualisé à chaque lancement. |
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
cleanupPeriodDayspour raccourcir la durée de conservation des transcriptions - Définissez la variable d’environnement
CLAUDE_CODE_SKIP_PROMPT_HISTORYpour 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-persistenceaux côtés de-p, ou définirpersistSession: falsedans le SDK Agent. - Utilisez les règles de permissions pour refuser les lectures des fichiers de credentials
Effacer les données locales
Exécutezclaude 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/etfile-history/par session - Lignes d’invite correspondantes dans
history.jsonl - L’entrée du projet dans
~/.claude.json
--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.
| Supprimer | Vous perdez |
|---|---|
~/.claude/projects/ | Reprendre, continuer et rembobiner pour les sessions passées |
~/.claude/history.jsonl | Rappel d’invite de la flèche vers le haut |
~/.claude/file-history/ | Restauration de checkpoint pour les sessions passées |
~/.claude/stats-cache.json | Totaux historiques affichés par /usage |
~/.claude/remote-settings.json | Rien. Récupéré à nouveau au prochain lancement. |
~/.claude/debug/, ~/.claude/plans/, ~/.claude/paste-cache/, ~/.claude/image-cache/, ~/.claude/session-env/, ~/.claude/tasks/, ~/.claude/shell-snapshots/, ~/.claude/backups/ | Rien d’orienté utilisateur |
~/.claude/todos/, ~/.claude/statsig/, ~/.claude/logs/ | Rien. Répertoires hérités non écrits par les versions actuelles. |
~/.claude.json, ~/.claude/settings.json ou ~/.claude/plugins/ : ceux-ci contiennent votre authentification, 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