대화 기록(Transcript)
세션을 파일로 저장한 기록. 무엇인지, 어떻게 돌아가고 어떻게 쓰는지, 조심할 점까지 그림과 예로 풀어 봅니다.
무엇인가요
대화 기록(transcript)은 세션을 파일로 저장한 기록입니다. 대화는 사람과 가 주고받는 말이고, 대화 기록은 그 대화를 파일로 남긴 것입니다. 는 일하는 동안 계속 저장하므로, 끝내거나 /clear 를 한 뒤에도 다시 돌아올 수 있습니다. 세션을 이어 가면 Claude Code 가 파일을 다시 읽어 메시지··결과를 되살립니다.
어떻게 돌아가나요
-
세션에서 일합니다
-
메시지마다 한 줄씩 저장됩니다
-
끝내거나 비웁니다
-
이어 가기가 파일을 다시 읽습니다
이렇게 씁니다
-
~/.claude/projects/<project>/<session-id>.jsonl기본 저장 위치입니다. 한 줄에 하나가 있습니다.
-
claude --continue·claude --resume가장 최근 세션을 다시 열거나 목록에서 골라 엽니다.
-
/export대화를 복사하거나 사람이 읽기 쉬운 텍스트 파일로 저장합니다.
-
cleanupPeriodDays대화 기록을 얼마나 오래 둘지 바꿉니다(기본 30일).
주의할 점
줄의 형식은 Claude Code 내부용이라 마다 바뀌므로, 이 파일을 직접 읽는 스크립트는 깨질 수 있습니다. 대신 /export 나 JSON 출력의 claude -p 를 씁니다. 오래된 대화 기록은 보관 기간이 지나면 지워집니다. 대화 기록 파일은 같은 대화를 화면에 보여 주기만 하는 대화 기록 보기(transcript viewer)와 다릅니다.
함께 보면 좋은 용어
원문과 공식 문서
이 페이지는 용어를 쉬운 말로 풀어 쓴 것입니다. 기준은 원문이니, 다르면 원문을 따르세요.
불러오는 중…
취소할 대기 예약을 선택하세요. 각 예약은 확인 후 취소됩니다.
내 :