一、工具简介Claude Conversation Extractor是一款专为 Claude Code 用户设计的命令行工具用于解决 Claude Code 官方不提供对话导出功能的痛点。它直接读取 Claude Code 存储在本地~/.claude/projects/目录下的 JSONL 格式日志文件将其转换为干净、可读的 Markdown 文档方便你备份、归档或后续分析。该工具的核心特点包括零依赖仅使用 Python 标准库无需安装任何额外包跨平台支持 Windows、macOS 和 Linux只读安全不会修改 Claude Code 的原始文件也不会上传任何数据实时搜索支持按内容、日期或会话名称搜索对话批量导出可一次性导出所有会话或仅导出最近的几条二、安装方法pipinstallclaude-conversation-extractor⚠️ 注意在较新的系统如 Ubuntu 23.04、macOS 13上直接运行pip install可能会遇到 “externally managed environment” 错误此时建议改用 pipx 或创建虚拟环境。三、快速上手安装完成后系统会提供以下命令命令说明claude-extract主命令启动交互式界面或执行导出claude-startclaude-extract的快捷别名功能相同claude-search搜索对话内容3.1 启动交互式界面claude-start# 或claude-extract--interactive# 或claude-extract-i启动后你会看到一个带有 ASCII 艺术标志的交互式终端界面提供以下选项输入A— 导出所有对话输入R— 导出最近5条对话输入S—选择特定对话导出输入Q— 退出界面会列出所有对话的日期和大小并支持选择导出目录如 Desktop、Documents、Downloads。3.2 命令行模式常用# 列出所有 Claude 会话claude-extract--list# 导出最近 5 个会话claude-extract--recent5# 导出指定编号的会话多个用逗号分隔claude-extract--extract1,3,5# 导出所有会话claude-extract--all# 导出到指定目录claude-extract--all--output~/Documents/Claude-Backups四、搜索功能详解claude-search是该工具的一大亮点支持全文实时搜索无需记住复杂的命令参数。# 交互式搜索提示输入关键词claude-search# 直接搜索特定内容claude-searchAPI integrationclaude-searcherror handlingclaude-searchDocker 部署搜索特性全文检索不区分大小写支持部分匹配预览上下文显示匹配内容的上下文片段直接导出在搜索结果中可直接选择导出匹配的会话五、数据存储位置与导出格式5.1 Claude Code 原始日志位置Claude Code 将对话记录以 JSONL 格式存储在以下路径平台路径macOS / Linux~/.claude/projects/*/chat_*.jsonlWindows%USERPROFILE%\.claude\projects\*\chat_*.jsonl5.2 导出文件格式默认导出为Markdown文件保存路径通常为~/Desktop/Claude logs/claude-conversation-YYYY-MM-DD-XXXXXX.mdMarkdown 格式已清理了终端转义码和 ANSI 颜色代码保留了纯净的对话内容适合直接阅读或导入到 Obsidian、Notion 等笔记软件中。六、进阶用法6.1 配合 Obsidian 构建知识库你可以将导出的 Markdown 文件自动导入 Obsidian 等笔记软件构建个人 AI 对话知识库。具体流程包括创建导出目录mkdir -p ~/claude-exports定期执行claude-extract --all --output ~/claude-exports编写后处理脚本自动添加 YAML frontmatter 和标签通过 cron 定时任务实现每日自动备份6.2 语义搜索可选增强如果你需要更强大的语义搜索能力可以安装 spaCypipinstallspacy python-mspacy download en_core_web_sm安装后搜索功能将支持基于语义的理解而不仅仅是关键词匹配。七、常见问题排查7.1 提示 “No Claude sessions found”确认使用过 Claude Code该工具仅适用于 Claude Code 的命令行版本不适用于 claude.ai 网页版。你必须至少成功运行过一次claude命令。检查日志目录是否存在ls-la~/.claude/projects/# macOS/Linuxdir%USERPROFILE%\.claude\projects\# Windows确认权限确保当前用户有读取~/.claude/projects/的权限。7.2 命令找不到command not foundmacOS/Linux# 将 ~/.local/bin 加入 PATHechoexport PATH$HOME/.local/bin:$PATH~/.zshrcsource~/.zshrcWindows# 将 Python Scripts 目录加入环境变量setx PATH%PATH%;C:\Users\YourName\AppData\Local\Programs\Python\Python311\Scripts7.3 安装后无法运行# 验证安装pipx list|grepclaude# 或pip show claude-conversation-extractor# 查看帮助claude-extract--helpclaude-extract--version八、隐私与安全说明该工具在设计上充分考虑了隐私保护✅100% 本地运行所有处理都在你的机器上完成不会发送任何对话内容到外部服务器✅无需联网安装后完全离线工作✅无遥测不包含任何追踪、分析或数据收集✅开源可审计源代码托管在 GitHub 上可自由审查✅只读访问仅读取 Claude Code 的日志文件不会修改或删除原始数据九、总结Claude Conversation Extractor 填补了 Claude Code 生态中对话管理的空白让你能够真正拥有自己的 AI 对话数据。无论是日常备份、知识归档还是配合笔记软件构建第二大脑这款工具都能胜任。如果你在使用过程中遇到问题可以访问项目仓库提交 Issue 或参与贡献GitHub 仓库https://github.com/ZeroSumQuant/claude-conversation-extractor当前版本v1.1.0截至 2025 年 9 月