Claude Codeを使い続けると、~/.claude/projects/ に会話ログ(JSONL)が積み上がる。Claude Code History Viewer(以下CCHV)は、この履歴を横断検索し、トークン消費まで集計できるOSSだ。READMEの現行版はClaude Codeを含む31のAIコーディングアシスタントに対応する。
THE SCALE対応範囲と規模
ローカルに残る会話ログを31ツール分、1つの画面で読む
31ツール
対応するAIコーディング支援
README の対応表(v1.32.2)
2.3k★
GitHub スター
フォーク 253・ライセンス MIT
0件
外部へ送る会話データ
デスクトップ版。分析・テレメトリーなし
30秒でわかるClaude Code History Viewer
- ・ローカルの会話ログを読むビューア。閲覧・全文検索・トークン分析・最近の編集の復元ができる。
- ・開発者はjhlee0409氏。MIT License。最新タグは v1.32.2(2026-10-20)。
- ・形態はデスクトップ(Tauri v2)とブラウザ用サーバー(cchv-server)の2つ。
- ・サーバー版はローカルのファイルを配信する。トークン認証を保ち、v1.32.1以降へ更新して使う。
READMEは現在31ツールを掲げている。以前の版は9ツール前提だったため、対応表と機能を書き直した。Claude Code自体の導入は Claude Code|2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き を参照。
1. Claude Code History Viewerとは何か
CCHVのタグラインは「AIコーディングアシスタントのための統合履歴ビューア」だ。READMEの動機はこう書かれている。
AI coding assistants generate thousands of conversation messages, but none of them provide a way to look back at your history across tools. CCHV solves this.
各ツールは会話ログをホームディレクトリ配下にJSONLやSQLiteで残すが、振り返るUIは別だ。CCHVは保存先を自動で走査し、プロジェクトとセッションの木構造で見せる。主な機能は次のとおり。
・会話ブラウザ:ツール呼び出しと思考(thinking)を含めて表示する
・グローバル検索:全プロバイダーの会話を横断して検索する
・分析ダッシュボード:課金トークンと会話トークンを分けるデュアルモード統計、コスト内訳
・セッションボード:ピクセルビュー、属性ブラッシング、アクティビティタイムライン
・設定マネージャー:Claude Codeの設定とMCPサーバーをスコープ別に編集する
2. 対応する31ツールと claude code history の保存先
保存先はREADMEのProvider表にある。代表的なものを抜き出す。
| ツール | データの場所 | 備考 |
|---|---|---|
| Claude Code | ~/.claude/projects/ |
会話・ツール使用・思考・コスト |
| GitHub Copilot | ~/.copilot/session-state/ ほか |
CLI・Desktop・VS Code Chat。読み取り専用 |
| Gemini CLI | ~/.gemini/history/ |
ツール呼び出しを含む |
| Codex CLI | ~/.codex/sessions/ |
セッションのロールアウト |
| Cline(Roo Code含む) | ~/.cline/data/sessions/ |
旧版は VS Code の globalStorage |
| Cursor / Cursor Agent | ~/.cursor/ |
IDEとエージェントは別ソース |
| OpenCode | ~/.local/share/opencode/ |
セッションとツール結果 |
| Aider | プロジェクトディレクトリ | チャット履歴と編集ログ |
| Kiro / Amazon Q CLI | SQLite(data.sqlite3) |
両者は同じ形式を共有 |
| Goose / Crush / Zed | SQLite | Zed は Zstd 圧縮のJSON |
| Trae | state.vscdb |
実験的(READMEは逆解析と記載) |
残りの約20ツールの保存先もREADMEに載っている。見つからないプロバイダーがあるときは、表のパスを確認し、Claudeの追加ディレクトリは Settings の Custom Claude Directories で足す。Dockerなら、そのツールのディレクトリを読み取り専用ボリュームとして追加する(README Troubleshooting)。
3. 仕組みとインストール:Claude Code History Viewerの2形態
3-1. 仕組み:ローカル完結のログ読み込み
構成はバックエンドがRust + Tauri v2、フロントエンドがReact 19 + TypeScript + Tailwind CSS、状態管理がZustand、ビルドがVite(README Tech Stack)。READMEによると、プロバイダーのスキャンは並行して走る。ロックされたSQLiteがあっても全体が止まらない作りだ。
HOW IT WORKS読み込みから表示まで
ローカルのログを読むだけ。外には出ない
-
各ツールの保存先を走査
~/.claude/projects/ など。SQLite や JSONL
-
Rust 側でパース
プロバイダーごとに独立してスキャン
-
ファイル変更を監視
追記を検知して画面を更新
-
React の画面に表示
会話・分析・トークン統計・最近の編集
プライバシーについて、READMEは「デスクトップ版はローカルファイルを読むだけで、会話データのアップロード、分析、トラッキング、テレメトリーは無い」と書く。一方サーバー版はサーバーに届く相手へ会話ファイルを配信する設計だ。使い分けは次の図で整理する。
3-2. インストール:デスクトップとサーバー
TWO MODES使う形を選ぶ
手元ならデスクトップ、遠隔ならサーバー
デスクトップアプリ
Tauri v2・macOS / Windows / Linux
- ローカルで閲覧ネイティブアプリでファイルを開く
- インストールbrew cask か Releases から
- 認証は不要ネットワークに公開しない
cchv-server
ブラウザからアクセスする WebUI
- VPS・Docker で閲覧バイナリ1つにフロントを内蔵
- Bearer トークン認証起動時に自動生成。--no-auth は非推奨
- 公開前に更新v1.30.0 でパス制限を強化
デスクトップ版は、macOSならHomebrewが最短(README Quick Start)。
brew install --cask jhlee0409/tap/claude-code-history-viewer
Windows(.exe / ポータブル .zip)とLinux(.AppImage)はReleasesから入れる。VPSやリモートの履歴をブラウザで見たいときは、サーバー版を使う。
brew install jhlee0409/tap/cchv-server
cchv-server --serve # → http://localhost:3727
起動すると認証トークン付きのURLが出る。主なフラグは --port(既定 3727)、--host(既定 0.0.0.0、ローカルのみなら 127.0.0.1)、--token、--no-auth(公開ネットワークでは非推奨)だ。トークンは CCHV_TOKEN 環境変数でも渡せる。バイナリはLinux x64/ARM64とmacOS ARM/x64向けに配布されている。Docker(docker-compose)とsystemd(contrib/cchv.service)のテンプレートもリポジトリにある。
サーバー版は本記事では起動確認をしていない。上の手順と挙動はREADMEの記述に基づく。
4. Claude Code History Viewerの使い方:検索・トークン分析・再開
アプリを起動すると、全プロバイダーのデータを自動で走査する。左サイドバーでプロジェクトを選び、タブバーでプロバイダー別に絞る。画面上部のタブで、メッセージ、分析、トークン統計、最近の編集、セッションボードを切り替える。
検索。 グローバル検索で全プロバイダーを横断できる。v1.32.0 では Alt+↑ / Alt+↓(macOSは ⌥↑ / ⌥↓)で前後の自分のプロンプトへ飛べる。v1.30.0 の「Show my prompts only」フィルターは、自分の入力だけに絞る。
トークン分析。 課金トークンと会話トークンを分けて集計する。v1.31.0 では Claude Opus 5.5 を Opus 5.5 の料金で計算するよう直し、GPT-6、Gemini 3.8 Flash、Grok 4.7 の料金も足している。モデルが増えるたびに料金表の追従が要る領域なので、金額は目安として読むのが安全だ。
最近の編集。 AIが変更したファイルの履歴を見て、復元できる。復元の確認画面は変更内容を先に見せ(v1.32.0でWebUIにも対応)、シンボリックリンクの対象は拒否する。v1.32.2 以降は、記録された全ファイル版だけを書き戻す。パッチや部分変更として記録された編集(Codex、OpenCode、Kilo など)は、復元ボタンが無効になる。
セッション再開と起動指定。 右クリックで resume コマンドをコピーしてターミナルで実行する。特定のセッションを開いて起動するには --session を使う。
claude-code-history-viewer --session 1265cd74
完全なUUID、8文字以上のUUID接頭辞、.jsonl の絶対パスを受け付ける。--session-folder(フォルダ名)と --session-title(タイトルの部分一致)もある(README Usage)。
5. 他の手段との比較:claude code log viewer と session viewer
Claude Codeの履歴を見る手段はほかにもある。CCHVの位置づけを整理する。
| 手段 | 横断性 | トークン分析 | 向く場面 |
|---|---|---|---|
| CCHV | 31ツール横断 | 課金/会話の2系統 | 履歴の検索・振り返り・コスト確認 |
JSONLを grep / jq |
手作業・単一ツール | 自前で集計 | 条件が決まった一発の抽出 |
| 各ツール内蔵の履歴 | そのツール内のみ | 限定的 | 直近のセッション再開 |
READMEにあるとおり、CCHVは読み取りが主の閲覧・分析ツールで、会話を生成するものではない。ただし「最近の編集」の復元はファイルを書き戻す操作を含む。他の類似ビューアとの機能比較は本記事では実測していない。
6. 実務での使いどころと注意点
使いどころは3つある。
・振り返り:過去の設計判断を、思考の記録ごと全文検索で引く
・デバッグ:エージェントがどのツールをどの引数で呼んだかを追い、最近の編集で変更を確かめる
・引き継ぎ:サーバー版でトークン統計とセッション履歴をチームで見る
注意点は次の3つだ。
サーバー版を使う前に
- ・v1.30.0 で、
--serveモードのパスを履歴フォルダ内に制限した(アドバイザリ GHSA-j5r9-j75x-wprj)。v1.32.1 では、履歴フォルダ内のシンボリックリンク経由でファイルを読まないよう追加で直している。CHANGELOGは、WebUIを動かす人は更新するよう案内している。 - ・
--no-authは信頼できるネットワークだけで使う。公開するならトークン認証を残す。 - ・大きな履歴は初回の読み込みが遅いことがある(README Troubleshooting)。
「No Claude data found」と出たら、~/.claude に会話履歴があるかを確認する。HTTP 401 は起動時に出たトークン付きURLか Authorization: Bearer <token> で解消する。
7. まとめ:ログを検索できる資産にする
CCHVはツールごとに散らばるローカルの会話ログを、検索・集計・復元できる形にするビューアだ。デスクトップ版はローカルで完結し、サーバー版は認証と更新を前提に使う。
・31ツールの履歴を1画面で横断検索できる
・課金と会話の2系統でトークンとコストを見られる
・MIT License。個人・商用とも無料
まずは ~/.claude/projects/ がある環境で、デスクトップ版を入れて自分の履歴を開くところから試すとよい。トークンの削減策は Claude Codeトークン最適化ツール比較2026 が、ログの出どころとなるClaude Code本体は Claude Codeとは?Anthropic公式AIコーディングツールの使い方・インストール・料金【2026年版】 が続きになる。
参照ソース
・jhlee0409/claude-code-history-viewer(GitHub) — README・LICENSE・CHANGELOG。v1.32.2(2026-10-20)を2026-11-08に確認
・Releases(デスクトップ版・cchv-serverバイナリ)
・Claude Code History Viewer 公式サイト





