将 Claude Code 对话导出为 Markdown 和 JSON

Agent Dump 可以将本地保存的 Claude Code 对话导出成文件。Markdown 适合项目笔记和代码评审，JSON 适合后续脚本处理。导出过程不会修改 Claude Code 的原始会话记录。

安装并找到对话

在使用 Claude Code 的那台机器上执行。如果已安装 npm 和 Node.js 22 或以上版本：

npm install -g @agent-dump/cli
agent-dump --list --days 30 --query 'provider:claude'

也可以选择原生二进制、Homebrew、Scoop 或 uv 安装。列表会筛选最近 30 天有更新的会话，包括创建得较早但最近还在使用的对话。需要按创建时间筛选时，增加 --time-field created。

根据标题和工作目录找到目标对话，复制完整的 claude://... URI。只查当前项目时，在项目目录中运行：

agent-dump --list --days 30 --query 'provider:claude path:.'

将 YOUR_SESSION_ID 替换为列表中的真实会话 ID：

agent-dump 'claude://YOUR_SESSION_ID' --format markdown --output ./exports

命令会打印保存路径。Markdown 文件位于当前工作目录下的 ./exports/claude/ 中。打开打印出的文件即可阅读。这个文件是对话记录，不会恢复原来的 Agent 进程或执行状态。

既需要阅读，又需要脚本处理时，可以一次生成两种格式：

agent-dump 'claude://YOUR_SESSION_ID' --format json,markdown --output ./exports

--format json 会写出导出文件。它与 --json 不同，后者用于受支持的查询和读取模式，将结构化结果写到标准输出。脚本只需要长对话的一部分时，可以使用分页读取。

如果需要在终端中手动选择多个会话：

agent-dump --interactive --query 'provider:claude' --format markdown --output ./exports

按照终端提示选择会话。这个流程需要交互式终端；自动化导出单个会话时，直接传入 URI。

执行 agent-dump --providers 检查源路径是否可用，并适当增大 --days。确认当前操作系统账号和机器与运行 Claude Code 时一致。path:. 匹配记录中的工作目录，可以移除它检查是否过滤掉了目标会话。

Agent Dump 读取本地保存的历史，不能从远程账号拉取缺失内容，也不能恢复被删除的源文件。分享导出文件前，先确认其中没有不适合公开的项目信息。