← Claude Code Hub
Oct 16, 2026 · 4 min de lectura ✦ Tip #230

Borrar el historial de Claude Code: claude purge limpia un proyecto

claude purge borra todo lo que Claude Code guarda de un proyecto: transcripciones, memoria, historial de ediciones y hasta tu confianza en la carpeta. Con --dry-run ves antes qué se va.

Borrar el historial de Claude Code: cinco sitios de tu disco (transcripciones y memoria, historial de ediciones, tareas y logs, history.jsonl y la entrada de ~/.claude.json) que claude purge borra de una vez, y lo que se queda: backups, shell-snapshots e imágenes pegadas

TL;DR claude purge <ruta> --dry-run te enseña todo lo que Claude Code guarda de ese proyecto. Quita --dry-run y lo borra de una vez, después de pedirte confirmación. Antes se llamaba claude project purge.

claude purge borra todo lo que Claude Code guarda en tu disco sobre un proyecto, y eso no es solo la carpeta de conversaciones. Son las transcripciones y la memoria de ~/.claude/projects/, las tareas, los logs de depuración y el historial de ediciones de cada sesión, tus prompts en history.jsonl y la entrada del proyecto en ~/.claude.json. A mano son cinco sitios distintos. Con purge, un comando.

Si solo quieres quitar una conversación, no te hace falta: borra su .jsonl en la carpeta donde vive en texto plano. purge va por proyectos.

Esto es lo que salió en mi proyecto de wmedia.es (recortado):

$ claude purge ~/Herd/wmedia --dry-run
Purge plan for /Users/juan.nunez/Herd/wmedia:

  dir:    /Users/juan.nunez/.claude/file-history/1c13ffa7-eacf-4291-8c94-5b73e6369307
           file edit history for session 1c13ffa7-eacf-4291-8c94-5b73e6369307
  ... (6 sesiones más con su file-history)
  dir:    /Users/juan.nunez/.claude/projects/-Users-juan-nunez-Herd-wmedia
           project transcripts (.jsonl) and memory/
  dir:    /Users/juan.nunez/.claude/projects/-Users-juan-nunez-Herd-wmedia--claude-worktrees-ia-empresa-coste-legalidad-etica-6e2400
           project transcripts (.jsonl) and memory/
  config: projects["/Users/juan.nunez/Herd/wmedia"]
           project entry in ~/.claude.json (trust, history, MCP servers)

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/Users/juan.nunez/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 10 item(s) would be deleted.

Diez elementos, y solo la carpeta de transcripciones ocupaba 606 MB. Fíjate en la segunda carpeta de projects/: las sesiones de un worktree también caen.

Cuándo usarlo

  • Pegaste un secreto en una sesión. Un token que se coló en un prompt o en la salida de un comando se queda escrito en la transcripción.
  • Cierras o entregas un proyecto. No dejas en tu máquina conversaciones de un repo que ya no es tuyo.
  • Recuperas espacio. Proyecto a proyecto, sabiendo antes qué se va. Si el espacio se lo lleva Claude Desktop, el panel /storage te dice primero qué bloque pesa.

Cómo se usa

1. Mira el plan primero

claude purge ~/work/mi-repo --dry-run

No borra nada. Sin ruta, te deja elegir el proyecto de una lista.

2. Bórralo

claude purge ~/work/mi-repo

Según la documentación, imprime el mismo plan y pregunta Delete N item(s) for ...? This cannot be undone. [y/N]. Solo borra si respondes y.

Opción Qué hace
--dry-run Enseña el plan sin borrar
-i Te pide confirmación elemento a elemento
-y Se salta la confirmación, para scripts
--all Todos los proyectos; borra history.jsonl entero en vez de filtrarlo

Lo que te llevas por delante

La entrada de ~/.claude.json guarda la confianza en la carpeta y los MCP servers que añadiste con claude mcp add en el scope local, el de por defecto. Después de purge, la próxima sesión en esa carpeta te vuelve a preguntar si confías en ella, y esos MCP ya no están. Si los quieres conservar, pásalos antes a .mcp.json con --scope project.

Y la memoria va en el mismo lote que las transcripciones: es un único elemento del plan. Para limpiar solo la memoria, purge no te sirve.

Lo que no borra

  • backups/: hasta cinco copias antiguas de ~/.claude.json que pueden seguir llevando la entrada del proyecto. Rotan solas, pero si lo que se filtró está ahí, bórralas a mano.
  • shell-snapshots/: no son de ningún proyecto.
  • Las imágenes que pegaste y el scratchpad de cada sesión: viven en el directorio temporal. Las imágenes se van con cleanupPeriodDays.
  • Los .heapsnapshot de /heapdump: llevan la conversación completa y nadie los limpia.

Un aviso: en un proyecto con mucho historial, el --dry-run puede tardar. En el repo donde escribo estos tips, con cientos de sesiones, no había terminado a los tres minutos. Y la documentación no dice qué pasa si borras un proyecto con una sesión abierta en él: ciérrala antes.

Para el otro extremo, llevarte todo esto a otra máquina en vez de borrarlo, está qué copiar de ~/.claude al migrar.

Documentación oficial: Clear local data · CLI reference

Requisitos

  • Claude Code v2.1.288 o posterior, que es cuando claude project purge pasó a claude purge. Probado en v2.1.293.
  • Con el nombre viejo, la CLI te avisa: `claude project purge` is now `claude purge`.

¿Te ha servido? Haz que wmedia.es te salga antes en Google.

Añadir wmedia.es como fuente preferida en Google
Guía gratuita

Los 51 imprescindibles, en una guía.

Una página por tip. Cinco capítulos. Lo que de verdad uso a diario en producción. Sin teoría, sin humo.

  • 1. Empieza bien 10 tips
  • 2. Conciencia 3 tips
  • 3. Maestría 22 tips
  • 4. Autonomía 15 tips
  • 5. Comparativa 1 tip
¿Eres desarrollador/a Web profesional?

Recibirás la guía por email · Te unes a la newsletter Gravitas · Cancela cuando quieras

de 51
#

Wmedia · 51 tips
Guía gratuita · 51 tips · 5 capítulos

Los 51 imprescindibles, en una guía.

Una página por tip. Cinco capítulos. Lo que de verdad uso a diario en producción. Sin teoría, sin humo.

¿Eres desarrollador/a Web profesional? · Cancela cuando quieras
Cómo trabajo con IA

Mi flujo de trabajo con Claude Code.

Las skills, agentes e instrucciones que uso como Software Engineer profesional. Se llama Craft y es un plugin que puedes instalarte.

Ver las skills

¿Quieres los 51 imprescindibles de Claude Code en una guía?