Rastreo de Código Claude: Exporta tus Sesiones de Chat con IA Fácilmente
Exporte sus sesiones de chat con código Claude usando cctrace
cctrace es una innovadora herramienta de línea de comandos de código abierto desarrollada para agilizar el proceso de exportación de sus sesiones de chat desde Claude Code. Para desarrolladores, científicos de datos y entusiastas de la IA, tener un registro completo de las interacciones de la IA, incluido el razonamiento interno y el uso de herramientas, es invaluable. cctrace proporciona una solución robusta, asegurando que todos los datos críticos sean capturados y accesibles.
¿Qué es cctrace?
cctrace, abreviatura de "Claude Code Trace" (Rastro de Código Claude), es una utilidad basada en Python que permite a los usuarios exportar sus sesiones de chat de Claude Code a varios formatos, como Markdown, XML y JSONL sin procesar. Está diseñada para ser fácil de usar, ofreciendo tanto una sencilla integración de comando con barra dentro del propio Claude Code como opciones flexibles de línea de comandos para una personalización avanzada.
Características clave:
- Detección automática de sesiones: Identifica de forma inteligente su sesión actual de Claude Code, incluso con múltiples sesiones simultáneas, devolviendo el ID de la sesión, la transcripción y todos los metadatos.
- Captura completa de datos: Exporta todos los mensajes, bloques de "pensamiento" (razonamiento interno), uso de herramientas con entradas y salidas, y metadatos completos.
- Múltiples formatos de salida: Genera archivos Markdown legibles por humanos para una fácil revisión, XML estructurado para procesamiento programático y JSONL sin procesar para un análisis detallado.
- Integración de comandos con barra: Exporte directamente desde su sesión de Claude Code usando un simple comando
/export
. - Archivos con marca de tiempo: Cada exportación se guarda en un directorio único con marca de tiempo para una fácil organización.
- Copia automática al directorio de trabajo: Opcionalmente, copia las exportaciones directamente a su directorio de proyecto actual, simplificando el control de versiones y el acceso.
¿Por qué usar cctrace?
En el rápido entorno de desarrollo de IA actual, rastrear y analizar las interacciones de la IA es crucial. Ya sea que esté depurando prompts, documentando el comportamiento de la IA o compartiendo información con un equipo, cctrace asegura que tenga un registro completo y bien estructurado. Su capacidad para capturar el razonamiento interno detallado y las llamadas de herramientas proporciona un nivel de transparencia sin precedentes sobre cómo opera Claude Code durante sus sesiones.
Primeros pasos con cctrace
Requisitos:
- Python 3.6 o posterior
- Claude Code ejecutándose en Linux o WSL
- Acceso al directorio
~/.claude/projects/
Instalación rápida:
- Clonar el repositorio:
git clone https://github.com/jimmc414/cctrace.git cd cctrace
- Ejecutar el instalador:
chmod +x install.sh ./install.sh
Uso:
Vía comando con barra de Claude Code (recomendado):
Simplemente escriba /export
o /user:export
dentro de su sesión de Claude Code. La herramienta detectará y exportará automáticamente su sesión actual, mostrando un resumen directamente en Claude Code.
Vía línea de comandos:
Para mayor control, puede ejecutar el script export_claude_session.py
directamente:
- Exportar la sesión activa actual:
python3 ~/claude_sessions/export_claude_session.py
- Exportar una sesión específica por ID:
python3 ~/claude_sessions/export_claude_session.py --session-id <su-id-de-sesion>
- Especificar el formato de salida o el directorio:
python3 ~/claude_sessions/export_claude_session.py --format xml --output-dir /ruta/a/mis/exportaciones
Contenido de la exportación explicado
Cada exportación crea un directorio con marca de tiempo que contiene varios archivos:
session_info.json
: Metadatos completos de la sesión, incluido el ID de la sesión, el directorio del proyecto, las marcas de tiempo y el uso del modelo.conversation_full.md
: Un archivo Markdown legible por humanos de toda la conversación, completo con secciones contraíbles para bloques de pensamiento y uso de herramientas.conversation_full.xml
: Un archivo XML completamente etiquetado que conserva todos los metadatos, la jerarquía de mensajes y la información detallada de ejecución de herramientas, ideal para el procesamiento automatizado.raw_messages.jsonl
: Los datos JSONL originales y sin modificar de Claude Code, perfectos para un análisis programático en profundidad.summary.txt
: Un resumen rápido en texto plano de la sesión y los detalles de la exportación.
cctrace es una herramienta esencial para cualquiera que trabaje con Claude Code, proporcionando los medios para gestionar, analizar y compartir a fondo los datos de las conversaciones de IA. Su naturaleza de código abierto fomenta las contribuciones de la comunidad y asegura una mejora continua.