← Claude Code Hub
✦ Tip #125 Jul 5, 2026

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.

Míralo tú mismo

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

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.

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

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.
Guía gratuita

51 tips para dominar Claude Code.

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

  • I. Empieza bien 10 tips
  • II. Conciencia 3 tips
  • III. Maestría 22 tips
  • IV. Autonomía 10 tips
  • V. Comparativa 6 tips
¿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

51 tips para dominar Claude Code.

¿Eres desarrollador/a Web profesional? · Cancela cuando quieras