ByteNoteByteNote
字

字节笔记本

2026年2月22日

Claude Code History Viewer - 对话历史浏览器

#Claude Code

Claude Code History Viewer 是一款桌面应用，用于浏览和分析 Claude Code、Codex CLI 和 OpenCode 的对话历史。它提供了离线查看、全局搜索、Token 统计分析和可视化面板等功能，帮助开发者更好地管理和回顾 AI 编程助手的对话记录。

项目简介

Claude Code History Viewer 由 jhlee0409 开发维护，是一个开源的桌面应用程序。截至目前，该项目在 GitHub 上已获得 473+ stars，主要使用 TypeScript (75.8%) 和 Rust (20.8%) 编写。应用采用 Tauri 框架构建，支持 macOS、Windows 和 Linux 三大平台。

核心特性

特性描述
多平台支持统一查看 Claude Code、Codex CLI 和 OpenCode 的对话记录
对话浏览器按项目/会话导航，支持工作区分组
全局搜索瞬间搜索所有对话内容
分析面板Token 使用统计和 API 成本计算
会话面板多会话可视化分析，支持像素视图、属性刷选和活动时间线
设置管理器支持范围感知的 Claude Code 设置编辑和 MCP 服务器管理
消息导航右侧可折叠目录，快速跳转对话内容
实时监控实时监听会话文件变化，即时更新
会话上下文菜单复制会话 ID、恢复命令、文件路径；原生重命名并集成搜索
ANSI 颜色渲染终端输出保持原始 ANSI 颜色显示
多语言支持英语、韩语、日语、简体中文、繁体中文
最近编辑查看文件修改历史并恢复
自动更新内置更新器，支持跳过/推迟选项

技术栈

层级技术
后端Rust + Tauri v2
前端React 19 + TypeScript + Tailwind CSS
状态管理Zustand
构建工具Vite
国际化i18next（支持 5 种语言）

安装指南

直接下载

从 GitHub Releases 下载对应平台的安装包：

平台下载
macOS (Universal).dmg
Windows (x64).exe
Linux (x64).AppImage

Homebrew 安装 (macOS)

bash
# 添加 tap
brew tap jhlee0409/tap

# 安装应用
brew install --cask claude-code-history-viewer

# 或直接使用完整路径
brew install --cask jhlee0409/tap/claude-code-history-viewer

升级和卸载：

bash
# 升级
brew upgrade --cask claude-code-history-viewer

# 卸载
brew uninstall --cask claude-code-history-viewer

从源码构建

前置要求：

  • Node.js 18+
  • pnpm
  • Rust 工具链

构建步骤：

bash
# 克隆仓库
git clone https://github.com/jhlee0409/claude-code-history-viewer.git
cd claude-code-history-viewer

# 方式一：使用 just（推荐）
brew install just  # 或 cargo install just
just setup
just dev           # 开发模式
just tauri-build   # 生产构建

# 方式二：直接使用 pnpm
pnpm install
pnpm tauri:dev     # 开发模式
pnpm tauri:build   # 生产构建

使用说明

  1. 启动应用
  2. 应用会自动扫描所有支持的提供商（Claude Code、Codex CLI、OpenCode）的对话数据
  3. 在左侧边栏浏览项目 —— 使用标签栏按提供商筛选
  4. 点击会话查看消息
  5. 使用标签页切换消息、分析、Token 统计、最近编辑和会话面板视图

数据隐私

100% 离线运行。所有对话数据都保存在本地，不会发送到任何服务器。无分析、无追踪、无遥测。

故障排除

问题解决方案
"No Claude data found"确保 ~/.claude 目录存在且包含对话历史
性能问题大型历史记录初始加载可能较慢 —— 应用使用虚拟滚动优化
更新问题如果自动更新失败，请从 Releases 页面手动下载

项目链接

Claude Code
上一篇

Jenkins 配置 SSH Key 连接 GitHub

下一篇

Claude Code History Viewer - 对话历史浏览器

分享: