CCViewer
GitHub
Claude Code 세션의 전체 기록을 어떻게 확인하나요?
로컬 세션의 기본 위치는 ~/.claude/projects/입니다. CLAUDE_CONFIG_DIR를 설정하면 기본 디렉터리가 바뀝니다. 저장 비활성화나 보존 기간에 따른 정리로 모든 기록이 영구 보관되지는 않습니다. 클라우드나 원격 세션은 실행 환경을 확인하세요.
방법 1: CCViewer로 브라우저에서 시각적으로 재생(권장)
CCViewer는 무료 오픈소스 Claude Code 세션 뷰어입니다. 페이지를 열고 세션 파일을 드롭하기만 하면(~/.claude/projects/ 폴더 전체를 가져올 수도 있음) 채팅 기록처럼 세션을 재생할 수 있습니다:
- 완전한 Markdown 렌더링 — 코드 블록, 표, 목록, 링크를 그대로 표시. 긴 JSON 나열과는 이별;
- 사고 블록(thinking) — 모델의 확장 추론을 접었다 펼 수 있음;
- 도구 호출 — Read / Edit / Bash 등 모든 호출의 파라미터와 결과를 펼쳐서 확인;
- 사용량·비용 통계 — 입력/출력/캐시 토큰, 세션 시간, 코드 줄 증감, 총 비용을 한눈에;
- Markdown 내보내기 — 어떤 세션이든 클릭 한 번으로 공유 가능한
.md문서로.
세션 파일은 브라우저에서 로컬로 분석하고 표시합니다. 온라인 사이트는 Microsoft Clarity를 자동으로 로드하여 페이지 상호작용을 기록합니다. 오프라인 사본은 분석을 로드하지 않습니다.
방법 2: 터미널에서 세션 재개
Claude Code에는 세션 재개 기능이 내장되어 있습니다. 원래 프로젝트 디렉터리에서 실행하세요:
# 이 프로젝트의 세션 목록을 표시하고 대화형으로 선택
claude --resume # 약칭: claude -r
# 가장 최근 세션을 바로 재개
claude --continue # 약칭: claude -c
# 세션 ID로 특정 세션 재개
claude --resume <sessionId>「계속 작업하기」에는 좋지만, 기록을 읽거나 검색하기엔 불편합니다. 긴 세션에서 특정 도구 호출을 찾는 건 고역이고 비용 통계도 없습니다.
방법 3: 원본 JSONL 파일 직접 읽기
세션은 ~/.claude/projects/<project>/<sessionId>.jsonl에 JSONL 형식(한 줄에 JSON 객체 하나)으로 저장됩니다. 아무 에디터나 명령줄로 확인할 수 있습니다:
# jq로 모든 사용자 프롬프트 추출
cat ~/.claude/projects/-Users-you-myproject/<sessionId>.jsonl \\
| jq -r 'select(.type=="user") | .message.content'원본 파일이 가장 완전한 정보원(토큰 사용량, git 브랜치, 타임스탬프 등 메타데이터 포함)이지만 가독성은 낮습니다 — 바로 이래서 그래픽 뷰어가 존재합니다.
세 가지 방법 비교
| CCViewer | claude --resume | 원본 JSONL | |
|---|---|---|---|
| 그래픽 읽기 | ✅ | 부분적(대화 계속) | ❌ |
| Markdown 렌더링 | ✅ | ✅ | ❌ |
| 사고 / 도구 호출 | ✅ 접기 가능 | 접힌 요약 | 원본 JSON |
| 토큰 / 비용 통계 | ✅ | ❌ | 수동 jq |
| 다중 세션 관리 | ✅ 폴더 가져오기 | 현재 프로젝트만 | ❌ |
세션 파일은 브라우저에서 로컬로 분석하고 표시합니다. 온라인 사이트는 Microsoft Clarity를 자동으로 로드하여 페이지 상호작용을 기록합니다. 오프라인 사본은 분석을 로드하지 않습니다.
세션 파일은 브라우저에서 로컬로 분석하고 표시합니다. 온라인 사이트는 Microsoft Clarity를 자동으로 로드하여 페이지 상호작용을 기록합니다. 오프라인 사본은 분석을 로드하지 않습니다.