claude-replay
코딩 세션을 하나의 HTML 재생 파일로 바꾸는 도구
npm install -g claude-replay여러 코딩 도구의 세션 기록을 상호작용이 되는 HTML 재생 파일로 바꿉니다. 화면 녹화는 무겁고 기록 원문은 훑기 어렵다는 문제를 겨냥합니다. 만들어진 파일은 외부 의존성이 없는 단일 HTML 이라 메일로 보내거나 아무 데나 올리거나 문서에 끼워 넣습니다. 재생 속도를 조절하고 도구 호출과 사고 과정을 접었다 폈다 합니다. 책갈피와 장 구분, 색 주제 선택, 파일 활동 옆 화면이 들어 있습니다. 내보내기 전에 비밀값을 가리는 기능이 있습니다. 감시 모드로 돌리면 원격 기계나 컨테이너에서 도는 세션을 실시간으로 지켜봅니다. 앤트로픽과 무관한 커뮤니티 도구라고 저장소가 밝힙니다.
판단
이럴 때 씁니다
- 세션을 글에 끼워 넣어 보여 줄 때
- 버그 신고에 긴 로그 대신 재생을 붙일 때
- 원격에서 도는 세션을 실시간으로 볼 때
이럴 땐 쓰지 마세요
- 비밀값이 들어간 세션은 가리기 설정을 꼭 켜야 합니다
- 기록이 없으면 만들 것이 없습니다
- 매우 긴 세션은 파일이 커집니다
차별점
- 외부 의존성이 없는 단일 HTML 파일로 나옵니다.
- 일곱 종류 넘는 코딩 도구 기록을 자동으로 알아봅니다.
- 내보내기 전에 비밀값을 가리는 절차가 들어 있습니다.
- 감시 모드로 원격 세션을 실시간으로 봅니다.
워크플로
- 01전역으로 깝니다.
- 02형식이 자동 감지되게 둡니다.
- 03필요하면 비밀값을 가립니다.
- 04HTML 재생 파일을 만듭니다.
- 05문서에 끼워 넣거나 공유합니다.
주요 명령
| 명령 | 설명 |
|---|---|
npm install -g claude-replay | 설치합니다. |
npx claude-replay | 설치 없이 바로 씁니다. |
--serve --watch | 도는 세션을 실시간으로 지켜봅니다. |
함정
설치 전에 확인하세요
- 대화 내용이 그대로 들어갑니다. 내보내기 전에 비밀값 가리기를 확인해야 합니다.
- 도구마다 기록 위치가 다릅니다. 일부는 내보내기 명령을 먼저 돌려야 합니다.
- 일부 형식은 노드 22.5 이상의 내장 기능을 씁니다.
- 앤트로픽과 무관한 커뮤니티 도구입니다.
비교
세션을 남기는 방법은 화면 녹화나 기록 원문 붙여넣기가 보통입니다. 녹화는 무겁고 원문은 훑기 어렵습니다. 이쪽은 상호작용이 되는 가벼운 파일 하나로 그 사이를 메웁니다.
최근 변경
새 하네스 형식 지원이 들어갔습니다. 내보내기 파일을 읽는 것뿐 아니라 살아 있는 세션을 데이터베이스에서 직접 읽는데 노드에 내장된 기능을 써서 의존성을 늘리지 않았습니다.