뉴스 - 원문 기반 요약 필요

---

title: "Claude Code 세션 파일 파서 3가지 생존 패턴" description: "뉴스 - 원문 기반 요약 필요" date: 2026-07-06 tags: [vibe-coding] source: "https://dev.to/gentic_news/build-a-bulletproof-claude-code-jsonl-parser-fn1" sidebar: order: 0

제목(한글): Claude Code 세션 파일 파서 3가지 생존 패턴 원문 제목(영문): Build a Bulletproof Claude Code JSONL Parser 원문: Build a Bulletproof Claude Code JSONL Parser 소스: dev-to-ai MD 파일: content/2026-07-06/dev-to-ai-build-a-bulletproof-claude-code-jsonl-parser.md

핵심 내용

Claude Code가 매 대화를 ~/.claude/projects/ 에 JSONL 파일로 저장한다는 거 알고 계셨나요? 버그 추적 3회차 세션까지 전부 디스크에 남아있어요.

문제는 이 포맷이 '내부 구현 상세'라 공식 문서도, 버전 필드도 없다는 거예요. CLI가 거의 매일 업데이트되면서 스키마도 바뀌는데, 한 개발자가 12번의 CLI 릴리즈를 버텨낸 파싱 패턴 3가지를 공개했어요.

핵심은 화이트리스트 방식의 관용적 파싱, 버전 관리된 파생 데이터, toWellFormed() 문자열 정규화예요. 알 수 없는 타입이 나와도 터지지 않고 raw JSON을 보존하는 구조거든요.

내 Claude Code 히스토리를 직접 분석하거나 검색 도구를 만들고 싶다면 참고할 만한 실전 패턴이에요.

잡돌쌤의 한마디

알 수 없는 타입은 raw JSON으로 보존하는 화이트리스트 방식으로 12번 릴리즈를 버텼어요.

---

출처: Build a Bulletproof Claude Code JSONL Parser