# 匯出 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-hant/docs/claude-code) · 指南: [Claude Code 工作階段](https://exporter.dev/zh-hant/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-hant/claude-code
every page: https://exporter.dev/llms.txt