誰も警告しない Claude Code の歴史問題
Claude Code を実行すると、すべてのセッションがローカル ファイル システム上の JSONL ファイルに書き込まれます。一般的な開発者は蓄積します 数十から数百のこれらのファイル 通常の使用から数か月以内。
これらのファイルの 1 つは実際には次のようになります。
{"type":"user","message":{"role":"user","content":"JWT を使用するように認証モジュールをリファクタリングする"},"timestamp":"2026-01-14T09:22:11Z"}
{"type":"assistant","message":{"role":"assistant","content":"リファクタリングされた認証モジュールは次のとおりです..."},"usage":{"input_tokens":412,"output_tokens":1840}}
{"type":"user","message":{"role":"user","content":"リフレッシュ トークンのサポートを追加します"},"timestamp":"2026-01-14T09:31:05Z"}
各行は JSON オブジェクトです。オブジェクト内で改行はありません。インデックスはありません。検索はありません。 3 週間前に行われた特定の決定を見つけるには、2026-01-14_session_a3f9c.jsonl のような名前のファイルに対して grep を実行します (おおよその日付さえ覚えていれば)。
本当のコストはファイル形式ではなく、コンテキストの喪失です。
アーキテクチャ上の決定、デバッグのブレークスルー、作成に 20 分かかった慎重に作成されたプロンプトは、セッションが終了すると事実上すべて見えなくなります。ビューアは、この生データを、AI 支援の作業に関する検索および閲覧可能なナレッジ ベースに変換します。
2026 年のすべての Claude Code 履歴ビューアー — 比較
異なる設置面に 5 つの異なるツールが存在します。全体の風景は次のとおりです。
| 道具 | タイプ | OSサポート | インストール方法 | 検索 | トークン分析 | オフライン |
|---|---|---|---|---|---|---|
| CCHV (jhlee0409) | Desktop App | macOS ✓, Windows ⚠️, Linux ⚠️ | GitHub Releases | ✓ Full-text | ✓ Dashboard | ✓ |
| クロードコードビューア | Web UI | macOS, Windows, Linux | ピップインストール | ✓ | Limited | ✓ |
| Claude History Viewer (agsoft) | VS Code Extension | macOS, Windows, Linux | VS Code Marketplace | ✓ | ✓ Cost tracking | ✓ |
| Claude Code CLI (built-in) | Built-in CLI | macOS, Windows, Linux | None (built-in) | Limited | None | ✓ |
| claude-history CLI | CLI Tool | macOS, Linux | npm/ピップ | ✓ | None | ✓ |
Windows/Linux note: CCHV のデスクトップ アプリは主に macOS 上で開発およびテストされています。 Windows と Linux ユーザーには機能的な代替手段があり、VS Code 拡張機能と PyPI パッケージは両方とも完全なクロスプラットフォーム サポートを提供します。
CCHV — 最優秀統合デスクトップ アプリ
「Claude Code、Gemini CLI、Cline、Cursor などを 1 つのインターフェイスで処理する 1 つのツールです。」
jhlee0409 の CCHV は、最も機能が充実したスタンドアロン ビューアです。 2026 年のアップデートでは、競合他社がカバーしていないマルチエージェント サポートが追加されました。単一の CCHV インストールで、履歴のインデックスが作成されるようになりました。 Claude Code、Gemini CLI、Codex CLI、Cline、Cursor、Aider、OpenCode 同時に。
これにより、2026 年に成長するセグメントである AI コーディング アシスタントを切り替える開発者にとって、事実上の歴史のハブとなります。
長所
- マルチエージェントのサポート: 7 つ以上の AI ツールにわたる統合ビュー
- 日付、プロジェクト、エージェントによるセッションフィルタリングによる全文検索
- コスト見積もりを含むトークン使用状況分析ダッシュボード
- 完全にオフライン — テレメトリやクラウド同期はありません
- チームおよびCI用のヘッドレスサーバーモード
短所
- デスクトップ アプリは macOS プライマリです。 Windows/Linux サポートは機能しますが、主要なターゲットではありません
- JSONL ディレクトリを見つけるには手動のパス構成が必要です
- CLI の代替手段よりもインストールのフットプリントが重い
以下に最適: Claude Code に多額の投資を行っている Solo の開発者とチームは、分析機能を備えた専用の永続的な履歴ブラウザーを望んでいます。
クロードコードビューア (PyPI) — Python を初めて使用する開発者に最適
「pip install and go — Electron も GUI 依存関係もありません。」
Python 環境に住んでいて、60 秒以内に何かを実行したい場合は、claude-code-viewer がパスです。構文が強調表示された会話レンダリングとプロジェクト レベルの編成を備えたローカル Web インターフェイスを起動します。
長所
- 摩擦ゼロのクロスプラットフォーム (macOS, Windows, Linux)
- 会話内のコードブロックの構文ハイライト
- プロジェクトディレクトリごとにセッションを自動的に整理します
- 重いランタイムは不要 — Python 3.8 以降を使用するあらゆる環境で実行可能
短所
- CCHV と比較してトークン分析が制限されている
- Web UI は機能的ですが、デスクトップ アプリほど洗練されていません
- 2026 年半ば現在、マルチエージェントのサポートはありません
以下に最適: Python 開発者、迅速なビジュアル インターフェイスを必要とする Linux/Windows ユーザー、およびデスクトップ アプリよりも軽量の Web サーバーが望ましい CI 環境。
Claude 履歴ビューア と コード拡張 — IDE 統合ワークフローに最適
「Claude Code の履歴全体を、コマンド パレットのショートカット 1 つでアクセスできます。」
agsoft VS Code 拡張機能は、会話履歴をエディタに直接取り込みます。コンテキストの切り替えや、別のアプリを管理する必要はありません。既存の VS Code ワークフローと統合されており、IDE を離れることなく、過去のセッションからのファイル diff を開いて、トークン コストを確認し、コンテキストを再開します。
長所
- ワークフローの中断ゼロ – VS Code 内で履歴にアクセス可能
- ファイル差分ビュー: 各セッションでどのようなコードが生成されたかを正確に確認します
- セッションごとおよびプロジェクトごとのコスト追跡
- VS Code がサポートするすべてのプラットフォームで動作します
短所
- VS Code に依存します — Vim、JetBrains、またはターミナルのみのセットアップには役に立ちません
- 検索機能は強力ですが、CCHV の全文エンジンほど強力ではありません
- マルチエージェントのサポートなし
以下に最適: 主要なワークスペースが VS Code である開発者、特に生成されたコードと現在のファイルを相互参照したいと考えている開発者。
組み込みの Claude Code CLI コマンド - インストールは不要
「すでにあります。セットアップは必要ありません。Limited ですが、驚くほど便利です。」
サードパーティ ツールを使用する前に、Claude Code に付属しているものを確認してください。
claude --continue— 最新のセッションを再開しますclaude --resume— 最近のセッションから対話的に選択するように求められます/history— 現在のセッション内のメッセージをリストします。--session-nameを使用したセッションの名前付けにより、検索が容易になります
これは、中断したところから再開するという最も一般的なニーズをカバーします。セッションや分析を横断して検索することはできませんが、1 時間前にターミナルを閉じたばかりの開発者にとっては、最も早く元に戻る方法です。
長所
- すでにインストールされています - 追加の依存関係はありません
- クロスプラットフォーム
- 最新のセッションへの即時アクセス
短所
- セッションをまたいだ検索はありません
- トークン分析なし
- 数週間または数か月前のセッションには役に立たない
以下に最適: セッションは同日に迅速に再開できます。実際のビューアの代わりにはなりません。
セットアップに適したビューアを選択する方法
- On Windows or Linux? CCHV のデスクトップ アプリを主要なツールとして使用しないでください。クロスプラットフォームで保証されたエクスペリエンスを得るには、VS Code 拡張機能 (VS Code を使用している場合) または PyPI パッケージを使用します。
- Use multiple AI coding assistants? CCHV は、マルチエージェント インデックス作成を備えた唯一のツールです。 Claude Code を Cursor、Cline、または Gemini CLI と混合する場合、それが明確な選択です。
- Need it inside your editor? VS コードの拡張機能。コンテストはありません。
- Prefer the command line or Python-native setup? pip 経由の
claude-code-viewerは、最も抵抗の少ないパスです。 - On a team that needs shared access? CCHV ヘッドレス サーバー モード。
決定の概要:
Windows/Linux ユーザーですか?
§── VS Code ユーザー → VS Code Extension
└── VS Code ではない → クロードコードビューア (PyPI)
macOSユーザーですか？
§── マルチエージェントワークフロー → CCHV Desktop
§── VS コード中心 → VS Code Extension
└── 軽量/高速 → クロードコードビューアまたは CLI 組み込み
共有アクセスが必要なチーム → CCHV Headless Server
ステップバイステップ: 5 分以内に CCHV を実行できるようにする
macOS (プライマリ パス)
- CCHV GitHub リリース ページに移動します。
- 最新の
.dmgファイルをダウンロードします .dmgを開き、CCHV をアプリケーションにドラッグします- 初回実行時に CCHV — を起動すると、Claude Code 履歴ディレクトリの入力を求めるプロンプトが表示されます。
- デフォルトのパス:
~/.claude/projects/— プロンプトが表示されたらこれを貼り付けます - CCHV はセッションにインデックスを付けます。 100 を超えるセッションの最初のロードには約 10 秒かかります
- 検索バーを使用して、キーワード、日付範囲、プロジェクトごとにすべてのセッションをクエリします。
Windows / Linux
デスクトップ アプリには Windows および Linux 用のコミュニティ ビルドがありますが、安定性は異なります。推奨されるパス:
# オプション A: VS Code Extension
VS Codeを開く→拡張機能→agsoftで「Claude History Viewer」を検索→インストール
# オプション B: PyPI パッケージ
pip インストール クロード コード ビューア
クロードコードビューア --パス "C:\Users\YourName\.claude\projects"
# http://localhost:7777 でブラウザを開きます
Advanced: チーム向けのヘッドレス サーバー モード
CCHV のヘッドレス モードは、エコシステム内で最も活用されていない機能です。このモードは、GUI を使用せずに CCHV をローカル Web サーバーとして実行し、同じネットワーク上のどのマシンでも履歴にアクセスできるようにします。次の場合に最適です。
- Team leads AI が生成したコードの決定をプロジェクト全体で監査する
- DevOps engineers セッション履歴レビューを CI パイプラインに統合する
- Remote developers ディスプレイアクセスのない Linux サーバー上
# ヘッドレスモードでCCHVを起動する
cchv-server --port 4000 --history-path /home/user/.claude/projects
# ネットワーク上の任意のブラウザからアクセス
http://[サーバーIP]:4000
プロジェクト ディレクトリごとにアクセスの範囲を設定できるため、すべてのセッションを共有せずに、特定のプロジェクトの履歴のみを公開することが実用的になります。リバース プロキシ (nginx) を介した基本認証と組み合わせると、これは正当なチーム ナレッジ ツールになります。
JSONL ファイルの実際の外観 (およびビューアが必要な理由)
Claude Code はセッションを次の場所に保存します。
- macOS/Linux:
~/.claude/projects/<project-hash>/ - Windows:
%APPDATA%\Claude\projects\<project-hash>\
各セッションは .jsonl ファイル (JSON Lines 形式) です。すべての行は個別の JSON オブジェクトであり、メッセージ ターン、ツール呼び出し、またはシステム イベントごとに 1 つずつ存在します。
30 回の往復交換を伴うセッションでは、60 ～ 120 行のファイルが生成され、各行にはロール、コンテンツ、タイムスタンプ、ツールの入出力、トークン数を含むネストされた JSON が含まれます。 50 セッションでは、数十のファイルにわたる 3,000 ～ 6,000 行のフォーマットされていない JSON を管理することになります。
grep はキーワードを検索できます。会話フロー、コードの差分、トークンコストの概要を表示することはできません。ビューアは、この機械可読形式を人間が操作できる形式に変換します。
現実世界のシナリオ: 失われたリファクタリング決定の回復
中規模の SaaS チームの開発者は、Claude Code セッションで 45 分を費やして、データベース移行戦略 (正規化のトレードオフ、インデックスの選択、作業) を検討しました。 3 週間後、新しいチーム メンバーが、スキーマがなぜそのようになっているかを尋ねました。
ビューアなしで
この決定は開発者の記憶の中にのみ存在します。彼らが他のプロジェクトに移った場合、その理由は事実上失われます。
CCHVあり
検索バーを開き、「migration」と入力し、プロジェクト フォルダー /api/db でフィルターします。セッションは 5 秒以内に表示され、推論チェーン全体が読み取り可能、共有可能、リンク可能です。
これは、Claude Code をコーディングアシスタントからアシスタントに変えるユースケースです。 監査可能な意思決定ログ.
EasyClaw が AI 支援開発チームに選ばれる理由
EasyClaw は、AI 作業を監査可能、検索可能、再現可能にする必要があるコンテンツ チームと開発チーム向けに構築された唯一のデスクトップ ネイティブ AI エージェント プラットフォームです。クラウド ロックインやシートごとの SaaS 料金設定は必要ありません。
- すべてのセッションはローカルに保存されます - データがマシンから離れることはありません
- すべてのエージェントにわたる全文検索を備えた組み込みのセッション履歴ビューア
- Claude、GPT-4、Gemini、およびオープンソース モデルとのネイティブ統合
- ヘッドレスサーバーモード経由でチーム履歴を共有 - サードパーティの同期は不要
- 統合されたダッシュボードですべてのセッションとプロジェクトにわたるトークンコストを追跡
最終評決 — 2026 年にどの Claude Code 履歴ビューアを使用すべきか
| セグメント | 推奨ツール | なぜ |
|---|---|---|
| macOS, solo developer | CCHV Desktop | 最高の検索、分析、マルチエージェントのサポート |
| Windows / Linux developer | VS Code Extension or PyPI package | Cross-platform, reliable |
| VS Code power user | Claude History Viewer (agsoft) | IDE integration, cost tracking |
| マルチエージェントユーザー (Cursor/Cline/Gemini) | CCHV Desktop | Only tool with unified indexing |
| Team with shared history needs | CCHV Headless Server | Network-accessible, project-scoped |
| Quickstart, no install | Claude Code built-in CLI | --resume ですぐにそこにアクセスできます |
よくある質問
質問: Claude Code はセッション履歴ファイルをどこに保存しますか?
A: macOS と Linux では、セッションは ~/.claude/projects/<project-hash>/ に保存されます。 Windows では、%APPDATA%\Claude\projects\<project-hash>\ にあります。各セッションは .jsonl ファイルです。
質問: CCHV は安全に使用できますか? セッション データはどこにでも送信されますか?
A: CCHV は完全にオフラインです。ローカルの JSONL ファイルを直接読み取り、外部サーバーにデータを送信しません。テレメトリやクラウド同期コンポーネントはありません。セッションはマシン上に残ります。
質問: すべての Claude Code セッションを一度に検索できますか?
A: はい — CCHV と VS Code 拡張機能はどちらもクロスセッションの全文検索をサポートしています。組み込み Claude Code CLI は、単一セッション (/history) または最近のセッション再開 (--resume) 内のナビゲーションのみをサポートし、アーカイブ全体にわたる検索はサポートしません。
質問: CCHV は Claude Code 以外のツールでも動作しますか?
A: はい。2026 年の時点で、CCHV は Claude Code、Gemini CLI、Codex CLI、Cline、Cursor、Aider、OpenCode にわたる統合インデックス作成をサポートしています。このマルチエージェントのサポートは CCHV に固有のものです。このまとめの他のビューアは、1 つのインターフェイスで複数の AI ツールをカバーしていません。
質問: Windows 用の最適な Claude Code 履歴ビューアは何ですか?
A: VS Code 拡張機能 (agsoft の Claude History Viewer) は、Windows ユーザーにとって最も信頼できるオプションです。VS Code Marketplace から 30 秒以内にインストールできます。 VS Code を使用していない場合は、PyPI パッケージ (pip install claude-code-viewer) が最適なクロスプラットフォームの代替品です。
質問: CCHV ヘッドレス サーバー モードはチームに対してどのように機能しますか?
A: cchv-server --port 4000 --history-path /path/to/sessions を実行すると、同じネットワーク上のどのブラウザでもアクセスできるローカル Web サーバー (GUI なし) が起動します。単一のプロジェクト ディレクトリにスコープを設定し、CI またはコード レビュー ワークフローでチームで使用するために、nginx リバース プロキシ経由で基本認証を追加できます。
質問: これらのビューアにはセッションごとのトークンコストが表示されますか?
A: CCHV は、すべてのセッションにわたるコスト見積もりを含むトークン分析ダッシュボードを提供します。 VS Code 拡張機能 (agsoft) は、セッションごとおよびプロジェクトごとのコストも追跡します。 PyPI パッケージと組み込み CLI はコスト分析を提供しません。
最終的な考え
過去の AI での会話は資産です。問題は、デフォルトの Claude Code エクスペリエンスがそれらを一時ディレクトリのように扱うことです。一時ディレクトリとして扱われますが、その後は事実上アクセスできなくなります。
このガイドで説明するツールは、その問題を解決します。すべてのアーキテクチャ上の決定を検索可能なアーカイブにしたい個人開発者であっても、コードベース全体にわたる AI 支援作業の監査可能な記録を必要とするチーム リーダーであっても、セットアップ時間を数分で測定できるビューアがあります。
迅速な行動計画:
- 履歴を一度も確認したことがない場合は、今すぐ
claude --resumeを実行して、Claude Code が既に保存したものを確認してください。 - macOS を使用していて、Claude Code で本格的な作業を行っている場合: CCHV — をインストールしてください。マルチエージェントのサポートだけでも、2026 年には価値があります。
- Windows/Linux を使用している場合: 今すぐ VS Code 拡張機能をインストールしてください。 30秒かかります
- AI 支援開発を使用するチームをリードしている場合: CCHV ヘッドレス サーバー モードを評価してください。誰かが「なぜこの方法で構築したの?」と初めて尋ねられたとき、未来の自分はあなたに感謝するでしょう。
AI セッション履歴を実際の知識資産のように扱うためのツールが存在します。唯一の問題は、どれがあなたのワークフローに合うかということです。