← Claude Code Hub
Jul 5, 2026 · 3 min de lectura ✦ Tip #125

La carpeta de Claude Code que guarda (en texto plano) todo lo que escribes

Abre `~/.claude/projects/` y cuenta: cada sesión que has tenido con Claude Code está ahí, en texto plano, sin cifrar. Los prompts, las respuestas y el token que pegaste sin pensar. Por defecto, 30 días.

La carpeta ~/.claude/projects/ de Claude Code guarda cada sesión como un .jsonl sin cifrar: 548 conversaciones y 541 MB en texto plano, con un token pegado a la vista, y el control cleanupPeriodDays para acortar la retención de 30 días

TL;DR Cada sesión de Claude Code se guarda como un .jsonl en texto plano bajo ~/.claude/projects/ (tus prompts, las respuestas y lo que pegaste, tokens incluidos). Por defecto viven 30 días. Acorta la retención con cleanupPeriodDays en settings.json, o apaga la escritura del todo con CLAUDE_CODE_SKIP_PROMPT_HISTORY. Es lo mismo que alimenta --resume y el Rewind.

Miré mi carpeta ~/.claude/projects/ y me encontré con 548 conversaciones, 541 MB, 14 proyectos. Todo en texto plano. Cada prompt que he escrito, cada respuesta, cada secreto que pegué sin pensar, ahí, sin cifrar. No es un bug: es justo lo que hace posible retomar una sesión y rebobinar. Pero conviene saber dónde vive y cuánto dura.

Dónde vive

~/.claude/projects/<ruta-del-proyecto>/<session-id>.jsonl

Una carpeta por proyecto (la ruta con / convertida en -), un .jsonl por sesión, y cada línea es un evento JSON: tu prompt, la respuesta, cada tool call. Sin cifrar. Es lo que leen --resume y el Rewind con checkpoints. También es lo que Claude Code mide cuando, en Pro y Max, te enseña el diálogo de resume que muestra lo que una conversación antigua le cuesta a tu límite de 5 horas. Y cuando una sesión se cierra con "unrecoverable interface error" y ni --resume la levanta, este fichero es el que mueves a otro nombre: diez causas y un arreglo.

Los pegados largos viven aparte, en ~/.claude/paste-cache/, y los borra esta misma barrida: cómo desplegar un texto pegado antes de que caduque.

Míralo tú mismo

du -sh ~/.claude/projects/                          # cuánto ocupa
find ~/.claude/projects -name '*.jsonl' | wc -l     # cuántas conversaciones

Y como cada evento trae sus contadores de tokens, ese mismo fichero sirve para auditar el consumo: sumándolos se ve qué parte de una sesión se fue en releer el historial, que es un dato que no te da ningún comando.

Qué hacer

1. Acorta la retención

En ~/.claude/settings.json:

{ "cleanupPeriodDays": 7 }

Default 30 días, mínimo 1 (0 da error de validación). Al arrancar, borra los transcripts más viejos. Aplica en la próxima sesión, no en caliente. Ese mismo número marca la caducidad de los worktrees de subagentes y de sesiones en segundo plano, que ocupan bastante más que un transcript. Las sesiones abiertas desde Claude Desktop o Cowork no caducan con este ajuste: para esas está el panel /storage y desktopSessionCleanupPeriodDays.

2. Apágalo del todo

export CLAUDE_CODE_SKIP_PROMPT_HISTORY=1   # deja de escribir transcripts

En headless o SDK, --no-session-persistence (o persistSession: false). Ojo con el tradeoff: sin transcripts pierdes --resume y el Rewind, porque ambos leen de ahí.

3. Borra lo que ya haya

Es una carpeta normal. Borra las sesiones que no quieras conservar (con cabeza):

rm ~/.claude/projects/<proyecto>/<session-id>.jsonl

Para borrar de golpe todo lo que Claude Code guarda de un proyecto (no solo las conversaciones), usa claude purge.

Referencia

Control Qué hace
cleanupPeriodDays (en settings.json) Días de retención. Default 30, mínimo 1
CLAUDE_CODE_SKIP_PROMPT_HISTORY=1 No escribe transcripts (sesión interactiva)
--no-session-persistence / persistSession: false Lo mismo, en headless o SDK

Ojo:

  • Es un tradeoff, no un interruptor gratis: apagar la escritura mata --resume y el Rewind.
  • El borrado por cleanupPeriodDays ocurre al arrancar, así que un transcript recién creado sigue en disco hasta la próxima sesión que pase el corte.

Esto es la cara oculta del Rewind con checkpoints: esa función es cómoda porque tu historial vive en disco; este tip es dónde vive y cómo controlar su vida.

Documentación oficial: Ajustes (cleanupPeriodDays)

Relacionado: Rewind: deshaz cambios con checkpoints

Requisitos

  • settings.json en ~/.claude/ (usuario) o .claude/ (proyecto). El cambio se aplica al arrancar la siguiente sesión.

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

Añadir wmedia.es como fuente preferida en Google
GUÍA GRATUITA

No necesitas Opus siempre.

Modelo y effort son dos ajustes, no uno. 8 páginas con la configuración que de verdad mueve la factura, el diagnóstico en tres preguntas cuando algo falla y la escalera de precios.

  • 1. Qué es «mejor» capacidad, tiempo y dinero
  • 2. Modelo a quién mandas
  • 3. Effort cuánta cuerda le das
  • 4. Diagnóstico tres preguntas cuando algo falla
  • 5. La factura por dónde llega
¿Eres desarrollador/a Web profesional?

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

de 8
#

Wmedia · 8 páginas
GUÍA GRATUITA · 8 páginas · 2 mandos

No necesitas Opus siempre.

Modelo y effort son dos ajustes, no uno. 8 páginas con la configuración que de verdad mueve la factura, el diagnóstico en tres preguntas cuando algo falla y la escalera de precios.

¿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

¿Usas Opus para todo? Mira cuándo no hace falta.