claude-conversation-extractor 完整指南#

功能最强大的 Claude Code 会话导出工具，支持搜索、过滤、多格式导出。

安装#

# 方式 1：pip 安装（推荐）
pip install claude-conversation-extractor

# 方式 2：pipx 安装（隔离环境）
pipx install claude-conversation-extractor

安装后会获得 4 个命令（功能相同，只是别名）：

命令说明
claude-extract主命令（推荐使用）
claude-logs别名
claude-search交互式搜索（直接传入关键词）
claude-start启动交互式界面

核心功能#

1. 查看会话列表#

# 列出所有会话
claude-extract --list

# 只看最近 20 个
claude-extract --list --limit 20

2. 导出会话#

# 导出单个会话（编号 1 = 最新）
claude-extract --extract 1 --output ./my-export

# 导出多个会话（逗号分隔，无空格）
claude-extract --extract 1,3,5,10 --output ./selected

# 导出最近 N 个会话
claude-extract --recent 10 --output ./recent-10

# 导出所有会话
claude-extract --all --output ./all-sessions

3. 导出格式#

# Markdown（默认）— 适合编辑和搜索
claude-extract --extract 1 --format markdown --output ./md

# HTML — 适合浏览器查看，带样式
claude-extract --extract 1 --format html --output ./html

# JSON — 适合程序处理和数据分析
claude-extract --extract 1 --format json --output ./json

4. 详细模式#

包含工具调用（Bash、Read、Write 等）、MCP 响应、系统消息。文件体积约为普通版的 3 倍。

claude-extract --extract 1 --detailed --format markdown --output ./detailed

搜索功能#

这是此工具最强大的功能，其他两款工具不具备。

文本搜索#

# 基础搜索
claude-extract --search "PowerShell 配置"

# 区分大小写
claude-extract --search "PowerShell" --case-sensitive

正则表达式搜索#

# 搜索所有 Install-Module 命令
claude-extract --search-regex "Install-Module.*"

# 搜索所有 import 语句
claude-extract --search-regex "^import\s+\w+"

按日期过滤#

# 搜索特定日期之后的对话
claude-extract --search "配置" --search-date-from 2026-02-14

# 搜索日期范围
claude-extract --search "MCP" \
  --search-date-from 2026-02-01 \
  --search-date-to 2026-02-15

按发言者过滤#

# 只搜索用户的消息
claude-extract --search "PowerShell" --search-speaker human

# 只搜索助手的回复
claude-extract --search "PowerShell" --search-speaker assistant

组合搜索#

claude-extract --search "PowerShell" \
  --search-speaker assistant \
  --search-date-from 2026-02-01 \
  --search-date-to 2026-02-28 \
  --format html \
  --output ./powershell-feb

完整参数参考#

claude-extract [OPTIONS]

选项：
  --list                    列出所有会话
  --extract EXTRACT         导出指定会话（编号，逗号分隔）
  --all                     导出所有会话
  --recent RECENT           导出最近 N 个会话
  --output OUTPUT           输出目录
  --limit LIMIT             --list 显示数量限制
  --interactive, -i         启动交互式界面
  --search SEARCH           文本搜索
  --search-regex REGEX      正则表达式搜索
  --search-date-from DATE   起始日期过滤（YYYY-MM-DD）
  --search-date-to DATE     结束日期过滤（YYYY-MM-DD）
  --search-speaker SPEAKER  发言者过滤（human/assistant/both）
  --case-sensitive          区分大小写
  --format FORMAT           输出格式（markdown/json/html）
  --detailed                包含工具调用和系统消息
ai-code-sessions 完整指南 Forward