对话记录(Transcript)
一个会话保存下来的文件记录。用图和例子讲清它是什么、怎么运作、怎么用,以及要注意什么。
它是什么
对话记录(transcript)是会话保存下来的文件记录。对话是你和 互相说的话;对话记录是把这段对话存成文件。 在你工作时不断保存它,所以退出或运行 /clear 之后你还能回来。恢复时,Claude Code 读回这个文件,还原消息、和结果。
它怎么工作
-
你在会话里工作
-
每条消息存成一行
-
你退出或清空
-
恢复时读回文件
怎么使用
-
~/.claude/projects/<project>/<session-id>.jsonl默认位置,每行一个 对象。
-
claude --continue或claude --resume重新打开最近的会话,或从列表里选一个。
-
/export复制对话,或存成人能读的文件。
-
cleanupPeriodDays改变对话记录保留多久(默认 30 天)。
注意
每一行的格式是 Claude Code 内部的,会随变化,所以直接读这些文件的脚本可能会坏;请改用 /export 或带 JSON 输出的 claude -p。旧的对话记录在保留期过后会被删除。对话记录文件和屏幕上的对话记录查看器不同,查看器只是显示同一段对话。
相关术语
原文和官方文档
本页用简单的话解释这个术语。以原文为准:如果两者不同,请按原文。