Claude Code, la herramienta de programación asistida por inteligencia artificial de Anthropic, almacena automáticamente todas las conversaciones de los usuarios en archivos JSONL dentro de la carpeta ~/.claude/projects/. Sin embargo, existe un problema crítico que afecta a desarrolladores y usuarios avanzados: estos registros se eliminan automáticamente después de 30 días.
Esta limitación ha motivado a Cengiz Han, un desarrollador de software, a crear claude-code-logs, una herramienta de código abierto que permite preservar permanentemente todas las conversaciones y consultas realizadas con Claude Code. La solución aborda una necesidad real en el flujo de trabajo de programadores que dependen cada vez más de asistentes de IA: la imposibilidad de acceder posteriormente a enfoques anteriores, soluciones descartadas y evoluciones del razonamiento que llevaron a un resultado final.
La herramienta funciona de manera elegante y eficiente. En primer lugar, convierte los registros JSONL a archivos markdown legibles, transformando datos estructurados en documentos consultables. Proporciona además una aplicación web local que permite navegar y buscar todas las conversaciones archivadas de forma intuitiva. El sistema rastrea los cambios en un repositorio git, capturando únicamente las sesiones nuevas sin necesidad de regenerar toda la información cada vez que se ejecuta.
La instalación es accesible incluso para usuarios sin experiencia avanzada en línea de comandos. Mediante Homebrew en macOS y Linux, los usuarios pueden instalar la herramienta con un simple comando. Posteriormente, pueden clonar un repositorio privado de GitHub para almacenar sus registros de forma segura y sincronizada.
Cengiz Han ha identificado casos de uso particularmente valiosos para este archivo permanente. El primero es eminentemente práctico: en el día a día de desarrollo, resulta frecuente necesitar localizar "aquel trabajo donde resolví tal problema" o recordar "qué estrategia utilicé hace dos semanas". Con la interfaz web, búsqueda y navegación se vuelven operaciones rápidas, eliminando la necesidad de excavar en carpetas de proyectos olvidados o en archivos JSON sin procesar.
Más allá de la utilidad inmediata, el creador de la herramienta plantea aplicaciones a largo plazo especialmente intrigantes. Su objetivo es realizar un análisis de "año envuelto" al finalizar 2026, un análisis retrospectivo que identifique patrones en los proyectos ejecutados, los problemas que presentaron mayor dificultad y los enfoques que se repitieron frecuentemente. Este tipo de análisis resulta imposible de realizar desde la memoria y requiere datos concretos y archivados.
Han ha desarrollado además una herramienta complementaria llamada claude-code-prompt-coach-skill que evalúa la calidad de los prompts según las directrices de Anthropic. Con un archivo permanente, es posible ejecutar este análisis a través de meses de datos para determinar si los prompts mejoran genuinamente con el tiempo o si se repiten constantemente los mismos errores.
Otra dimensión potencial del archivo concierne al método de desarrollo. Han utiliza specs.md para desarrollo dirigido por especificaciones, lo opuesto a lo que denomina "vibe coding" (programación intuitiva sin planificación). Con registros permanentes, es factible medir la proporción entre ambos enfoques: cuando se comienza con una especificación clara, ¿cuántos prompts adicionales son necesarios? ¿Disminuye este número conforme mejoran las especificaciones o a medida que los modelos evolucionan?
La filosofía detrás de claude-code-logs es especialmente relevante en la era del aprendizaje automático. Han subraya que ignora cuáles serán sus necesidades futuras respecto a estos datos, pero reconoce que investigadores podrían estar interesados en estudiar cómo evolucionaron las prácticas de adoptantes tempranos de la tecnología IA. Al capturar estos datos ahora, cuando el almacenamiento es prácticamente gratuito, preserva opciones futuras que de otro modo se perderían irremediablemente.
Esta herramienta refleja una tendencia más amplia en la comunidad tecnológica: la necesidad de control y propiedad sobre los datos generados en colaboración con sistemas de IA. A medida que estos asistentes se vuelven más integrales en los flujos de trabajo profesionales, las limitaciones de retención de datos plantean preguntas sobre conservación, aprendizaje iterativo y arqueología del conocimiento técnico.
