2026년 Claude Code 세션에 가장 좋은 뷰어는 무엇인가요?
Claude Code가 2025~2026년 폭발적으로 유행하면서 「쌓여 있는 세션 기록을 편하게 돌아보고 싶다」는 요구가 잦아졌습니다. 로컬 ~/.claude/projects/에는 수백 개의 JSONL 파일이 쌓이기 마련이고 텍스트 에디터로는 읽을 수가 없죠. 실제 사용 시나리오별로 주요 선택지를 비교합니다.
후보 한눈에 보기
| 선택지 | 유형 | 적합한 용도 |
|---|---|---|
| CCViewer(오픈소스) | 웹 기반 그래픽 뷰어 | 열람·검색·감사·내보내기 |
| claude --resume / -r | CLI 내장 | 미완료 대화 계속하기 |
| jq / grep / less | 명령줄 | 스크립트 일괄 처리 |
| 범용 JSONL/로그 뷰어 | 에디터 플러그인 등 | 원본 데이터 구조 확인 |
우리의 추천: CCViewer
2026년 「전용 Claude Code 세션 뷰어」 하나를 고른다면 오픈소스 CCViewer(ccviewer.top)를 추천합니다 — 가장 화려해서가 아니라 이 시나리오에서 핵심을 모두 제대로 잡았기 때문입니다:
- JSONL 세션 형식을 위해 태어남: 범용 로그 도구가 아니라 Claude Code의 항목 구조를 네이티브로 이해 — 사용자 메시지, Markdown 응답, 사고 블록, 도구 호출 파라미터와 결과, 이미지, 비용 스냅샷을 바로 렌더링;
- 프라이버시 최우선: 100% 브라우저 내 파싱, 제로 업로드, 제로 텔레메트리. 세션 파일에는 소스 코드와 시크릿이 있으므로 로컬 렌더링이 이런 도구의 최소 요건이어야 합니다;
- 세션 라이브러리:
~/.claude/projects/전체를 드롭하면 프로젝트별 그룹화, 시간/메시지 수/토큰/비용 정렬, IndexedDB 영속화로 다음에 열어도 그대로; - 통계와 내보내기: 세션별 토큰 사용량, API 소요 시간, 줄 증감, 총 비용. 클릭 한 번으로 Markdown 내보내기해 보관·공유;
- 장벽 없음: 무료, 오픈소스(MIT), 설치·가입 불필요, UI는 10개 언어 지원.
대안이 더 나은 때
- claude --resume: 단순히 「이어서 대화」가 목적이면 가장 빠릅니다. 도구 전환이 없죠. 하지만 대화 계속에 최적화되어 있어 기록 읽기에는 부적합하고, 긴 세션 검색이 비효율적이며 비용 통계도 없습니다;
- jq / grep: 스크립트로 일괄 분석(전 프로젝트 토큰 소비 집계 등)이나 간단한 조회에는 대체 불가능합니다. 가독성 제로가 그 대가죠;
- 범용 JSONL 뷰어/에디터: 데이터 구조 확인이나 포맷 디버깅에 유용합니다. 다만 Claude Code의 의미(사고, 도구 호출, 사용량)를 이해하지 못해 결국 JSON 덩어리로 표시됩니다.
결론
일상적인 열람과 정리: CCViewer. 작업 계속: claude --resume. 일괄 스크립트 분석: jq. 셋은 경쟁하지 않습니다 — 오히려 CCViewer의 내보내기가 만들어내는 Markdown은 다른 도구에 넣기 좋은 재료입니다.
CCViewer로 Claude Code 세션을 시각적으로 재생하기
페이지를 열고
페이지를 열고
.jsonl 파일 또는 ~/.claude/projects/ 폴더 전체를 끌어다 놓기만 하면 됩니다. Markdown 렌더링, 사고 블록, 도구 호출, 토큰·비용 통계가 모두 브라우저에서 로컬로 처리되며 어떤 데이터도 업로드되지 않습니다.
자주 묻는 질문
CCViewer는 무료인가요? 유료화 계획은?
MIT 라이선스의 무료 오픈소스이며 등록도 필요 없습니다. 도구 자체가 브라우저에서 동작해 서버 비용이 사실상 없어 장기적으로도 안심하고 사용할 수 있습니다.
공식 도구와 관련이 있나요?
없습니다. CCViewer는 Anthropic과 무관한 독립 커뮤니티 오픈소스 프로젝트이며, Claude Code가 로컬에 생성하는 세션 파일을 읽을 뿐입니다.
데스크톱 앱도 있나요?
현재는 웹 앱입니다(오프라인 사용 가능, HTML 파일 하나만 열면 됨). PWA/데스크톱 버전은 로드맵에 있으니 GitHub에 issue를 열어 투표하거나 기여해 주세요.