daaain/claude-code-log

A Python CLI tool that converts Claude Code transcript JSONL files into readable HTML / Markdown format.

Claude Code Log – 是什麼

一個小型 Python 命令列工具，讀取 Claude Code（Anthropic 的 IDE 助手）產生的 JSONL 轉錄檔案，並轉換為乾淨、可瀏覽的 HTML 或 Markdown 日誌。

為何存在

Claude Code 將每個提示、回應、工具呼叫和系統命令都以逐行 JSON 記錄的形式儲存。這些原始檔案對人類來說難以閱讀或分享。Claude Code Log 自動完成轉換，加入導覽、token 使用統計、日期範圍過濾和終端 UI，使你能夠：

檢視單一會話或整個 ~/.claude/projects/ 層次結構。
導出緊湊的 Markdown 副本，可輸入到任何 LLM 中進行分析。
可視化對話時間軸，過濾訊息類型，並查看各部分消耗的 token 數量。

核心功能（如 README 所述）

功能	作用
互動式 TUI	終端 UI，用於瀏覽會話、產生 HTML/MD、恢復會話和快速統計。
專案級處理	掃描 `~/.claude/projects/`，建立頂層索引頁，為每個專案產生卡片和專案級合併轉錄。
單一檔案/目錄模式	轉換單一 `transcript.jsonl` 或任意目錄中的檔案。
HTML 導出	極簡、響應式頁面，支援語法高亮程式碼、執行時 JavaScript 過濾器、token 計數器和浮動的返回頂部按鈕。
Markdown 導出	GitHub 風格 Markdown；`--compact` 合併連續的同類型部分，`--detail` 控制詳細程度。
token 使用追蹤	顯示每則訊息和每個會話的 token 數量。
日期範圍過濾	支援自然語言日期（`"yesterday"`、`"last week"` 等）以限制輸出。
Git SHA 連結	檢測類似 SHA 的字串並轉換為可點擊連結，指向 GitHub/GitLab/Bitbucket 或自訂 URL 模板。
豐富訊息支援	支援使用者、助手、系統、工具使用/結果、思考和影像訊息。
跨會話摘要匹配	即使摘要異步到達，也能將 Claude 產生的摘要與原始會話對齊。
提供者鈎子（實驗性）	透過 `--provider` 直接從 Antigravity CLI（`agy`）和 Codex CLI（`codex`）導出。

典型使用情境

個人審計 – 「我上週和 Claude 做了什麼？」 → 執行 claude-code-log --from-date "last week" --open-browser。
成本追蹤 – 每個會話的 token 使用量有助於估算 Claude Code 的開銷。
分享 – 將會話導出為 HTML 並將連結傳送給同事。
LLM 驅動分析 – 產生緊湊的 Markdown 副本（--detail low --format md --compact）並輸入到另一個模型中進行模式檢測或需求提取。
版本控制連結 – 可點擊的提交哈希可讓你從對話直接跳轉到相關程式碼變更。

快速上手

# 無需永久安裝的一行命令
uvx claude-code-log@latest --open-browser

# 或透過 pip 安裝
pip install claude-code-log

# 基本命令
claude-code-log               # 處理所有 ~/.claude/projects/ 並開啟 index.html
claude-code-log my-project --tui   # 為單一專案啟動終端 UI
claude-code-log transcript.jsonl -o session.md --detail low --format md --compact

可擴充性與社群

專案附帶 CONTRIBUTING.md，包含測試和架構說明。
社群擴充包括 archive-session 技能/命令，可封裝 CLI 用於聊天中使用。
TODO 清單中提到了 UI 教學、平行處理、Git 工作樹合併和 GitHub Action 包裝器。

上述所有資訊均直接來自倉儲的 README；未做任何額外假設。*