Crear herramientas de línea de comandos para explorar logs del asistente de codificación de IA (Claude Code & Codex CLI)

Explora logs de forma eficiente con Claude Code & Codex CLI. Optimiza la gestión de registros y simplifica el análisis de datos. Herramienta imprescindible para desarrolladores y administradores de sistemas.

19 dic 2025 • 3 min de lectura • Equipo Q2BSTUDIO

Exploración de logs con Claude Code & Codex CLI

Problema Encontrar sesiones anteriores de asistentes de codificación por IA puede ser tedioso cuando los registros están dispersos en directorios anidados. Claude Code guarda registros en ~/.claude/projects/PROJECT_HASH/*.jsonl y Codex CLI en ~/.codex/sessions/YYYY/MM/DD/*.jsonl, y navegar manualmente por estas carpetas hace perder tiempo y contexto sobre prompts y soluciones que ya funcionaron.

Solución Hemos desarrollado dos scripts de shell simples para explorar esos logs de forma interactiva usando fzf y jq: claude-logs para Claude Code y codex-logs para OpenAI Codex CLI. Cada herramienta es un único fichero ligero que funciona sin complicaciones y permite buscar, previsualizar y formatear conversaciones almacenadas en JSONL.

Comandos principales sin parámetros lanzan el modo interactivo con fzf para seleccionar proyecto y sesión. Opciones útiles incluyen list para mostrar todos los proyectos o meses, latest para ver la sesión más reciente, tail para visualizar en tiempo real la sesión activa y status para comprobar si el CLI está corriendo.

Demostración rápida Modo interactivo ejecutar claude-logs seleccionar proyecto con fzf seleccionar sesión con fzf ver conversación formateada. Monitorización en tiempo real ejecutar claude-logs tail ver la sesión activa en directo Ctrl+C para salir. Comprobación de estado ejecutar claude-logs status mostrará si Claude Code está en ejecución y listará sesiones recientes.

Formato de salida Los logs JSONL se transforman en conversaciones legibles con marcas claras para roles como USUARIO y CLAUDE o CODEX y con indicación de herramientas propuestas por el asistente. Para Codex CLI se añade información del proyecto y la rama git cuando está disponible.

Instalación Requisitos previos instalar fzf y jq por ejemplo con brew install fzf jq. Para instalar claude-logs clonar el repositorio ejecutar chmod +x claude-logs/claude-logs y copiar el script a ~/.local/bin/. Para codex-logs clonar el repositorio ejecutar chmod +x codex-logs/codex-logs y copiar a ~/.local/bin/. Asegurarse de que ~/.local/bin está en PATH para poder invocar los comandos desde cualquier terminal.

Cómo funciona Escanea la estructura de directorios de logs, parsea archivos JSONL con jq para extraer mensajes, muestra opciones y previsualizaciones con fzf y formatea la salida con colores ANSI para facilitar la lectura. La función de previsualización de fzf permite ver fragmentos de conversación antes de abrir el archivo completo.

Casos de uso referencia Revisitar soluciones anteriores para reutilizar fragmentos de código o ideas. Reutilizar prompts efectivos para ahorrar tiempo en futuros proyectos. Revisión diaria de trabajos realizados con asistentes IA. Depuración cuando el CLI de IA se comporta de forma inesperada.

Limitaciones Actualmente diseñadas para macOS puesto que usan stat -f para timestamps. El soporte para Linux requeriría adaptar la llamada a stat con --format. Aceptamos contribuciones y pull requests para ampliar compatibilidad.

Sobre Q2BSTUDIO En Q2BSTUDIO somos una empresa de desarrollo de software y aplicaciones a medida especializada en soluciones basadas en inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio y automatización de procesos. Diseñamos software a medida y aplicaciones a medida que integran agentes IA, ia para empresas y soluciones de Business Intelligence como Power BI para optimizar procesos y decisiones. Si te interesa potenciar tu proyecto con modelos de conversación y flujos automatizados podemos ayudarte con arquitectura, integración y despliegue.

Servicios recomendados Explora nuestros servicios de Inteligencia artificial para desplegar agentes IA y soluciones de ia para empresas. Para proyectos que requieren plataformas y aplicaciones a medida visita nuestra página de desarrollo de aplicaciones y software a medida. También ofrecemos ciberseguridad y pentesting, consultoría cloud en AWS y Azure, y servicios de inteligencia de negocio y Power BI para mejorar la visibilidad y el control sobre datos.

Conclusión Si usas Claude Code o Codex CLI con frecuencia, estos scripts simplifican el acceso a tus conversaciones de IA, ayudan a reutilizar prompts efectivos y aceleran la resolución de problemas. En Q2BSTUDIO combinamos experiencia en desarrollo de software, inteligencia artificial y ciberseguridad para ofrecer soluciones integrales que mejoran la productividad y la seguridad de tus proyectos. Si quieres soporte para integrar este tipo de herramientas en tu flujo de trabajo empresarial contacta con nosotros para una consultoría personalizada.

¿UNA PAUSA?

Juega un momento antes de irte

NUESTROS SERVICIOS

Cómo podemos ayudarte

Inteligencia artificial

Agentes de IA, chatbots y asistentes inteligentes que automatizan tareas y atienden a tus clientes 24/7 para mejorar la eficiencia de tu negocio.

Más info

Desarrollo de software

Aplicaciones web, móviles y de escritorio, intranets, e-commerce, SaaS y plataformas de gestión diseñadas para las necesidades concretas de tu empresa.

Más info

Servicios cloud

Migración, infraestructura, hosting gestionado, alta disponibilidad y seguridad en Microsoft Azure y Amazon Web Services para que tu negocio escale sin límites.

Más info

Ciberseguridad y pentesting

Auditorías de seguridad, test de intrusión (pentesting) y protección de aplicaciones, datos e infraestructura on-premise y cloud, con hacking ético y cumplimiento normativo.

Más info

Business Intelligence

Cuadros de mando y análisis de datos con Power BI: integramos tus fuentes, diseñamos dashboards y KPIs y convertimos tus datos en decisiones.

Más info

Automatización de procesos

Automatizamos tareas repetitivas y conectamos tus aplicaciones con n8n, Power Automate, Make y RPA, eliminando trabajo manual y aumentando la productividad.

Más info

Formación para empresas

Formamos a tus equipos en tecnología con criterio: desarrollo web, bases de datos, Git, buenas prácticas y seguridad, automatización con n8n, inteligencia artificial para empresas y creación de soluciones de IA con Azure AI Foundry.

Más info

Auditoría de código

Auditamos el código que creas tú, tu equipo o una IA: te decimos qué está bien y qué mejorar, lo securizamos y lo dejamos listo para producción, web o app.

Más info

Generación de imágenes con IA

Creamos por ti las imágenes que necesita tu negocio con inteligencia artificial: producto, redes, publicidad, ilustración y avatares. Tú nos dices qué quieres y te lo entregamos listo para usar.

Más info

Generación de vídeos con IA

Creamos por ti vídeos con inteligencia artificial: promocionales, para redes, presentadores virtuales, doblaje y animaciones. Nos cuentas la idea y te lo entregamos montado y listo para publicar.

Más info

Avatares conversacionales con IA

Creamos avatares conversacionales con IA —humanos digitales con cara y voz— que atienden a tus clientes y equipos con el conocimiento de tu empresa, en tu web, monitores interactivos, WhatsApp o Teams.

Más info

Marketing Online e IA

Google Ads, Meta Ads, LinkedIn Ads y posicionamiento en motores de IA (GEO/AEO): captamos clientes y hacemos que tu marca aparezca donde te buscan, también en ChatGPT, Gemini y Perplexity.

Más info

¿Tienes un proyecto en mente?

Cuéntanos tu visión y la convertimos en una solución de software. Sea cual sea el alcance, hacemos realidad tu idea.

Live Chat