5分钟上手claude-code-transcripts：从安装到生成第一个会话转录本

【免费下载链接】claude-code-transcripts Tools for publishing transcripts for Claude Code sessions 项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-transcripts

claude-code-transcripts是一款强大的工具，能够将Claude Code会话文件转换为可浏览的多页面HTML转录本，帮助开发者轻松记录和分享AI辅助编程过程。本文将带你快速掌握从安装到生成第一个会话转录本的全过程。

📦 快速安装：两种简单方法

方法一：使用uv工具安装（推荐）

claude-code-transcripts推荐使用uv工具进行安装，这是一种快速、现代的Python包管理方式。只需在终端中运行以下命令：

uv tool install claude-code-transcripts

方法二：不安装直接运行

如果你不想安装该工具，也可以使用uvx直接运行：

uvx claude-code-transcripts --help

提示：如果你还没有安装uv，可以通过官方渠道获取。该工具要求Python版本>=3.10，确保你的环境满足此要求。

🚀 生成第一个会话转录本

基本命令格式

claude-code-transcripts提供了多种生成转录本的方式，最基本的命令格式为：

claude-code-transcripts

从本地文件生成

如果你有本地的会话文件（JSON或JSONL格式），可以使用以下命令生成转录本：

claude-code-transcripts json session.json -o ./my-transcript

这条命令会将session.json文件转换为HTML转录本，并输出到./my-transcript目录中。你可以在该目录下找到生成的index.html文件，以及page-001.html、page-002.html等分页文件。

从网络会话生成

如果你想直接从Claude Code的网络会话生成转录本，可以使用web命令：

claude-code-transcripts web SESSION_ID

将SESSION_ID替换为你的实际会话ID即可。

自动打开生成的转录本

添加--open参数可以在生成转录本后自动在浏览器中打开它：

claude-code-transcripts json session.jsonl --open

🔄 高级用法：分享与导出

生成GitHub Gist分享链接

使用--gist选项可以自动将转录本上传到GitHub Gist，并获取一个可分享的预览URL：

claude-code-transcripts --gist

注意：使用--gist选项需要安装并认证GitHub CLI（gh），可以通过gh auth login命令进行认证。

生成JSON格式输出

如果你需要JSON格式的转录本，可以使用--json参数：

claude-code-transcripts json session.json -o ./my-transcript --json

这将在输出目录中生成一个JSON文件，包含会话的结构化数据。

📋 常见问题与注意事项

安装问题

如果在安装过程中遇到问题，可以尝试检查Python版本是否满足要求（>=3.10），或者使用uvx直接运行工具而不安装。

会话ID获取

网络会话的SESSION_ID可以从Claude Code的URL中获取，通常是一个类似SESSION_ABC123的字符串。

输出目录结构

生成的转录本会包含多个文件，主要包括：

• index.html：转录本主页
• page-001.html, page-002.html等：分页的转录内容
• 可能的JSON文件（如果使用了--json选项）

通过以上步骤，你已经掌握了claude-code-transcripts的基本使用方法。无论是记录个人的AI编程会话，还是分享与团队协作，这款工具都能帮助你轻松完成转录本的生成和管理。开始使用它，让你的AI辅助编程过程更加高效和可追溯吧！

【免费下载链接】claude-code-transcripts Tools for publishing transcripts for Claude Code sessions 项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-transcripts