delexw/claude-code-trace

해결하는 문제

Claude Code는 세션 기록을 ~/.claude/projects/에 원시 JSONL 파일로 저장합니다. 이는 사람에게 읽기 어렵고 분석하기 어렵습니다. Claude Code Trace는 이러한 로그를 실시간으로 탐색, 검색, 모니터링할 수 있는 사용자 친화적인 인터페이스를 제공하여 원시 데이터를 읽기 쉬운 대화로 전환합니다.

작동 방식

이 도구는 로컬 JSONL 세션 파일을 읽어 인터랙티브한 대화로 렌더링합니다. GUI 데스크톱 앱(Tauri 기반), 웹 앱, 터미널 사용자 인터페이스(TUI)의 세 가지 다른 인터페이스를 지원합니다. 또한 Jev(TypeSafe AI의 System One Model)와 통합되어 에이전트 트레이스에 대한 행동 분석을 수행하고, 도구 사용, 집중도, 복구 능력과 같은 효율성 지표를 평가합니다.

대상 사용자

장시간 실행되는 워크플로우를 디버깅하거나, 도구 및 MCP(Model Context Protocol) 호출을 검사하거나, AI 에이전트의 행동 효율성을 분석해야 하는 Claude Code 사용자.

주요 기능

• 다중 인터페이스 지원: 데스크톱 앱, 웹 앱, TUI로 모두 사용 가능.
• 실시간 추적: 실행 중인 Claude Code 세션을 실시간으로 모니터링 가능.
• Jev 통합: 타입 안전한 확률을 사용해 에이전트 효율성을 분석하고, 과도한 반복 또는 비효율적인 토큰 사용을 식별.
• MCP 지원: Model Context Protocol 도구 호출을 자동으로 감지하고 인간이 이해하기 쉬운 이름으로 표시.
• 개인정보 보호 중심: 외부 Jev 분석에 전송하기 전에 페이로드를 마스킹하고 명시적 승인을 요구.
• 크로스플랫폼: macOS, Linux, Windows용 네이티브 빌드 제공.