ai-code-sessions 完整指南#

claude-code-transcripts 的增强版 fork，支持 Claude + Codex 双平台，提供自动化工作流和变更日志功能。

安装#

# 方式 1：uvx 直接运行（无需安装，推荐）
uvx ai-code-sessions

# 方式 2：pip 安装
pip install ai-code-sessions

# 方式 3：pipx 安装
pipx install ai-code-sessions

命令列表#

命令说明
local选择并转换本地会话为 HTML（默认命令）
all转换所有本地会话为可浏览的 HTML 归档
json转换 JSON/JSONL 文件为 HTML
web从 Claude API 导出 web 会话
archive生成项目级归档（扫描 .codex/.claude）
changelog生成和管理项目变更日志
ctx运行 Claude/Codex 并在退出时自动导出
ctx-resume恢复之前的会话
resume恢复之前的会话（别名）
export-latest导出指定时间窗口内的会话
find-source查找匹配的原始会话日志文件
config查看配置
setup交互式配置向导

核心功能#

1. 基础导出#

# 交互式选择并导出本地会话
uvx ai-code-sessions local

# 导出所有会话为 HTML 归档
uvx ai-code-sessions all -o ./archive --open

# 转换指定的 JSONL 文件
uvx ai-code-sessions json path/to/session.jsonl

2. 会话包装器（ctx）— 独有功能#

运行 AI 工具并在退出时自动导出会话记录。

# 运行 Claude 并自动导出
uvx ai-code-sessions ctx my-feature --claude

# 运行 Codex 并自动导出
uvx ai-code-sessions ctx my-feature --codex

# 同时生成变更日志
uvx ai-code-sessions ctx my-feature --claude --changelog

3. 会话恢复（ctx-resume）— 独有功能#

# 交互式选择之前的 Claude 会话恢复
uvx ai-code-sessions ctx-resume claude

# 直接恢复最新的会话
uvx ai-code-sessions ctx-resume claude --latest

4. 项目级归档（archive）— 独有功能#

# 在当前 git 仓库生成归档
uvx ai-code-sessions archive

# 指定输出目录并打开
uvx ai-code-sessions archive -o ./my-archive --open

5. 变更日志（changelog）— 独有功能#

# 从已有的 ctx 会话回填变更日志
uvx ai-code-sessions changelog backfill

# 查看某个日期/提交之后的变更
uvx ai-code-sessions changelog since HEAD~5

与 claude-code-transcripts 的区别#

功能ai-code-sessionsclaude-code-transcripts
基础 HTML 导出✅✅
Codex 支持✅❌
会话包装器（ctx）✅❌
会话恢复（resume）✅❌
项目级归档（archive）✅❌
变更日志（changelog）✅❌
配置管理（config/setup）✅❌
日志级别控制✅❌
命令数量12 个4 个