Claude Code VS Code 확장 프로그램 세션 제목 손상의 근본 원인 확인

Claude Code 확장 프로그램의 세션 제목 손상 버그

Claude Code VS Code 확장 프로그램의 지속적인 버그로 인해 '과거 대화'의 세션 제목이 손상됩니다—잘못된 제목이 표시되거나, 마지막 프롬프트 텍스트로 되돌아가거나, 완전히 사라지는 현상이 발생합니다. 한 개발자가 아키텍처적 근본 원인을 파악하고 동일한 근본 문제에서 비롯된 20개 이상의 관련 GitHub 이슈를 수집했습니다.

근본 원인 분석

확장 프로그램의 세션 목록은 각 .jsonl 세션 파일의 마지막 64KB에서 "customTitle"에 대한 원시 문자열 검색을 수행하여 제목을 읽습니다. 이 접근 방식은 세 가지 구체적인 실패 모드를 생성합니다:

• 64KB 제거 — 긴 세션(에이전트 워크플로우에서 흔함)에서 사용자 지정 제목 항목이 64KB 꼬리 창 밖으로 밀려나 제목이 손실됩니다.
• 세션 간 내용 오염 — 스캐너가 실제 사용자 지정 제목 JSONL 항목과 도구 결과나 대화 내용 내에 나타나는 "customTitle" 문자열을 구분하지 못해 한 세션의 제목이 완전히 다른 세션에 나타납니다.
• 재개 시 덮어쓰기 — 세션이 재개되고 새 내용이 추가되면 /rename에서 생성된 사용자 지정 제목이 묻힙니다. 그러면 확장 프로그램은 lastPrompt로 되돌아가거나 도구 출력에서 오래된 일치 항목을 선택합니다.

영향을 받는 이슈

개발자는 이 문제와 관련된 20개 이상의 GitHub 이슈를 수집했습니다:

• 제목 손실: #33165, #32150, #25090, #23610, #26240, #29194
• 잘못된 제목: #29801, #9668, #29342, #27751
• 세션 보이지 않음: #9898, #31813, #29088, #22215, #18619, #11232
• 기능 요청 (임시 해결책): #11956, #9198, #11694, #7441

이러한 이슈 중 많은 부분이 수정 사항이 적용되지 않은 채 봇에 의해 중복으로 자동 닫혔습니다. v2.1.47 및 v2.1.71의 부분적 수정 사항은 특정 증상을 해결했지만 근본적인 아키텍처는 해결하지 못했습니다.

제안된 해결책 및 임시 해결 방법

개발자는 대화 내용을 스캔하는 대신 제목을 별도의 경량 인덱스(예: title-registry.json)에 저장할 것을 제안합니다. 이 접근 방식은 세션 증가를 견디고, 내용 오염에 면역이 되며, 클라이언트 간 동기화를 가능하게 합니다.

현재 임시 해결 방법으로, 개발자는 UserPromptSubmit 훅 + systemd 타이머 + 지속적 제목 레지스트리를 실행하여 모든 프롬프트마다 그리고 2분마다 올바른 제목을 재확인하고 있습니다. 구현 세부 사항은 이슈 #32150에서 확인할 수 있습니다.

이 버그는 작업 기반 워크플로우에 Claude Code를 사용하는 모든 사용자에게 영향을 미치며, 여기서는 세션을 작업 항목과 일치시키는 것이 중요합니다. 모든 20개 이슈에 대한 전체 근본 원인 분석은 GitHub 토론에서 확인할 수 있습니다.