Claude Code Log

코딩 세션 기록을 읽을 수 있는 HTML 로 바꾸는 도구

uvx claude-code-log@latest --open-browser

코딩 도구가 남긴 대화 기록 파일을 깔끔한 HTML 과 마크다운으로 바꿉니다. 사용자 프롬프트와 응답을 시간 순서대로 보여 주는 최소한의 화면을 만듭니다. 파일 하나도 되고 프로젝트 폴더 전체도 됩니다. 터미널 안에서 세션을 훑고 요약을 보고 바로 내보내거나 이어 가는 화면이 따로 있습니다. 감시 모드를 켜면 세션이 쓰이는 대로 다시 변환하므로 편집기나 노트 앱에서 보는 문서가 계속 최신입니다. 서버 모드에서는 열어 둔 세션 페이지가 메시지가 올 때마다 늘어나되 스크롤 위치와 접어 둔 부분이 유지됩니다. 메시지별 토큰 사용량과 세션 합계를 표시하고 종류별로 걸러 볼 수 있습니다.

판단

이럴 때 씁니다

  • 세션 기록을 나중에 다시 읽어야 할 때
  • 작업 내용을 문서로 남겨 공유할 때
  • 토큰 사용량을 메시지 단위로 확인할 때

이럴 땐 쓰지 마세요

  • 기록이 없으면 만들 것이 없습니다
  • 민감한 내용이 그대로 들어가므로 공유 전에 확인해야 합니다
  • 다른 도구 지원은 아직 실험 단계입니다

차별점

  • 터미널 안에서 세션을 훑는 화면과 브라우저 화면을 모두 제공합니다.
  • 감시 모드가 세션 진행에 맞춰 문서를 갱신합니다.
  • 스크롤 위치와 접은 부분을 유지한 채 페이지가 늘어납니다.
  • 메시지 단위 토큰 사용량과 시간 축 화면을 제공합니다.

워크플로

  1. 01설치 없이 바로 실행합니다.
  2. 02전체 프로젝트 폴더를 훑게 둡니다.
  3. 03만들어진 색인 페이지에서 세션을 찾습니다.
  4. 04필요하면 감시 모드로 계속 갱신합니다.
  5. 05마크다운으로 뽑아 문서에 붙입니다.

주요 명령

명령설명
uvx claude-code-log@latest --open-browser전체 기록을 변환하고 브라우저로 엽니다.
claude-code-log watch세션이 쓰이는 대로 다시 변환합니다.
claude-code-log serve --watch열어 둔 페이지가 메시지가 올 때마다 늘어납니다.

함정

설치 전에 확인하세요

  • 대화 내용이 그대로 HTML 에 들어갑니다. 공유하기 전에 무엇이 들어갔는지 확인해야 합니다.
  • 다른 코딩 도구 지원은 알파와 베타 단계입니다. 상위 형식이 바뀌면 깨질 수 있습니다.
  • 프로젝트 전체를 훑으면 파일이 많이 생깁니다. 출력 위치를 정해 두는 편이 낫습니다.
  • 감시 모드는 파일이 계속 쓰이는 동안만 의미가 있습니다.

비교

기록 파일을 직접 읽으면 형식이 사람이 볼 것이 아닙니다. 이쪽은 읽을 수 있는 형태로 바꾸고 검색과 필터까지 붙입니다. 대신 기록을 해석해 통찰을 주는 도구는 아닙니다.

최근 변경

세션이 쓰이는 대로 다시 변환하는 감시 모드가 들어갔습니다. 변환을 흘려보내는 방식으로 바꿔 성능을 올렸고 보관된 기록을 검색하는 서버도 추가됐습니다.

공식 변경 내역