Guías/Claude Code usa demasiada memoria

¿Claude Code usa demasiada memoria o CPU en un Mac? Cómo encontrarlo y recuperarla

Atta 🐬

Fundador de Vitals

Publicado

Pregunta a la IA ChatGPT Claude Perplexity AI Mode Grok Markdown

Respuesta rápida

Claude Code se ejecuta en tu terminal como un proceso llamado claude, e inicia otros mientras trabaja: servidores MCP, subagentes, y los servidores de desarrollo y las pruebas que usa para comprobar su trabajo. Dos cosas lo hacen pesado. Una sesión que lleva horas en marcha puede crecer en memoria y en CPU; salir y reanudarla con claude --resume la devuelve a lo normal. Y los procesos que inició pueden seguir en marcha después de que termine la sesión. Encuéntralos en Monitor de Actividad buscando claude, node y mcp. Vitals, un monitor del sistema para Mac, muestra todos los procesos que trabajan en cada carpeta de proyecto, así que lo que una sesión dejó atrás queda a la vista.

Cómo saber qué está usando Claude Code

  1. 01 Abre Monitor de Actividad, haz clic en Memoria y escribe claude en el campo de búsqueda. Cada sesión en marcha es una fila. La que hay que reiniciar es la fila que usa varios gigabytes, o la que está ocupada sin que le estés pidiendo nada.
  2. 02 Elige Visualización → Todos los procesos, jerárquicamente. Abre el triángulo junto a tu app de terminal para ver cada sesión con todo lo que inició debajo.
  3. 03 Reinicia una sesión pesada: pulsa Control-C dos veces para salir, luego ejecuta claude --resume en la misma carpeta y elige la conversación. Sigue donde se quedó.
  4. 04 Borra el campo de búsqueda y busca mcp, y después node. Las filas que sigan ahí después de cerrar todas las sesiones de Claude Code se quedaron atrás.
  5. 05 En Terminal, ps -axo pid,ppid,rss,etime,command | grep -i mcp los muestra con su proceso principal. Un proceso principal 1 significa que la sesión que inició el proceso ya no existe. Detén uno con kill seguido de su número.

En Claude Code, /mcp muestra los servidores MCP que inicia una sesión. Cada uno es un proceso aparte; elimina los que no uses.

Claude Code es un programa de línea de comandos, así que no tiene ventana propia ni aparece en el Dock: su coste aparece bajo tu app de terminal, o bajo el editor en cuyo terminal lo ejecutas. También es un programa que inicia otros programas. Cada servidor MCP es un proceso, cada subagente es un proceso, y cuando ejecuta tus tests o inicia tu servidor de desarrollo, eso también son procesos. La mayor parte de la memoria que la gente achaca a Claude Code está en lo que inició. La tabla aclara qué es cada cosa.

Adónde van la memoria y la CPU de Claude Code

Lo que vesQué esQué hacer
claude usa varios GB Una sesión que lleva horas abierta Sal y ejecuta claude --resume
claude ocupado sin hacer nada Lo mismo: las sesiones largas se ralentizan Reinicia la sesión; actualiza Claude Code
Muchos procesos node Servidores MCP, uno por servidor y por sesión Elimina los servidores que no uses con /mcp
Procesos que quedan después de cerrar todas las sesiones Servidores MCP, subagentes o un navegador sin ventana que no se detuvo Búscalos por el proceso principal 1 y ciérralos
next-server, un ejecutor de tests o una compilación con mucha CPU Algo que Claude Code inició para comprobar su trabajo Detenlo, o pídele a Claude Code que lo haga

Las sesiones largas crecen

Una sesión guarda toda su conversación, cada archivo que ha leído y el resultado de cada comando. Con las horas eso se acumula, y en el gestor de incidencias de Claude Code hay quien ha informado de sesiones que llegaron a muchos gigabytes, o que mantenían ocupado un núcleo de la CPU sin hacer nada. Todos coinciden en la solución: salir de la sesión y reanudarla. La conversación se guarda sobre la marcha, así que claude --resume no pierde nada y empieza con un proceso limpio.

Mantener Claude Code actualizado importa más que con la mayoría de las herramientas. Sale una versión nueva a menudo, y los problemas de memoria están entre lo que se corrige de una versión a otra. claude update lo actualiza.

Lo que una sesión deja atrás

Cuando una sesión termina, los procesos que inició deberían terminar con ella. No siempre lo hacen. Un servidor MCP, un subagente o un navegador sin ventana puede perder su proceso principal y seguir adelante, reteniendo su memoria sin que nada lo use. Un desarrollador que escribió sobre ello contó 37 procesos así, con más de 6 GB, después de un día de trabajo.

Son fáciles de reconocer en cuanto miras: sin terminal, con el proceso principal 1 y una hora de inicio de hace horas. Se pueden cerrar sin peligro. Un proceso zombi, en sentido estricto, es otra cosa: ya ha terminado y no usa memoria. Lo que aquí la gente llama zombis son huérfanos, vivos y reteniendo memoria.

Servidores de desarrollo, tests y compilaciones

Para comprobar su trabajo, Claude Code inicia tu servidor de desarrollo, ejecuta tus tests o compila el proyecto. Un servidor de desarrollo que inició en segundo plano sigue sirviendo cuando la tarea ha terminado, y también después de cerrar la sesión si nada lo detuvo. Dos o tres proyectos, cada uno con un servidor de desarrollo olvidado, son un motivo habitual de que a un Mac con memoria de sobra le acabe faltando.

Pídele a Claude Code que detenga lo que inició antes de terminar una sesión, o mira qué puertos están a la escucha: un servidor en un puerto que no usas es un servidor que no usa nadie.

Varias sesiones a la vez

Ejecutar agentes en paralelo, uno por tarea o por rama, multiplica todo lo anterior: cada sesión tiene su propia memoria, su propia copia de cada servidor MCP y su propio servidor de desarrollo. En un Mac de 16 GB, esa es la diferencia entre ir holgado y tener la presión de memoria en amarillo. Cierra las sesiones que han terminado, y da a los servidores puertos distintos para que el segundo no falle y lo reintente sin avisar.

Lo que añade Vitals

Vitals muestra lo que cuesta cada proyecto, incluidos los procesos que no pertenecen a ninguna ventana.

  • Una pestaña Proyectos: todos los procesos que trabajan en una carpeta de proyecto, los haya iniciado el terminal o el editor que sea, con la memoria, la CPU y la energía del proyecto en conjunto
  • Los puertos en los que escucha cada proyecto. Se señalan los servidores de desarrollo que se quedaron en marcha sin hacer nada, y se ofrece detenerlos
  • Claude Code cuenta como una sola herramienta aunque se actualice, así que su memoria a lo largo del día es una sola línea
  • Una notificación cuando la memoria de una app no para de crecer o la app acapara la CPU durante minutos
  • “Salir” para cualquier app desde la barra de menús, después de preguntarte

Conviene saberlo

  • Vitals muestra los procesos y lo que usan. No lee las conversaciones de Claude Code ni sabe en qué está trabajando una sesión.
  • Vitals nunca cierra nada por su cuenta.
Consigue Vitals por $9 $9 durante el lanzamiento, $29 después. Reembolso en 14 días.

Preguntas frecuentes

¿Por qué Claude Code usa tanta memoria?

Una sesión que lleva horas abierta crece, y cada servidor MCP, subagente y servidor de desarrollo que inicia es un proceso aparte. Sal de la sesión y ejecuta claude --resume para seguir con un proceso limpio.

¿Pierdo mi conversación si reinicio Claude Code?

No. Las conversaciones se guardan sobre la marcha. Ejecuta claude --resume en la misma carpeta y elige la conversación para seguir.

¿Por qué hay tantos procesos node cuando uso Claude Code?

La mayoría son servidores MCP: cada servidor se ejecuta como un proceso propio, una vez por sesión. En Claude Code, /mcp muestra cuáles están configurados.

¿Cómo encuentro los procesos que Claude Code dejó en marcha?

Cierra todas las sesiones y busca mcp y node en Monitor de Actividad. En Terminal, ps -axo pid,ppid,rss,command muestra el proceso principal de cada proceso; un proceso principal 1 significa que se quedó atrás.

¿Es seguro cerrar los procesos de servidores MCP que se quedaron?

Sí, cuando no haya ninguna sesión de Claude Code abierta. Una sesión vuelve a iniciar los servidores que necesita la próxima vez que se ejecuta.

¿Cuánta memoria necesita Claude Code?

Una sesión recién abierta usa unos cientos de megabytes. El resto depende de lo que inicie: servidores MCP, un servidor de desarrollo, unas pruebas. Varias sesiones en paralelo lo multiplican todo.

¿Hay alguna app que muestre lo que Claude Code tiene en marcha en mi Mac?

Vitals tiene una pestaña Proyectos que muestra todos los procesos que trabajan en cada carpeta de proyecto, con su memoria, su CPU y sus puertos, y señala los servidores de desarrollo que se quedaron inactivos.

En el glosario

Más guías