El espacio que ocupa Claude Code en tu Mac: sesiones, registros y qué conservar
Las sesiones, los registros de depuración y las instantáneas de archivos cumplen funciones distintas, así que mide cada uno antes de decidir qué eliminar. Una carpeta grande puede contener historial de conversaciones o datos de recuperación que necesitas.
En resumen
- Respuesta corta. Las sesiones, los registros de depuración y las instantáneas de archivos cumplen funciones distintas, así que mide cada uno antes de eliminar nada.
- Cuidado con esto. Borrar una transcripción elimina la conversación. Una carpeta grande puede contener historial o datos de recuperación que necesitas.
- Con Mint. Mint muestra el almacenamiento de Claude en la pestaña Disk. Un tamaño medido no es una invitación a limpiar.
Qué hay dentro de ~/.claude
Cada sesión es un archivo en ~/.claude/projects/<encoded-path>/<uuid>.jsonl y puede incluir imágenes insertadas. Algunas sesiones tienen además una carpeta asociada con el mismo nombre, que puede guardar resultados de herramientas y transcripciones de subagentes. Esa carpeta y su archivo de sesión van juntos.
Los registros que se escriben con la depuración activada van a ~/.claude/debug/. En ~/.claude/file-history/<session>/ se guardan instantáneas de tus archivos tomadas antes de editarlos, para poder volver a un punto de control. Si las borras, pierdes esas copias de recuperación.
Conserva tus archivos de configuración y de memoria, entre ellos settings.json, CLAUDE.md y las carpetas de memoria de los proyectos. La caché de la CLI también puede estar fuera de esta carpeta, en ~/Library/Caches/claude-cli-nodejs/.
Claude Code elimina por su cuenta algunos datos de la aplicación según sus reglas de retención. Lo que elimina depende de la versión, de tu configuración y de lo que active la limpieza, así que consulta la documentación actual de Claude Code sobre esta carpeta en lugar de suponer que nunca se borra nada. Si CLAUDE_CONFIG_DIR está definida, usa esa ubicación en lugar de ~/.claude.
Primero mide, luego revisa
Para comparar las carpetas de primer nivel, ejecuta este comando de solo lectura: du -h -d 1 "${CLAUDE_CONFIG_DIR:-$HOME/.claude}" | sort -hr
Si du muestra errores de permisos o de rutas que no existen, los totales están incompletos. En cualquier caso, du te dice dónde se va el espacio, pero no qué se puede borrar sin riesgo.
- Antes de tocar sus archivos, detén cualquier tarea de Claude que esté en marcha, incluidas las sesiones abiertas en otras ventanas de terminal.
- Haz una copia de seguridad de las conversaciones y los datos de recuperación que todavía necesites.
- Revisa los registros de depuración por separado de las sesiones y elimina un registro solo cuando ya no lo necesites para diagnosticar un problema. Las cachés de la CLI se pueden volver a crear cuando hagan falta, así que ese espacio puede llenarse de nuevo.
- En projects/, elimina solo las sesiones que hayas decidido que no necesitas, junto con su carpeta asociada si la tienen. La antigüedad puede acotar la lista, pero que una sesión sea antigua no significa que se pueda borrar sin más. No borres las carpetas de memoria de los proyectos junto con los datos de las sesiones.
- No toques file-history/ salvo que ya no necesites sus copias de recuperación. Mueve primero a la Papelera lo que elijas y compruébalo todo antes de decidir si la vacías. Los archivos que están en la Papelera siguen ocupando espacio.
Borrar una transcripción elimina la conversación
Al eliminar una sesión desaparecen su texto y las imágenes guardadas en ella, y ya no puedes retomarla en local. Una nota de memoria que apunte a esa sesión puede quedarse apuntando a algo que ya no existe, aunque borrar la sesión no elimina ni daña la nota en sí.
No elimines toda la carpeta ~/.claude como atajo para limpiar. Además de los datos de las sesiones, contiene tu configuración y tu memoria.
Qué aporta Mint
Mint muestra el almacenamiento de Claude en la pestaña Disk. Un tamaño medido no es una invitación a limpiar. Antes de elegir una acción, comprueba para qué sirve cada elemento y si todavía lo necesitas.
Preguntas frecuentes
¿Se puede borrar ~/.claude/projects sin riesgo?
Entera, no. Puede contener conversaciones, datos asociados y la memoria de los proyectos. Revisa las sesiones una a una y conserva las que todavía quieras retomar o consultar.
¿Por qué ~/.claude ocupa tanto?
Depende de cada Mac. Mide por separado las sesiones, los registros de depuración y las instantáneas de archivos con el comando de solo lectura de más arriba, porque lo que más ocupa cambia de un equipo a otro.
Mira cuánto espacio ocupa Claude Code
Haz un análisis y busca Claude en la pestaña Disk.