保留每一个 Claude Code 会话
每个会话都是可以阅读和链接的笔记,原始日志也保留。
步骤
- 连接 Claude Code。在 Claude Code 卡片上点按“连接”。面板会在你的
.claude文件夹中打开并显示隐藏文件:点按“选择此文件夹”。Exporter 只读取其中的projects文件夹。 - 选择笔记存放位置。点按“选择导出文件夹”。仓库内的文件夹会被直接使用;直接位于个人文件夹中的文件夹会在其中新建一个
claude-code-sessions-export文件夹。 - 选择格式。在“保存到”一行选择 Markdown、原始日志或两者。默认是两者:笔记用来阅读,日志用来恢复。
- 点按“立即同步”。每个会话变成项目文件夹中的一条笔记,以日期、时间和标题命名。进行中的会话会在你工作时重写笔记。
- 之后查找。卡片上的搜索框匹配标题、第一个问题或项目;“运行中”筛选显示正在进行的会话,“最长”显示最大的会话。
你会得到什么
每个会话一条笔记:frontmatter 包含项目、分支、模型、时间、计数以及会话改动过的文件,然后是每一轮一个带时间和块 id 的段落。工具调用是包含运行内容的简短块,编辑是 diff 块,粘贴的图片是笔记旁边的文件。推理、工具结果和工具内部提示都不包含在内,所以笔记读起来就像对话本身。原始 JSONL 日志逐字节保存在 originals/ 中。把它复制回 ~/.claude/projects,claude --resume 就能再次找到该会话,即使 Claude Code 早已清理。
注意事项
- 会话包含你粘贴进去的内容,包括令牌和终端输出。请导出到你信任的文件夹,或不与共享仓库同步的文件夹。
- 你最近的 50 个会话免费。更早的会话需要一次性解锁,而被 Claude Code 删除的会话无论如何都保留其文件。
- 子代理的日志不是独立会话,而是并入其主会话。如果某个会话看起来很短,它的工作可能是在子代理中完成的。