Comprendre ce qui grossit dans Claude Code sur Mac

Séparez les conversations, journaux de diagnostic et copies de récupération avant toute intervention sur ~/.claude. Les sessions et leurs fichiers associés peuvent être nécessaires pour reprendre un travail ; leur ancienneté ne suffit pas à les rendre jetables. Mesurez le dossier configuré, arrêtez les tâches actives et privilégiez les commandes de gestion prises en charge.

L’essentiel

  • Sessions. Conservez la conversation et ses fichiers associés.
  • Récupération. file-history peut servir à retrouver une version antérieure.
  • Configuration. CLAUDE_CONFIG_DIR peut déplacer le dossier de données.

Sessions, journaux et données de récupération

Par défaut, ~/.claude/projects/<chemin-encodé>/<uuid>.jsonl contient une session. Un dossier associé peut contenir résultats d’outils et sous-agents : ne le dissociez pas de la conversation sans comprendre sa fonction.

debug contient des journaux ; file-history/<session> conserve des données de récupération avant modification. settings.json, CLAUDE.md et les mémoires de projets ne sont pas des caches. Le cache du client peut aussi se trouver dans ~/Library/Caches/claude-cli-nodejs/.

Les chemins et règles de conservation dépendent de la version et de la configuration, notamment CLAUDE_CONFIG_DIR. Consultez les réglages de l’installation au lieu de supposer une durée de rétention universelle.

Claude Code : réglages officiels (anglais)

Claude Code : points de récupération (anglais)

Mesurer le dossier configuré

La commande ci-dessous trie les tailles des sous-dossiers sans modifier leur contenu. Arrêtez ensuite les tâches actives avant toute intervention et sauvegardez conversations, fichiers associés et historique de récupération nécessaires.

du -h -d 1 "${CLAUDE_CONFIG_DIR:-$HOME/.claude}" | sort -hr

Ce qu’une opération doit préserver

N’effacez pas projects ou file-history en bloc. Un journal de diagnostic dispensable, une conversation à reprendre et une copie de récupération demandent des décisions différentes. Vérifiez les fonctions de gestion de la version installée et ouvrez une session utile après une opération.

Un déplacement vers la Corbeille conserve encore l’occupation disque. Vider la Corbeille devient une suppression définitive ; ne l’utilisez pas pour transformer une estimation de scan en gain supposé.

Examiner le volume et l’action proposée

Mint affiche les données par agent et par catégorie. Examinez le périmètre de chaque élément et les protections appliquées aux tâches actives. Le retrait de médias et la suppression de conversations sont des choix permanents, distincts d’une optimisation qui conserve le contenu.

Vérifiez les fonctions de votre édition et version. Un résultat de scan aide à décider ; il ne garantit pas que toutes les données listées soient dispensables ni qu’un volume précis sera récupéré.

Gérer le stockage de plusieurs outils IA

Questions fréquentes

Puis-je supprimer ~/.claude pour repartir à zéro ?

Ce dossier mélange paramètres, conversations, mémoires et récupération. Préférez les fonctions prises en charge par Claude Code et sauvegardez ce qui doit rester. Une remise à zéro n’est pas un simple nettoyage de cache.

Repérer ce qui grossit dans Claude Code

Examinez localement les catégories avant de choisir une action.

Analyser le stockage