字节笔记本
2026年10月5日 · 约 7 分钟读完
CCHV：25 个 AI 编程助手的历史，一个界面全看
现在不少开发者的日常是这样的：用 Claude Code 做架构和重构，用 Cursor 处理日常编码，用 Codex 跑测试，偶尔再用 Aider 改些小问题。每个工具都认真记下了你和它的全部对话，但这些历史散落在各自的文件夹里，路径不同、格式不同，想回头查一条记录相当费劲。
Claude Code History Viewer（下文简称 CCHV）就是为解决这个问题而生的开源工具：把 25 个 AI 编程助手的对话历史统一到一个界面里，可浏览、可搜索、可分析，并且全程本地离线运行。
一、它是什么
CCHV 是一个开源桌面应用（另提供无头服务器模式），把所有 AI 编程助手的对话历史统一到一个可搜索、可分析的界面。项目以 MIT 协议开源，技术栈为 Tauri v2 加 Rust 后端，前端是 React 和 TypeScript，支持 macOS、Windows、Linux 三个平台。
它宣称支持 25 个助手。我们核对了源码：src/utils/providers.ts 中的 PROVIDER_IDS 数组恰好定义了 25 个提供商，包括 Claude Code、GitHub Copilot、Gemini CLI、Codex CLI、Cline、Cursor、Cursor Agent、Aider、OpenCode、ForgeCode、Kimi、Kiro、Amazon Q、Goose、Qwen Code、Zed、OpenHands、Trae 等，常见的 CLI 工具与 IDE 插件基本都在列，Rust 后端也为每个提供商准备了独立的解析模块。
二、四个核心功能
1. 多助手统一浏览
每个助手的历史存放位置和格式都不一样，CCHV 的做法是自动发现并全部解析：
| 助手 | 数据位置 | 格式 |
|---|---|---|
| Claude Code | ~/.claude/projects/ | JSONL |
| Codex CLI | ~/.codex/sessions/ | JSONL rollout |
| Cursor Agent | ~/.cursor/projects/ | JSONL |
| Gemini CLI | ~/.gemini/ | JSON |
| Aider | 项目目录 | chat log |
| ForgeCode | ~/.forge/.forge.db | SQLite |
| GitHub Copilot | VS Code workspaceStorage | JSON |
你不需要关心每个工具把历史存在哪、用的什么格式。CCHV 扫描本地已知路径，解析后归一化成统一的会话模型，跨助手浏览、回放对话就像翻一份连续的聊天记录。
2. 全局搜索
搜索范围覆盖所有助手、所有项目、所有会话。想找某个 bug 当时是怎么修的，不必再一个文件夹一个文件夹地翻，直接搜关键词，Claude Code 和 Cursor 里的相关会话会一起出来，还能顺手对比两个助手给出的不同解法。
3. 分析仪表板
仪表板提供几个维度的统计：每个助手、项目、会话消耗了多少 token；各助手的费用分布；Claude、GPT、Gemini 等提供商之间的用量对比；以及随时间变化的使用趋势。用了它，这个月在 AI 编程上花了多少钱终于有一个确切答案，而不是靠订阅费去估。
4. 桌面 App 与无头服务器双模式
桌面 App 是 Tauri 封装的本地图形界面，装完即用；无头服务器模式则由 cchv-server 提供，可以跑在 VPS 或 Docker 上，默认监听 3727 端口，团队成员用浏览器访问，支持 token 鉴权。服务器模式适合团队：把 AI 编程历史的查看和分析集中到一个服务里，成员不必各自装 App。
三、怎么装
# macOS（Homebrew）
brew install --cask jhlee0409/tap/claude-code-history-viewer
# 无头服务器模式
brew install jhlee0409/tap/cchv-server
cchv-server --serve # 启动后浏览器访问 http://localhost:3727
# Docker
docker-compose up # 使用仓库自带的 docker-compose.yml安装包也可以从项目 GitHub 仓库的 Releases 页面直接下载。需要强调的是，CCHV 是 100% 离线运行的：所有解析和分析都在本地完成，不把对话数据发送到任何服务器，无遥测、无跟踪，隐私敏感的团队可以放心。
四、为什么需要它
痛点一，历史散落。多工具并用已经是常态，但每个工具的历史锁在自己的路径和格式里，无法跨工具搜索，这些本可复用的经验资产一直在磁盘角落里沉睡。
痛点二，成本不透明。Claude 走 Anthropic API，Cursor 是订阅制，Codex 走 OpenAI API，各家账单互不相通。想知道 AI 编程的总开销，此前没有一个工具能给出汇总视图，CCHV 做的正是这件事。
痛点三，回顾困难。直接翻 JSONL 文件体验很差，CCHV 把它们变成聊天记录式的对话界面，回看上周用 Claude Code 做了什么变成一件轻松的事。
从更大的视角看，这类工具补上了 AI 编程工作流里缺的一环：CLAUDE.md、AGENTS.md 这类项目记忆文件沉淀的是约定，CCHV 呈现的是过程。它让每次 AI 协作留下的历史真正可以被检索和复盘，项目记忆与历史记录合在一起，才算完整。
五、谁适合用
以下几类读者建议试试：同时使用两个以上 AI 编程助手，想在统一界面里管理历史的人；需要跨工具搜索以前某个问题怎么解决的人；想统计 AI 编程真实成本、做个人或团队用量核算的人；需要集中查看 AI 编程历史的团队，选服务器模式；还有内容创作者，可以回顾 AI 帮自己做了什么，再整理成文章或报告。
也有几点要注意：本地需要先用过这些助手，才会生成历史文件；无头服务器模式需要自行部署；25 个助手的解析完整度不同，有的能拿到完整对话，有的只有基础信息。
六、小结
一句话总结：CCHV 是 25 个 AI 编程助手历史会话的统一查看器，搜索、分析、成本统计在一个界面完成，100% 离线，MIT 协议开源。如果你曾在多个文件夹之间翻找 AI 对话记录，它值得一装。
项目地址：https://github.com/jhlee0409/claude-code-history-viewer
