daaain/claude-code-log

A Python CLI tool that converts Claude Code transcript JSONL files into readable HTML / Markdown format.

Claude Code Log – 무엇인가요

Claude Code (Anthropic의 IDE 어시스턴트)가 생성한 JSONL 트랜스크립트 파일을 읽고 깔끔하고 탐색 가능한 HTML 또는 Markdown 로그로 변환하는 작은 Python 명령줄 유틸리티입니다.

왜 존재하는가

Claude Code는 모든 프롬프트, 응답, 도구 호출, 시스템 명령을 줄 단위 JSON 레코드로 저장합니다. 이러한 원시 파일은 사람이 읽거나 공유하기 어렵습니다. Claude Code Log는 자동 변환을 수행하고 탐색 기능, 토큰 사용량 통계, 날짜 범위 필터링, 터미널 UI를 추가하여 다음을 가능하게 합니다:

단일 세션 또는 전체 ~/.claude/projects/ 계층을 검토할 수 있습니다.
어떤 LLM에도 분석용으로 피드백 가능한 컴팩트한 Markdown 덤프를 내보낼 수 있습니다.
대화 타임라인을 시각화하고 메시지 유형을 필터링하며 각 부분이 소비한 토큰 수를 확인할 수 있습니다.

핵심 기능 (README에 설명됨)

기능	기능 설명
인터랙티브 TUI	세션 탐색, HTML/MD 생성, 세션 재개, 빠른 통계를 제공하는 터미널 UI.
프로젝트 전체 처리	`~/.claude/projects/`를 스캔하고 각 프로젝트에 대한 카드와 프로젝트별 통합 트랜스크립트를 포함하는 상위 레벨 인덱스 페이지를 생성.
단일 파일/디렉터리 모드	개별 `transcript.jsonl` 또는 그 디렉터리 내 파일을 변환 가능.
HTML 내보내기	최소한의 반응형 페이지. 구문 강조 코드, 런타임 JavaScript 필터, 토큰 카운터, 부유형 상단으로 이동 버튼 포함.
Markdown 내보내기	GitHub 형식 Markdown; `--compact`는 연속된 동일 유형 섹션을 병합하고, `--detail`은 세부 정보 수준을 제어.
토큰 사용량 추적	메시지별 및 세션별 토큰 수를 표시.
날짜 범위 필터링	자연어 날짜(`"yesterday"`, `"last week"` 등)로 출력 범위를 제한.
Git SHA 링크	SHA 유사 문자열을 감지하고 GitHub/GitLab/Bitbucket 또는 사용자 정의 URL 템플릿으로 클릭 가능한 링크로 변환.
풍부한 메시지 지원	사용자, 어시스턴트, 시스템, 도구 사용/결과, 사고, 이미지 메시지를 모두 지원.
다중 세션 요약 일치	비동기적으로 도착하는 Claude 생성 요약과 원본 세션을 일치시킴.
프로바이더 훅 (실험적)	`--provider`를 통해 Antigravity CLI (`agy`) 및 Codex CLI (`codex`)에서 직접 내보내기 가능.

일반적인 사용 사례

개인 감사 – "지난 주에 Claude와 무엇을 했는가?" → claude-code-log --from-date "last week" --open-browser 실행.
비용 추적 – 세션별 토큰 사용량으로 Claude Code 사용 비용 추정 가능.
공유 – 세션을 HTML로 내보내고 팀원에게 링크를 전송.
LLM 기반 분석 – 컴팩트한 Markdown 덤프(--detail low --format md --compact)를 생성하고 다른 모델에 피드백하여 패턴 탐지 또는 요구사항 추출 수행.
버전 관리 링크 – 클릭 가능한 커밋 해시를 통해 대화에서 직접 관련 코드 변경으로 이동 가능.

시작하기

# 영구 설치 없이 빠른 한 줄 명령어
uvx claude-code-log@latest --open-browser

# 또는 pip로 설치
pip install claude-code-log

# 기본 명령어
claude-code-log               # 모든 ~/.claude/projects/ 처리 후 index.html 열기
claude-code-log my-project --tui   # 단일 프로젝트용 터미널 UI 시작
claude-code-log transcript.jsonl -o session.md --detail low --format md --compact

확장성 및 커뮤니티

프로젝트에는 테스트 및 아키텍처 노트가 포함된 CONTRIBUTING.md가 함께 제공됩니다.
커뮤니티 확장에는 채팅 내에서 사용 가능한 archive-session 스킬/명령어가 포함됩니다.
TODO 목록에는 UI 튜토리얼, 병렬 처리, Git worktree 병합, GitHub Action 래퍼 추가가 포함되어 있습니다.

위의 모든 정보는 리포지토리의 README에서 직접 가져왔으며, 추가적인 가정은 없습니다.*