一、项目介绍

用上 Claude Code、Codex、Copilot、Cursor 之后，你每天都会产生成千上万条对话。但这些工具几乎都不提供「回头看历史」的能力：想比较两个 Agent 的 token 用量、跨工具搜索某次讨论、复盘自己是怎么把功能做出来的，全都做不到，历史就这样散落在各处的本地文件里。
Claude Code History Viewer（CCHV）是一个桌面应用加无头服务器，把你 30 多种 AI 编码助手的会话历史统一收集、检索和分析。它支持 Claude Code、GitHub Copilot、Gemini CLI、Codex、Cursor、OpenCode 等，让你在一个界面里对比 token、跨提供商搜索、复盘工作流。

二、项目基本信息

信息项详情
项目名称claude-code-history-viewer
GitHub地址https://github.com/jhlee0409/claude-code-history-viewer
项目描述Desktop app and web server to browse, search and analyze your AI coding assistant history — Claude Code, Codex CLI, GitHub Copilot, Gemini CLI, Cursor, OpenCode and more. 100% offline.
作者jhlee0409
开源协议MIT License
开源状态公开
LanguagesTypeScript
支持平台Windows / macOS / Linux
最后更新2026-10-28

三、核心优势

  • 多助手聚合：一套界面看 30+ 编码助手的历史
  • 跨平台：提供 macOS / Windows / Linux 安装包与 AppImage
  • 无头服务：可跑在 VPS，通过 WebUI 远程访问
  • 本地优先：直接读本地会话文件，数据不出机器
  • 可分析：对比 token 用量、搜索与复盘工作流

四、适用场景

适合重度使用多个 AI 编码助手、需要复盘会话、统计成本或统一管理历史的开发者与团队。想随时回看「上次怎么解决的那个 bug」时尤其省心。

五、安装教程

当前最新版本 latest。按下方命令安装：

# macOS（Homebrew）：
brew install --cask jhlee0409/tap/claude-code-history-viewer
# 无头服务器（任意平台，需 Node）：
curl -fsSL https://raw.githubusercontent.com/jhlee0409/claude-code-history-viewer/main/install-server.sh | sh
cchv-server --serve   # 打开 http://localhost:3727

常见报错：依赖缺失时先升级对应运行环境（Node、Python、.NET、Go、Java、Rust、Bun、JDK）；网络超时多为镜像或代理问题，可重试或换源；Docker 相关命令需已安装并启动 Docker 服务；涉及 API Key 的服务请提前在环境变量或配置文件中填好。

六、使用示例

下面是一段可直接参考的真实示例：

# 启动无头服务后，浏览器打开：
# http://localhost:3727
# 在界面里选择 Claude Code 的 ~/.claude/projects/ 目录，
# 即可看到全部会话、按 token 排序、跨助手搜索关键词。
# 桌面端则直接打开 App，导入本地会话文件夹即可。

七、常见问题

问：支持哪些助手？答：Claude Code、Copilot、Gemini CLI、Codex、Cursor、OpenCode 等 30+。问：远程访问安全吗？答：无头服务建议保留鉴权，不要裸奔到公网。

八、总结

claude-code-history-viewer 用清晰的设计，把把历史或代理收进统一工作台这件事从重复劳动变成了可复用、可维护的工程能力。它不追求大而全，而是把核心痛点解决得足够扎实，这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。