Claude Code 세션의 전체 기록을 어떻게 확인하나요?

Claude Code는 모든 세션을 로컬 디스크에 완전히 기록합니다. 기록을 보는 대표적인 방법은 세 가지이며, 사용 편의성 순으로 소개합니다.

방법 1: CCViewer로 브라우저에서 시각적으로 재생(권장)

CCViewer는 무료 오픈소스 Claude Code 세션 뷰어입니다. 페이지를 열고 세션 파일을 드롭하기만 하면(~/.claude/projects/ 폴더 전체를 가져올 수도 있음) 채팅 기록처럼 세션을 재생할 수 있습니다:

• 완전한 Markdown 렌더링 — 코드 블록, 표, 목록, 링크를 그대로 표시. 긴 JSON 나열과는 이별;
• 사고 블록(thinking) — 모델의 확장 추론을 접었다 펼 수 있음;
• 도구 호출 — Read / Edit / Bash 등 모든 호출의 파라미터와 결과를 펼쳐서 확인;
• 사용량·비용 통계 — 입력/출력/캐시 토큰, 세션 시간, 코드 줄 증감, 총 비용을 한눈에;
• Markdown 내보내기 — 어떤 세션이든 클릭 한 번으로 공유 가능한 .md 문서로.

가장 중요한 점은 파싱과 렌더링이 100% 브라우저에서 로컬로 이루어지고 아무것도 업로드되지 않는다는 것입니다. 세션 파일에는 소스 코드, 파일 경로, 때로는 시크릿이 포함되므로 이는 중요합니다.

방법 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 브랜치, 타임스탬프 등 메타데이터 포함)이지만 가독성은 낮습니다 — 바로 이래서 그래픽 뷰어가 존재합니다.

세 가지 방법 비교

자주 묻는 질문