Claude Code 역사 문제 아무도 경고하지 않습니다
Claude Code이 실행되면 모든 세션을 로컬 파일 시스템의 JSONL 파일에 기록합니다. 일반적인 개발자는 축적한다. 수십에서 수백 개의 파일 정기적으로 사용한 후 몇 달 이내에.
해당 파일 중 하나가 실제로 보이는 모습은 다음과 같습니다.
{"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 지원 작업에 대한 검색 및 탐색 가능한 지식 기반으로 변환합니다.
Every Claude Code History Viewer in 2026 — 비교
다양한 설치 표면에 걸쳐 다섯 가지 도구가 존재합니다. 전체 풍경은 다음과 같습니다.
| 도구 | 유형 | OS 지원 | 설치 방법 | 찾다 | 토큰 분석 | 오프라인 |
|---|---|---|---|---|---|---|
| CCHV (jhlee0409) | Desktop App | macOS ✓, Windows ⚠️, Linux ⚠️ | GitHub Releases | ✓ Full-text | ✓ Dashboard | ✓ |
| Claude Code 뷰어 | 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 — 최고의 통합 Desktop App
"Claude Code, Gemini CLI, Cline, Cursor 등을 하나의 인터페이스에서 처리하는 단일 도구입니다."
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에 많은 투자를 했습니다.
claude-code-viewer (PyPI) — Python을 처음 사용하는 개발자에게 가장 적합
"pip 설치 및 이동 — Electron 없음, GUI 종속성 없음."
Python 환경에 거주하고 60초 이내에 무언가를 실행하려면 claude-code-viewer이 경로입니다. 구문 강조 대화 렌더링 및 프로젝트 수준 구성을 통해 로컬 웹 인터페이스를 가동합니다.
장점
- 마찰이 없는 크로스 플랫폼(macOS, Windows, Linux)
- 대화의 코드 블록에 대한 구문 강조
- 프로젝트 디렉터리별로 세션을 자동으로 구성합니다.
- 과도한 런타임 없음 - Python 3.8+를 사용하는 모든 환경에서 실행됩니다.
단점
- CCHV에 비해 토큰 분석이 제한적입니다.
- Web UI은 기능적이지만 데스크탑 앱보다 덜 세련되었습니다.
- 2026년 중반부터 다중 에이전트 지원 없음
가장 적합한 대상: Python 개발자, 빠른 시각적 인터페이스를 원하는 Linux/Windows 사용자, 데스크톱 앱보다 경량 웹 서버가 선호되는 CI 환경입니다.
Claude History Viewer VS Code Extension — IDE 통합 워크플로에 가장 적합
"전체 Claude Code 기록을 하나의 명령 팔레트로 바로가기할 수 있습니다."
agsoft VS Code 확장은 대화 기록을 편집기로 직접 가져옵니다. 컨텍스트 전환이 없고 관리할 별도의 앱이 없습니다. 기존 VS Code 워크플로와 통합됩니다. 이전 세션의 파일 차이점을 열고, 토큰 비용을 확인하고, IDE를 떠나지 않고도 컨텍스트를 다시 시작할 수 있습니다.
장점
- 워크플로 중단 없음 — VS Code 내에서 기록에 액세스할 수 있음
- 파일 비교 보기: 각 세션에서 생성된 코드를 정확히 확인하세요.
- 세션별 및 프로젝트별 비용 추적
- VS Code가 지원하는 모든 플랫폼에서 작동
단점
- VS Code에 따라 다름 - Vim, JetBrains 또는 터미널 전용 설정에는 유용하지 않음
- 검색 기능은 견고하지만 CCHV의 전체 텍스트 엔진보다 강력하지 않습니다.
- 다중 에이전트 지원 없음
가장 적합한 대상: 기본 작업 영역이 VS Code인 개발자, 특히 생성된 코드를 현재 파일과 상호 참조하려는 개발자.
Built-in Claude Code CLI Commands — 설치가 필요하지 않습니다.
"이미 있습니다. 설정이 없습니다. Limited이지만 놀라울 정도로 유용합니다."
타사 도구를 사용하기 전에 Claude Code이 무엇과 함께 제공되는지 확인하세요.
claude --continue— 가장 최근 세션을 재개합니다.claude --resume— 최근 세션에서 대화형으로 선택하라는 메시지를 표시합니다./history— 현재 세션의 메시지를 나열합니다.- 더 쉬운 검색을 위해
--session-name을 통한 세션 이름 지정
이는 가장 일반적인 요구사항, 즉 중단한 부분부터 다시 시작하는 것을 다룹니다. 세션이나 분석 전체에 대한 검색을 제공하지는 않지만, 한 시간 전에 터미널을 막 닫은 개발자에게는 다시 돌아가는 가장 빠른 경로입니다.
장점
- 이미 설치됨 — 추가 종속성 없음
- 크로스 플랫폼
- 가장 최근 세션에 즉시 액세스
단점
- 세션 간 검색 없음
- 토큰 분석 없음
- 몇 주 또는 몇 달 전의 세션에는 쓸모가 없습니다.
가장 적합한 대상: 빠른 당일 세션 재개. 실제 시청자를 대신할 수 없습니다.
귀하의 설정에 적합한 뷰어를 선택하는 방법
- 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 아님 → claude-code-viewer (PyPI)
macOS 사용자이신가요?
├── 다중 에이전트 워크플로우 → CCHV Desktop
├── VS Code 중심 → VS Code Extension
└── 경량/빠름 → clude-code-viewer 또는 CLI 내장
공유 액세스가 필요한 팀 → CCHV Headless Server
Step-by-Step: 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 설치 Claude Code 뷰어
Claude-코드-뷰어 --path "C:\Users\YourName\.claude\projects"
# http://localhost:7777에서 브라우저를 엽니다.
Advanced: 팀을 위한 헤드리스 서버 모드
CCHV의 헤드리스 모드는 생태계에서 가장 활용도가 낮은 기능입니다. 이 모드는 GUI 없이 CCHV를 로컬 웹 서버로 실행하여 동일한 네트워크에 있는 모든 컴퓨터에서 기록에 액세스할 수 있도록 합니다. 다음과 같은 경우에 이상적입니다.
- Team leads 프로젝트 전체에서 AI 생성 코드 결정 감사
- DevOps engineers 세션 기록 검토를 CI 파이프라인에 통합
- Remote developers 디스플레이 액세스 권한이 없는 Linux 서버
# 헤드리스 모드에서 CCHV를 시작합니다.
cchv-서버 --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 개체입니다.
30번의 왕복 교환이 포함된 세션은 60~120줄의 파일을 생성하며 각 줄에는 역할, 콘텐츠, 타임스탬프, 도구 입력/출력 및 토큰 수를 포함하여 중첩된 JSON이 포함되어 있습니다. 50개 세션에서 수십 개의 파일에 걸쳐 3,000~6,000줄의 형식화되지 않은 JSON을 관리하고 있습니다.
grep은(는) 키워드를 찾을 수 있습니다. 대화 흐름, 코드 차이 또는 토큰 비용 요약은 표시할 수 없습니다. 뷰어는 기계가 읽을 수 있는 형식을 인간이 작업할 수 있는 형식으로 변환합니다.
Real-World Scenario: 손실된 리팩터링 결정 복구
중간 규모 SaaS 팀의 개발자는 Claude Code 세션에서 정규화 절충, 인덱스 선택, 작업 등 데이터베이스 마이그레이션 전략을 통해 45분을 보냈습니다. 3주 후, 새로운 팀원이 스키마가 왜 그렇게 보이는지 묻습니다.
뷰어 없이
결정은 개발자의 기억에만 존재합니다. 다른 프로젝트로 넘어간 경우 추론은 사실상 사라집니다.
CCHV와 함께
검색 창을 열고 "migration"을 입력하고 프로젝트 폴더 /api/db로 필터링합니다. 세션은 5초 이내에 표시됩니다. 전체 추론 체인을 읽고, 공유하고, 연결할 수 있습니다.
이는 Claude Code을 코딩 보조자에서 감사 가능한 결정 로그.
EasyClaw이 AI 지원 개발 팀에서 승리한 이유
EasyClaw은 클라우드 종속이나 좌석당 SaaS 가격 책정 없이 AI 작업을 감사, 검색 및 재현할 수 있어야 하는 콘텐츠 및 개발 팀을 위해 구축된 유일한 데스크톱 기반 AI 에이전트 플랫폼입니다.
- 모든 세션은 로컬에 저장됩니다. 데이터가 컴퓨터 외부로 유출되지 않습니다.
- 모든 에이전트에 대한 전체 텍스트 검색이 가능한 내장 세션 기록 뷰어
- 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을 사용하면 즉시 완료됩니다. |
FAQ
Q: Claude Code은 내 세션 기록 파일을 어디에 저장합니까?
A: macOS 및 Linux에서 세션은 ~/.claude/projects/<project-hash>/에 저장됩니다. Windows에서는 %APPDATA%\Claude\projects\<project-hash>\에 있습니다. 각 세션은 .jsonl 파일입니다.
Q: CCHV를 사용해도 안전한가요? 세션 데이터를 어디로든 보낼 수 있나요?
A: CCHV는 완전히 오프라인 상태입니다. 로컬 JSONL 파일을 직접 읽고 외부 서버로 데이터를 전송하지 않습니다. 원격 분석이나 클라우드 동기화 구성 요소가 없습니다. 세션은 컴퓨터에 유지됩니다.
Q: 내 모든 Claude Code 세션을 한 번에 검색할 수 있나요?
A: 예. CCHV와 VS Code 확장은 모두 세션 간 전체 텍스트 검색을 지원합니다. 내장된 Claude Code CLI는 단일 세션(/history) 또는 최근 세션 재개(--resume) 내 탐색만 지원하며 전체 아카이브에 대한 검색은 지원하지 않습니다.
Q: CCHV는 Claude Code 이외의 도구와도 작동합니까?
A: 예. 2026년부터 CCHV는 Claude Code, Gemini CLI, Codex CLI, Cline, Cursor, Aider 및 OpenCode 전반에 걸쳐 통합 인덱싱을 지원합니다. 이 다중 에이전트 지원은 CCHV에만 적용됩니다. 이 요약의 다른 뷰어는 하나의 인터페이스에서 여러 AI 도구를 다루지 않습니다.
Q: Windows용 최고의 Claude Code 기록 뷰어는 무엇입니까?
A: VS Code 확장(agsoft의 Claude History Viewer)은 Windows 사용자에게 가장 안정적인 옵션입니다. 30초 이내에 VS Code Marketplace에서 설치하세요. VS Code를 사용하지 않는 경우 PyPI 패키지(pip install claude-code-viewer)가 최고의 크로스 플랫폼 대안입니다.
Q: CCHV 헤드리스 서버 모드는 팀에서 어떻게 작동합니까?
A: cchv-server --port 4000 --history-path /path/to/sessions을 실행하면 동일한 네트워크에 있는 모든 브라우저가 액세스할 수 있는 로컬 웹 서버(GUI 없음)가 시작됩니다. 단일 프로젝트 디렉터리로 범위를 지정하고 CI 또는 코드 검토 워크플로에서 팀이 사용할 수 있도록 nginx 역방향 프록시를 통해 기본 인증을 추가할 수 있습니다.
Q: 이러한 시청자 중 세션당 토큰 비용이 표시되는 사람이 있습니까?
답변: CCHV는 모든 세션에 대한 비용 추정이 포함된 토큰 분석 대시보드를 제공합니다. VS Code 확장(agsoft)은 세션당 및 프로젝트당 비용도 추적합니다. PyPI 패키지와 내장 CLI는 비용 분석을 제공하지 않습니다.
최종 생각
과거 AI 대화는 자산입니다. 문제는 기본 Claude Code 환경이 이를 임시 디렉토리처럼 취급한다는 것입니다. 즉, 현재는 존재하지만 이후에는 실질적으로 액세스할 수 없습니다.
이 가이드에서 다루는 도구를 사용하면 이러한 문제가 해결됩니다. 모든 아키텍처 결정에 대한 검색 가능한 아카이브를 원하는 1인 개발자이든, 코드베이스 전반에 걸쳐 AI 지원 작업에 대한 감사 가능한 기록이 필요한 팀 리더이든 관계없이 설정 시간이 분 단위로 측정되는 뷰어가 있습니다.
빠른 실행 계획:
- 기록을 본 적이 없다면 지금 바로
claude --resume을 실행하여 Claude Code이 이미 저장한 내용을 확인하세요. - macOS를 사용하고 Claude Code에서 진지한 작업을 수행하는 경우: CCHV —을 설치하세요. 다중 에이전트 지원만으로도 2026년에는 그만한 가치가 있습니다.
- Windows/Linux를 사용하는 경우: 지금 VS Code 확장을 설치하세요. 30초 걸립니다
- AI 지원 개발을 사용하여 팀을 이끄는 경우: CCHV 헤드리스 서버 모드를 평가하십시오. 누군가 "왜 이렇게 구축했습니까?"라고 처음 묻는다면 미래의 자신은 감사할 것입니다.
이제 AI 세션 기록을 실제 지식 자산처럼 처리하는 도구가 존재합니다. 유일한 질문은 어느 것이 귀하의 작업 흐름에 맞는지입니다.