使用 cctrace 导出 Claude Code 聊天会话

cctrace 是一款创新的开源命令行工具，旨在简化从 Claude Code 导出聊天会话的过程。对于开发者、数据科学家和 AI 爱好者而言，拥有详尽的 AI 交互记录，包括其内部推理和工具使用情况，是无价的。cctrace 提供了一个强大的解决方案，确保所有关键数据都被捕获并可供访问。

什么是 cctrace？

cctrace，是 "Claude Code Trace" 的缩写，一个基于 Python 的实用工具，允许用户将其 Claude Code 聊天会话导出为各种格式，如 Markdown、XML 和原始 JSONL。它设计得易于使用，既可在 Claude Code 内部通过简单的斜杠命令集成，也提供了灵活的命令行选项供高级定制。

主要功能：

• 自动会话检测： 即使在多个并发会话下，也能智能识别您当前的 Claude Code 会话，返回会话 ID、聊天记录及所有元数据。
• 完整数据捕获： 导出所有消息、"思考" 区块（内部推理）、工具使用（包括输入和输出），以及全面的元数据。
• 多种输出格式： 生成易于审阅的人类可读 Markdown 文件、用于编程处理的结构化 XML，以及用于详细分析的原始 JSONL。
• 斜杠命令集成： 直接在 Claude Code 会话中使用简单的 /export 命令进行导出。
• 带时间戳的归档： 每次导出都保存在一个独特的、带时间戳的目录中，便于组织。
• 自动复制到工作目录： 可选择将导出内容直接复制到您当前的项目目录，简化版本控制和访问。

为什么要使用 cctrace？

在当今快速发展的 AI 开发环境中，跟踪和分析 AI 交互至关重要。无论是调试提示词、记录 AI 行为，还是与团队共享见解，cctrace 都能确保您拥有完整、结构良好的记录。它能够捕获详细的内部推理和工具调用，这为理解 Claude Code 在会话期间的运作方式提供了前所未有的透明度。

cctrace 入门

环境要求：

• Python 3.6 或更高版本
• 在 Linux 或 WSL 上运行的 Claude Code
• 能够访问 ~/.claude/projects/ 目录

快速安装：

1. 克隆仓库：

   git clone https://github.com/jimmc414/cctrace.git
   cd cctrace
   

2. 运行安装程序：

   chmod +x install.sh
   ./install.sh
   

使用方法：

通过 Claude Code 斜杠命令（推荐）：

在您的 Claude Code 会话中，只需输入 /export 或 /user:export。该工具将自动检测并导出您当前的会话，并在 Claude Code 中直接显示摘要。

通过命令行：

若要进行更精细的控制，您可以直接运行 export_claude_session.py 脚本：

• 导出当前活动会话：

  python3 ~/claude_sessions/export_claude_session.py
  

• 通过 ID 导出特定会话：

  python3 ~/claude_sessions/export_claude_session.py --session-id <您的会话ID>
  

• 指定输出格式或目录：

  python3 ~/claude_sessions/export_claude_session.py --format xml --output-dir /path/to/my/exports
  

导出内容说明

每次导出都会创建一个带时间戳的目录，其中包含各种文件：

• session_info.json：全面的会话元数据，包括会话 ID、项目目录、时间戳和模型使用情况。
• conversation_full.md：包含完整对话的人类可读 Markdown 文件，带有用于思考区块和工具使用的可折叠部分。
• conversation_full.xml：一个完全标注的 XML 文件，保留所有元数据、消息层级和详细的工具执行信息，非常适合自动化处理。
• raw_messages.jsonl：来自 Claude Code 的原始、未经修改的 JSONL 数据，非常适合深入的程序化分析。
• summary.txt：会话和导出详情的快速纯文本概览。

cctrace 是任何使用 Claude Code 的人的必备工具，它提供了管理、分析和共享 AI 对话数据的手段。其开源性质鼓励社区贡献并确保持续改进。