快速入门#
从零开始：了解 Claude Code 会话存储结构，选择合适的导出工具，完成第一次导出。
1. 会话存储在哪里#
Claude Code 的所有对话记录保存在 ~/.claude/ 目录下：
| 路径 | 说明 |
|---|---|
~/.claude/projects/ | 按项目组织的会话数据（各工具默认读取此目录） |
~/.claude/transcripts/ | 全局会话记录（文件名格式 ses_<id>.jsonl） |
~/.claude/history.jsonl | 主会话历史索引（JSONL 格式） |
项目级会话存储#
项目路径会被编码为目录名，规则是将 \ 和 : 替换为 -：
原始路径: D:\Documents\IDE\202602
编码后: D--Documents-IDE-202602完整路径示例：
~/.claude/projects/D--Documents-IDE-202602/
├── <session-uuid>.jsonl # 主会话文件
└── <session-uuid>/
└── subagents/
└── agent-<id>.jsonl # 子代理会话其他相关目录#
| 路径 | 说明 |
|---|---|
~/.claude/config.json | Claude Code 配置文件 |
~/.claude/settings.json | 用户设置 |
~/.claude/CLAUDE.md | 用户全局指令文件 |
~/.claude/debug/ | 调试信息 |
~/.claude/plans/ | 计划模式记录 |
~/.claude/tasks/ | 任务记录 |
~/.claude/todos/ | 待办事项 |
~/.claude/cache/ | 缓存数据 |
~/.claude/usage-data/ | 使用量数据 |
2. 选择导出工具#
| 你的需求 | 推荐工具 | 安装命令 |
|---|---|---|
| 需要搜索历史对话 | claude-conversation-extractor | pip install claude-conversation-extractor |
| 同时使用 Claude + Codex | ai-code-sessions | uvx ai-code-sessions |
| 只需快速导出 HTML | claude-code-transcripts | uvx claude-code-transcripts |
uvx是uv提供的命令，可以直接运行 Python 包而无需安装。如果提示uvx不可用，参考 常见问题 #1。
3. 完成第一次导出#
方案 A：最快上手（claude-code-transcripts）#
# 导出所有会话为 HTML 并在浏览器中打开
uvx claude-code-transcripts all -o ./claude-archive --open方案 B：搜索 + 多格式（claude-conversation-extractor）#
# 安装
pip install claude-conversation-extractor
# 查看最近 10 个会话
claude-extract --list --limit 10
# 导出最新会话为 Markdown
claude-extract --extract 1 --format markdown --output ./my-export
# 搜索关键词
claude-extract --search "PowerShell" --output ./search-results方案 C：双平台 + 自动化（ai-code-sessions）#
# 交互式选择并导出
uvx ai-code-sessions local
# 运行 Claude 并在退出时自动导出
uvx ai-code-sessions ctx my-feature --claude4. 导出格式对比#
以同一个会话（1,238 条消息）为例：
| 格式 | 文件大小 | 行数 | 特点 |
|---|---|---|---|
| Markdown（普通） | 686 KB | 17,809 | 纯文本，易编辑 |
| Markdown（详细） | 2.1 MB | — | 含工具调用，约为普通版 3 倍 |
| HTML | 813 KB | 15,417 | 带样式，浏览器友好 |
| JSON | 791 KB | 6,196 | 结构化，含时间戳 |