Claude 코드 히스토리 뷰어
요약
Claude Code History Viewer는 다양한 AI 코딩 어시스턴트(Gemini CLI, Codex CLI, Cursor 등)와의 대화 내용을 통합적으로 관리하는 데스크톱 앱입니다. 이 도구는 모든 기록을 오프라인으로 검색하고 분석할 수 있게 하여 개발자의 생산성을 높여줍니다.
핵심 포인트
- 다양한 AI 코딩 어시스턴트의 히스토리 통합 뷰어 제공
- Gemini CLI, Codex CLI 등 여러 도구의 대화 내용 관리 가능
- 모든 데이터 처리가 오프라인으로 이루어져 보안성이 높음
Claude Code History Viewer
AI 코딩 어시스턴트의 통합 히스토리 뷰어입니다.
Claude Code, Gemini CLI, Antigravity, Codex CLI, Cline, Cursor, Aider, OpenCode, ForgeCode, CodeBuddy Code, 그리고 Grok CLI에서 진행된 대화 내용을 데스크톱 앱 또는 헤드리스 서버로 찾아보고, 검색하고, 분석할 수 있습니다. 100% 오프라인입니다.
Website · Download · Report Bug
언어: English | 한국어 | 日本語 | 中文 (간체) | 中文 (번체)
</div><p align="center"> <img width="49%" alt="Conversation History" src="https://github.com/user-attachments/assets/9a18304d-3f08-4563-a0e6-dd6e6dfd227e" /> <img width="49%" alt="Analytics Dashboard" src="https://github.com/user-attachments/assets/0f869344-4a7c-4f1f-9de3-701af10fc255" /> </p> <p align="center"> <img width="49%" alt="Token Statistics" src="https://github.com/user-attachments/assets/d30f3709-1afb-4f76-8f06-1033a3cb7f4a" /> <img width="49%" alt="Recent Edits" src="https://github.com/user-attachments/assets/8c9fbff3-55dd-4cfc-a135-ddeb719f3057" /> </p>
빠른 시작 (Quick Start)
데스크톱 앱(Desktop app) — 다운로드하여 실행하세요:
플랫폼별 다운로드 방법
| 플랫폼 | 다운로드 |
|---|---|
| macOS (Universal) | .dmg |
| ... | |
| Homebrew (macOS): |
brew install --cask jhlee0409/tap/claude-code-history-viewer
Headless 서버 — 모든 브라우저에서 접근 가능:
brew install jhlee0409/tap/cchv-server # 또는: curl -fsSL https://raw.githubusercontent.com/jhlee0409/claude-code-history-viewer/main/install-server.sh | sh
cchv-server --serve # → http://localhost:3727
Docker, VPS 및 systemd 설정은 서버 모드를 참조하세요.
모드 선택:
| 모드 | 최적의 사용처 | 기능 |
|---|---|---|
| 데스크톱 앱 | 로컬 브라우징 | 네이티브 앱에서 로컬 대화 파일을 열어줍니다 |
| Headless 서버 | 브라우저, VPS 또는 원격 접근 | WebUI를 통해 로컬 대화 파일을 제공합니다; 인증을 활성화 상태로 유지하세요 |
이 도구가 존재하는 이유
AI 코딩 어시스턴트는 수많은 대화 메시지를 생성하지만, 이 모든 것을 아우르는 히스토리 조회 기능을 제공하는 것은 없습니다. CCHV가 이를 해결합니다.
31개의 어시스턴트. 하나의 뷰어. Claude Code, GitHub Copilot, Gemini CLI, Antigravity, Codex CLI, Cline (Roo Code 포함), Kilo Code, Cursor, Cursor Agent, Aider, OpenCode, ForgeCode, CodeBuddy Code, Grok CLI, Kimi, Kiro, Amazon Q CLI, Continue.dev, PearAI, Goose, Crush, llm, Open Interpreter, Pi, oh-my-pi, Mistral Vibe, Qwen Code, Zed, OpenHands, Trae, Z Code 세션을 끊김 없이 전환하며 토큰 사용량을 비교하고, 제공업체 전반에서 검색하며, 단일 인터페이스에서 워크플로우를 분석할 수 있습니다.
| 제공업체 | 데이터 위치 | 얻을 수 있는 것 |
|---|---|---|
| Claude Code | ~/.claude/projects/ | 전체 대화 기록, 도구 사용, 사고 과정, 비용 |
| ... | ||
| 벤더 종속성 없음. 클라우드 의존성 없음. 로컬 대화 파일이 아름답게 렌더링됩니다. |
Antigravity 참고 사항: 이 뷰어는 Antigravity 루트를 ~/.gemini/antigravity로 해결하고, 세션 상태를 brain/에서 읽은 다음, .token-monitor/rpc-cache/v1/에서 사용 및 캐시 아티팩트를 읽습니다. 이는 src-tauri/src/commands/antigravity.rs의 현재 런타임 레이아웃 및 루트 리졸버와 일치합니다.
목차 (Table of Contents)
기능 (Features)
핵심 (Core)
| 기능 | 설명 |
|---|---|
| 다중 제공업체 지원 (Multi-Provider Support) | 31개 AI 코딩 어시스턴트를 위한 통합 뷰어 — Claude Code, GitHub Copilot, Gemini CLI, Codex CLI, Cursor / Cursor Agent, Cline (Roo Code 포함), Kilo Code, Aider, OpenCode, ForgeCode, CodeBuddy Code, Grok CLI, Kimi, Kiro, Antigravity, Amazon Q CLI, Continue.dev, PearAI, Goose, Crush, llm, Open Interpreter, Pi, oh-my-pi, Mistral Vibe, Qwen Code, Zed, OpenHands, Trae, Z Code 등 — 제공업체별 필터링 및 도구 간 비교 가능 |
| ... |
제공업체 참고 사항 (Provider Notes)
| 제공업체 | 참고 사항 |
|---|---|
| Antigravity | 표준 제공업체 파이프라인을 통해 로드됩니다. 세션은 토큰 모니터 캐시에서 가져오며, 별도의 UI 모드 없이 프로젝트/세션 뷰, 토큰 통계, 분석 및 글로벌 검색에 참여합니다. |
v1.32.0의 새로운 기능 (New in v1.32.0)
| 기능 | 설명 |
|---|---|
| 프롬프트 간 이동 (Jump between prompts) | Alt+↑ / Alt+↓ (macOS에서는 ⌥↑ / ⌥↓) 메시지 목록을 사용자가 입력한 이전 또는 다음 프롬프트로 이동시키며, Messages 패널이 열려 있거나 열려 있지 않아도 작동합니다. |
| ... |
v1.31.0의 새로운 기능 (New in v1.31.0)
| 기능 (Feature) | 설명 (Description) |
|---|---|
| 커스텀 재개 인자 (Custom resume arguments) | Settings → **세션 재개 인자 (Session Resume Arguments)**에서 CLI별 추가 플래그를 설정할 수 있으며, 이는 복사 재개 명령어 (Copy Resume Command) 및 터미널에서 세션을 재개할 때 사용됩니다. 실시간 미리보기가 제공되며, 위험한 플래그는 강조 표시됩니다. |
| 정확한 Claude Opus 5.5 비용 | Opus 5.5 세션은 자체 요율(이전에는 Opus 5의 요율로 청구됨)에 따라 가격이 책정되었습니다. GPT-6, Gemini 3.8 Flash 및 Grok 4.7에 대한 가격 정보가 추가되었습니다. |
v1.30.0에서 새로 추가된 기능 (New in v1.30.0)
| 기능 (Feature) | 설명 (Description) |
|---|---|
| WebUI 보안 강화 | --serve 모드에서 세션 및 프로젝트 경로는 사용자의 히스토리 폴더로 제한되며, 프로젝트 설정은 알려진 프로젝트로 제한됩니다. WebUI를 실행하는 경우 업그레이드를 권장합니다 (advisory) |
| ... |
v1.29.0에서 새로 추가된 기능 (New in v1.29.0)
| 기능 (Feature) | 설명 (Description) |
|---|---|
| Z Code 제공자 | ~/.zcode/cli/db/db.sqlite에서 제목, 도구 호출(tool calls), 사고 과정(thinking), 토큰 사용량과 함께 Z Code (Z.ai) 세션을 탐색할 수 있습니다 — 총 31개의 어시스턴트가 포함됩니다. |
| ... |
v1.28.0에서 새로 추가된 기능 (New in v1.28.0)
| 기능 (Feature) | 설명 (Description) |
|---|---|
| 현재 Cline 세션 | 최근의 Cline 릴리스(포함된 VS Code 확장 프로그램)는 세션을 ~/.cline/data/sessions/에 저장합니다. 이제 제목, 전체 스크립트, 토큰/비용 통계와 함께 표시됩니다. Cline, Roo Code 및 Kilo Code도 Windows에서 검색됩니다. |
| ... |
v1.23.0에서 새로 추가된 기능 (New in v1.23.0)
| 기능 (Feature) | 설명 (Description) |
|---|---|
| Grok CLI 제공자 | ~/.grok/sessions/에서 Grok CLI 세션을 탐색하고, 검색하며, 분석에 모델/토큰 사용량을 포함할 수 있습니다. |
| ... |
v1.18.0에서 새로 추가된 기능 (New in v1.18.0)
| 기능 (Feature) | 설명 (Description) |
|---|---|
| 더 빠른 시작 | 제공자 스캐너가 이제 순차적(sequentially)이 아닌 동시적(concurrently)으로 실행되므로, 뷰어와 함께 실행되는 도구의 잠긴 SQLite 데이터베이스로 인해 전체 스캔이 지연되지 않습니다 — 다중 초에 걸친 |
새로운 기능 (New in v1.16.0)
| 기능 (Feature) | 설명 (Description) |
|---|---|
| GitHub Copilot Provider | Copilot CLI(~/.copilot/session-state), Copilot Desktop, 및 VS Code Copilot Chat(workspaceStorage/.../chatSessions)의 읽기 전용 히스토리 제공 — 글로벌 검색을 지원하는 WSL 인식 기능 포함 |
| ... |
새로운 기능 (New in v1.15.0)
| 기능 (Feature) | 설명 (Description) |
|---|---|
| 세 가지 새 Provider | Cursor Agent (agent-transcripts, Cursor IDE 소스와는 별개), Kimi (~/.kimi, kimi -r로 재개 가능), 및 Kiro (SQLite 기반의 kiro-cli)의 히스토리 제공 |
| ... |
v1.14.0
| 기능 (Feature) | 설명 (Description) |
|---|---|
| CodeBuddy Code Provider | CodeBuddy Code 추가 — 다른 AI 코딩 어시스턴트와 함께 대화 기록을 탐색할 수 있습니다 |
| ... |
v1.13.0
| 기능 (Feature) | 설명 (Description) |
|---|---|
| macOS 사용자 정의 제목 표시줄 | 드래그 가능한 오버레이 헤더가 레거시 macOS 제목 표시줄을 대체하여 일관된 화면 공간 사용성을 제공합니다; Linux/Windows는 영향 없음 |
| ... |
이전 릴리스: v1.12.0 및 그 이전 버전은 CHANGELOG.md를 참조하십시오.
추가 정보 (More)
| 기능 (Feature) | 설명 (Description) |
|---|---|
| 세션 컨텍스트 메뉴 | 세션 ID 복사, 명령어 재개, 파일 경로; 세션 삭제, JSONL 파일 표시; 검색 통합을 통한 네이티브 이름 변경 |
| ... |
설치
Homebrew (macOS)
brew tap jhlee0409/tap
brew install --cask claude-code-history-viewer
또는 전체 cask 경로를 사용하여 직접 설치할 수 있습니다:
brew install --cask jhlee0409/tap/claude-code-history-viewer
만약 No Cask with this name exists라는 메시지가 나타나면, 위에 제시된 전체 cask 경로 명령어를 실행하세요.
업그레이드 방법:
brew upgrade --cask claude-code-history-viewer
제거 방법:
brew uninstall --cask claude-code-history-viewer
수동(.dmg) 설치에서 마이그레이션하는 경우?
충돌을 방지하려면 Finder의 휴지통으로 기존 앱을 이동한 후 Homebrew를 통해 설치하세요.
하나의 설치 방법만 선택하세요. 수동 설치와 Homebrew 설치를 혼용하지 마세요.
그런 다음 실행하세요:
brew tap jhlee0409/tap
brew install --cask claude-code-history-viewer
## 소스 코드 빌드 (Build from Source)
```bash
git clone https://github.com/jhlee0409/claude-code-history-viewer.git
cd claude-code-history-viewer
...
필수 조건: Node.js 20.19+ (또는 22.12+), pnpm, Rust toolchain
서버 모드 (Server Mode) (WebUI)
뷰어를 헤드리스 HTTP 서버로 실행할 수 있습니다. 데스크톱 환경이 필요하지 않습니다. VPS, 원격 서버 또는 Docker에 이상적입니다. 서버 바이너리에는 프런트엔드가 내장되어 있어 단일 파일만 있으면 됩니다.
서버 배포가 처음인가요? 로컬 테스트, VPS 설정, Docker 등 단계별 지침이 포함된 전체 Server Mode Guide (한국어)를 참고하세요.
빠른 설치 (Quick Install)
# Homebrew (macOS / Linux)
brew install jhlee0409/tap/cchv-server
...
두 방법 모두 cchv-server를 PATH에 설치합니다.
서버 시작하기 (Start the Server)
cchv-server --serve
출력:
🔑 인증 토큰: b77f41d4-ec24-4102-8f7a-8a942d6dd4a0
브라우저에서 열기: http://192.168.1.10:3727?token=b77f41d4-ec24-4102-8f7a-8a942d6dd4a0
👁 파일 감시 활성화됨: /home/user/.claude/projects
...
브라우저에서 해당 URL을 열면 토큰이 자동으로 저장됩니다.
사전 빌드 바이너리 (Pre-built Binaries)
플랫폼별로 사용 가능한 에셋과 다운로드 링크를 표로 정리했습니다.
| Platform | Asset |
|---|---|
| Linux x64 | cchv-server-linux-x64.tar.gz |
| ... | |
| Download from Releases. |
CLI 옵션:
| 플래그 (Flag) | 기본값 (Default) | 설명 (Description) |
|---|---|---|
--serve | — | 필수. 데스크톱 앱 대신 HTTP 서버를 시작합니다. |
| ... |
인증 (Authentication)
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기