Causa Raíz de la Corrupción del Título de Sesión en la Extensión Claude Code de VS Code Identificada

Error de Corrupción de Títulos de Sesión en la Extensión Claude Code

Un error persistente en la extensión de VS Code Claude Code hace que los títulos de sesión en Conversaciones Anteriores se corrompan: muestran títulos incorrectos, vuelven al texto del último mensaje o desaparecen por completo. Un desarrollador ha identificado la causa raíz arquitectónica y ha recopilado más de 20 problemas relacionados en GitHub que provienen del mismo problema subyacente.

Análisis de la Causa Raíz

La lista de sesiones de la extensión lee los títulos realizando una búsqueda de cadena de texto sin procesar de "customTitle" en los últimos 64KB de cada archivo de sesión .jsonl. Este enfoque crea tres modos de fallo específicos:

• Eliminación por 64KB — En sesiones largas (comunes con flujos de trabajo de agentes), la entrada del título personalizado se desplaza fuera de la ventana de los últimos 64KB, haciendo que el título se pierda.
• Contaminación de contenido entre sesiones — El escáner no distingue entre entradas JSONL reales de título personalizado y la cadena "customTitle" que aparece dentro de resultados de herramientas o contenido de conversación, haciendo que el título de una sesión aparezca en una sesión completamente diferente.
• Sobrescritura al reanudar — Cuando se reanuda una sesión y se añade nuevo contenido, cualquier título personalizado de /rename queda enterrado. La extensión entonces recurre a lastPrompt o recoge una coincidencia obsoleta de la salida de herramientas.

Problemas Afectados

El desarrollador ha recopilado más de 20 problemas en GitHub relacionados con este problema:

• Título perdido: #33165, #32150, #25090, #23610, #26240, #29194
• Título incorrecto: #29801, #9668, #29342, #27751
• Sesiones invisibles: #9898, #31813, #29088, #22215, #18619, #11232
• Solicitudes de funciones (soluciones alternativas): #11956, #9198, #11694, #7441

Muchos de estos problemas fueron cerrados automáticamente como duplicados por el bot sin que se implementara una solución. Las correcciones parciales en v2.1.47 y v2.1.71 abordaron síntomas específicos pero no la arquitectura subyacente.

Solución Propuesta y Alternativa

El desarrollador propone almacenar los títulos en un índice ligero separado (por ejemplo, title-registry.json) en lugar de escanear el contenido de la conversación. Este enfoque sobreviviría al crecimiento de la sesión, sería inmune a la contaminación de contenido y permitiría la sincronización entre clientes.

Como alternativa actual, el desarrollador ha estado ejecutando un enlace UserPromptSubmit + temporizador systemd + registro de títulos persistente que reafirma el título correcto en cada mensaje y cada 2 minutos. Los detalles de implementación están disponibles en el problema #32150.

Este error afecta a cualquiera que use Claude Code para flujos de trabajo basados en tareas donde importa emparejar sesiones con elementos de trabajo. El análisis completo de la causa raíz con los 20 problemas enlazados está disponible en la discusión de GitHub.