# 导出 Claude Code 会话

每个会话一条 Markdown 笔记，原始日志放在旁边，Claude Code 删除后仍然保留。

[下载 Mac 版](https://apps.apple.com/us/app/exporter-notes-to-markdown/id6741618455?mt=12)

## 一个会话，变成一条笔记。

每一轮一个段落，带时间和块 id；工具调用精简为实际运行的内容；编辑以 diff 呈现。推理、工具结果和工具内部提示永远不会进入笔记。

`2026-08-23 2233 fix the changelog header link.md`

```markdown
---
agent: claude-code
session: "a87cea2b-6f0e-4b1c-9d2a-3e4f5a6b7c8d"
title: "fix the changelog header link"
project: "wander.md"
cwd: "/Users/anton/products/wander.md"
branch: "main"
model: claude-fable-5-1
started: 2026-08-23T20:33:00Z
ended: 2026-08-23T20:40:04Z
turns: 5
prompts: 3
tools: 4
files:
  - "src/layout.astro"
---

**you** · 22:33 ^turn-1

see the changelog page, the header link goes to /contact

**claude** · 22:34 ^turn-2

I'll look at the live page first.

```tool Bash "find docs route" ^toolu_01A
ls src
```

```diff src/layout.astro ^toolu_01B
- <a href="/contact">contact</a>
+ <a href="/changelog">changelog</a>
```
```

## 导出的内容

每个项目一个文件夹，每个会话一条笔记，另有原始日志位于 `originals/`。名称由会话的日期、时间和标题组成。

- 可链接的轮次: 每一轮都是带块 id 的段落，其他笔记可以精确指向那次交流。
- 工具调用，折叠显示: 一次工具调用是一个块，包含它运行的内容和简短说明。结果、推理和工具内部提示都不包含在内。
- 编辑以 diff 呈现: 每次 Edit 和 Write 都显示为 diff，frontmatter 列出会话改动过的文件。
- 粘贴的图片: 粘贴到会话中的图片会以文件形式写在笔记旁边，并嵌入到该轮中。
- 原始日志，完整保留: JSONL 日志逐字节复制。把它复制回 ~/.claude/projects，`claude --resume` 就能找到它，即使 Claude Code 早已清理。
- 运行时实时更新: 进行中的会话会随日志增长更新笔记；只重新读取有变化的日志，所以 800 个会话几秒内就能同步。

## 工作原理

1. 连接 Claude Code: 面板会在你的 .claude 文件夹中打开：点按“选择此文件夹”。Exporter 只读取其中的 projects 文件夹，不会弹出权限请求。
2. 选择会话: 所有会话默认勾选。筛选可显示最近、最长和运行中的会话，搜索框可按标题、第一个问题或项目查找会话。选择 Markdown、原始日志或两者。
3. 自动同步: 点按“立即同步”。每个会话变成其项目下的一条笔记，仍在运行的会话会在你工作时重写笔记。

工作原理: [文档：Claude Code](https://exporter.dev/zh-hans/docs/claude-code) · 指南: [Claude Code 会话](https://exporter.dev/zh-hans/guides/claude-code/keep-claude-code-sessions)

## 常见问题

### 日志在哪里？

Claude Code 在 ~/.claude/projects 下、以工作目录命名的文件夹中，为每个会话写一个 JSONL 文件，并在最后一行写入三十天后删除。Exporter 只读取这个文件夹，不读 ~/.claude 中的其他内容。

### 什么是免费的？

你最近的 50 个会话免费导出并持续同步。解锁 Claude Code 是 Exporter 内的一次性购买。

### 会上传任何东西吗？

不会。Exporter 读取日志，把文件写到你的 Mac 上。没有账户，没有服务器。

## 与其他方式对比

Claude Code 没有自带导出；日志只能用脚本读取，三十天后就会消失。

| | Exporter | 读取 JSONL 的脚本 | 复制粘贴 |
|---|---|---|---|
| 一次导出所有会话 | 是 | 是 | 否 |
| 易读的 Markdown，每个会话一条笔记 | 是 | 手动 | 手动 |
| 保留调用和 diff，去掉噪音 | 是 | 手动 | 否 |
| 删除后仍保留原始日志 | 是 | 手动 | 否 |
| 会话运行时同步 | 是 | 否 | 否 |
| 价格 | 50 个会话免费，之后一次性购买 | 免费 | 免费 |

## 让 Claude 读取它自己的历史

导出的会话可以通过 Exporter 的本地 MCP 服务器查询。[设置](https://exporter.dev/docs/mcp)。

连接 Claude Code。 然后问：“上个月我们对 changelog 的页眉做了什么决定？”Claude 会把会话当作笔记来读。

```sh
claude mcp add --transport http exporter http://localhost:8744/mcp
```

## Related

- [Export Apple Notes to Markdown](https://exporter.dev/notes): Apple Notes as Markdown, kept in sync
- [Documents](https://exporter.dev/documents): Word, slides, sheets and PDFs to Markdown
- [MCP server](https://exporter.dev/docs/mcp): Connect Claude and other agents

---

human version: https://exporter.dev/zh-hans/claude-code
every page: https://exporter.dev/llms.txt