Guides/Claude Code utilise trop de mémoire

Claude Code utilise trop de mémoire ou de processeur sur un Mac ? Comment le trouver, et les récupérer

Atta 🐬

Fondateur de Vitals

Publié le

Demander à l’IA ChatGPT Claude Perplexity AI Mode Grok Markdown

En bref

Claude Code tourne dans votre terminal sous la forme d’un processus nommé claude, et en lance d’autres au fil de son travail : des serveurs MCP, des sous-agents, ainsi que les serveurs de dev et les tests qui lui servent à vérifier son travail. Deux choses le rendent lourd. Une session qui tourne depuis des heures peut grossir en mémoire et en processeur ; la quitter et la reprendre avec claude --resume la ramène à la normale. Et les processus qu’elle a lancés peuvent continuer de tourner une fois la session terminée. Trouvez-les dans le Moniteur d’activité en cherchant claude, node et mcp. Vitals, un moniteur système pour Mac, liste chaque processus qui travaille dans chaque dossier de projet : ce qu’une session a laissé derrière elle est bien en vue.

Comment trouver ce que Claude Code utilise

  1. 01 Ouvrez le Moniteur d’activité, cliquez sur Mémoire et tapez claude dans le champ de recherche. Chaque session en cours est une ligne. Une ligne qui utilise plusieurs gigaoctets, ou qui est occupée alors que vous ne lui demandez rien, est celle à relancer.
  2. 02 Choisissez Présentation → Toutes les opérations, hiérarchiquement. Ouvrez le triangle à côté de votre app de terminal pour voir chaque session avec, en dessous, tout ce qu’elle a lancé.
  3. 03 Relancez une session lourde : appuyez deux fois sur Control-C pour la quitter, puis lancez claude --resume dans le même dossier et choisissez la conversation. Elle reprend là où elle s’était arrêtée.
  4. 04 Videz le champ de recherche et cherchez mcp, puis node. Les lignes encore présentes après la fermeture de toutes les sessions Claude Code ont été laissées derrière.
  5. 05 Dans le Terminal, ps -axo pid,ppid,rss,etime,command | grep -i mcp les liste avec leur parent. Un parent égal à 1 signifie que la session qui a lancé le processus a disparu. Arrêtez-en un avec kill suivi de son numéro.

Dans Claude Code, /mcp liste les serveurs MCP qu’une session lance. Chacun est un processus à part entière ; supprimez ceux dont vous ne vous servez pas.

Claude Code est un programme en ligne de commande : il n’a donc pas de fenêtre à lui ni d’entrée dans le Dock, et son coût apparaît sous votre app de terminal, ou sous l’éditeur dans le terminal duquel vous le lancez. C’est aussi un programme qui lance d’autres programmes. Chaque serveur MCP est un processus, chaque sous-agent est un processus, et quand il lance vos tests ou démarre votre serveur de dev, ce sont encore des processus. L’essentiel de la mémoire reprochée à Claude Code se trouve dans ce qu’il a lancé. Le tableau fait le tri.

Où vont la mémoire et le processeur de Claude Code

Ce que vous voyezCe que c’estQue faire
claude utilise plusieurs Go Une session ouverte depuis des heures Quittez-la et lancez claude --resume
claude occupé au repos La même chose : les longues sessions ralentissent Relancez la session ; mettez Claude Code à jour
Beaucoup de processus node Des serveurs MCP, un par serveur et par session Supprimez les serveurs inutilisés avec /mcp
Des processus qui restent après la fermeture de toutes les sessions Des serveurs MCP, des sous-agents ou un navigateur sans interface qui ne se sont pas arrêtés Repérez-les à leur parent 1, et quittez-les
next-server, des tests ou une compilation à un % processeur élevé Quelque chose que Claude Code a lancé pour vérifier son travail Arrêtez-le, ou demandez à Claude Code de le faire

Les longues sessions grossissent

Une session garde toute sa conversation, chaque fichier qu’elle a lu et la sortie de chaque commande. Au fil des heures, cela s’accumule, et des utilisateurs ont signalé sur le suivi des bugs de Claude Code des sessions qui atteignaient de nombreux gigaoctets, ou qui occupaient un cœur du processeur au repos. Les signalements s’accordent sur la solution : quitter la session et la reprendre. La conversation est enregistrée au fur et à mesure : claude --resume ne perd donc rien et repart d’un processus propre.

Tenir Claude Code à jour compte plus qu’avec la plupart des outils. Les versions sortent souvent, et les problèmes de mémoire font partie de ce qui est corrigé d’une version à l’autre. claude update le met à jour.

Ce qu’une session laisse derrière elle

Quand une session se termine, les processus qu’elle a lancés sont censés se terminer avec elle. Ce n’est pas toujours le cas. Un serveur MCP, un sous-agent ou un navigateur sans interface peut perdre son parent et continuer, en gardant sa mémoire sans que rien ne s’en serve. Un développeur qui a écrit à ce sujet a compté 37 processus de ce genre occupant plus de 6 Go après une journée de travail.

Ils sont faciles à reconnaître une fois qu’on regarde : pas de terminal, un parent égal à 1, et une heure de lancement vieille de plusieurs heures. Vous pouvez les quitter sans risque. Un processus zombie, au sens strict, est autre chose : il est déjà terminé et n’utilise pas de mémoire. Ce qu’on appelle ici des zombies sont des orphelins, vivants et qui occupent de la mémoire.

Serveurs de dev, tests et compilations

Pour vérifier son travail, Claude Code démarre votre serveur de dev, lance vos tests ou compile le projet. Un serveur de dev qu’il a lancé en arrière-plan tourne encore une fois la tâche terminée, et après la fermeture de la session si rien ne l’a arrêté. Deux ou trois projets avec chacun un serveur de dev oublié, c’est une raison courante pour laquelle un Mac avec beaucoup de mémoire vient à en manquer.

Demandez à Claude Code d’arrêter ce qu’il a lancé avant de terminer une session, ou vérifiez quels ports sont en écoute : un serveur sur un port que vous n’utilisez pas est un serveur que personne n’utilise.

Plusieurs sessions à la fois

Faire tourner des agents en parallèle, un par tâche ou par branche, multiplie tout ce qui précède : chaque session a sa propre mémoire, sa propre copie de chaque serveur MCP et son propre serveur de dev. Sur un Mac de 16 Go, c’est la différence entre le confort et une pression sur la mémoire dans le jaune. Fermez les sessions qui ont terminé, et donnez aux serveurs des ports différents pour qu’un deuxième n’échoue pas en silence avant de réessayer.

Ce que Vitals apporte

Vitals montre ce que coûte chaque projet, y compris les processus qui n’appartiennent à aucune fenêtre.

  • Un onglet Projets : chaque processus qui travaille dans un dossier de projet, quel que soit le terminal ou l’éditeur qui l’a lancé, avec la mémoire, le processeur et l’énergie du projet dans son ensemble
  • Les ports sur lesquels chaque projet écoute. Les serveurs de dev restés lancés mais inactifs sont signalés, avec une proposition de les arrêter
  • Claude Code compté comme un seul outil d’une mise à jour à l’autre : sa mémoire sur la journée tient en une seule ligne
  • Une notification quand la mémoire d’une app grossit sans cesse ou qu’elle sollicite le processeur pendant plusieurs minutes
  • Quitter pour n’importe quelle app depuis la barre des menus, après vous l’avoir demandé

Bon à savoir

  • Vitals montre les processus et ce qu’ils utilisent. Il ne lit pas les conversations de Claude Code et ne sait pas sur quoi travaille une session.
  • Vitals ne quitte jamais rien de lui-même.
Obtenir Vitals pour $9 $9 pendant le lancement, $29 ensuite. Remboursement sous 14 jours.

Questions fréquentes

Pourquoi Claude Code utilise-t-il autant de mémoire ?

Une session ouverte depuis des heures grossit, et chaque serveur MCP, sous-agent et serveur de dev qu’elle lance est un processus à part entière. Quittez la session et lancez claude --resume pour reprendre à partir d’un processus propre.

Relancer Claude Code fait-il perdre ma conversation ?

Non. Les conversations sont enregistrées au fur et à mesure. Lancez claude --resume dans le même dossier et choisissez la conversation pour reprendre.

Pourquoi y a-t-il autant de processus node quand j’utilise Claude Code ?

La plupart sont des serveurs MCP : chaque serveur tourne dans son propre processus, une fois par session. Dans Claude Code, /mcp montre lesquels sont configurés.

Comment trouver les processus que Claude Code a laissés tourner ?

Fermez toutes les sessions, puis cherchez mcp et node dans le Moniteur d’activité. Dans le Terminal, ps -axo pid,ppid,rss,command montre le parent de chaque processus ; un parent égal à 1 signifie qu’il a été laissé derrière.

Peut-on quitter sans risque les processus de serveurs MCP qui restent ?

Oui, une fois qu’aucune session Claude Code n’est ouverte. Une session relance les serveurs dont elle a besoin à son prochain démarrage.

De combien de mémoire Claude Code a-t-il besoin ?

Une session neuve utilise quelques centaines de mégaoctets. Le reste dépend de ce qu’elle lance : des serveurs MCP, un serveur de dev, des tests. Plusieurs sessions en parallèle multiplient le tout.

Existe-t-il une app qui montre ce que Claude Code fait tourner sur mon Mac ?

Vitals a un onglet Projets qui liste chaque processus qui travaille dans chaque dossier de projet, avec sa mémoire, son processeur et ses ports, et signale les serveurs de dev restés inactifs.

Dans le lexique

Autres guides