클로드 개발 도구: 향상된 클로드 코드 가시성을 위한 로그 리더

Claude DevTools는 ~/.claude/ 폴더에 있는 기존 로그 파일을 파싱하여 Claude Code의 터미널 출력에서 흔히 겪는 불편함을 해결하는 유틸리티입니다. Claude Code 자체의 작동 방식을 변경하지 않고도 세션에 대한 상세한 가시성을 제공합니다.

주요 기능

• 작업에 대한 완전한 가시성: 모든 파일 읽기, 인라인 차이가 포함된 모든 편집, 실행된 모든 bash 명령어를 보여주며, "3개의 파일 읽음"과 같은 모호한 요약을 구체적이고 구문 강조된 세부 정보로 대체합니다.
• 턴별 토큰 분석: 컨텍스트 사용량을 CLAUDE.md 파일, 도구 호출 입력/출력, 사고 토큰, 스킬 활성화, 사용자 텍스트 등 7가지 범주로 분할하여 컨텍스트 창을 소모하는 요소를 식별하는 데 도움을 줍니다.
• 컨텍스트 창 시각화: 세션 동안 컨텍스트가 어떻게 채워지는지, 언제 압축이 발생하는지, 무엇이 삭제되는지 표시하여 Claude가 대화 중간에 정보를 잊어버리는 이유를 명확히 합니다.
• 전체 하위 에이전트 가시성: Claude가 Task 도구를 사용하여 하위 에이전트를 생성할 때, 각 에이전트의 전체 실행 트리(프롬프트, 도구 호출, 토큰 사용량, 비용, 소요 시간 포함)를 렌더링합니다. 에이전트가 더 많은 에이전트를 생성하면 전체 중첩 트리를 표시합니다. TeamCreate 및 SendMessage와 같은 팀 기능은 각 팀원을 색상으로 구분된 카드로 보여줍니다.
• 사고 출력: 확장된 사고 블록을 도구 추적과 함께 읽어 Claude의 결정 배후의 추론을 이해할 수 있도록 합니다.
• 사용자 정의 알림: .env 파일 접근, 도구 실행 오류, 임계값을 초과하는 토큰 사용량 급증과 같은 이벤트에 대한 알림을 지원하며, 민감한 파일 경로에 대한 정규식 트리거를 포함합니다.
• 모든 세션과 호환: 원시 로그 파일을 읽어 터미널, VS Code 및 기타 도구의 세션을 데이터 손실 없이 캡처합니다.
• 다양한 배포 옵션: Electron 앱, Docker 컨테이너 또는 브라우저를 통해 접근 가능한 독립 실행형 Node 서버로 이용 가능하며, 원격 설정이나 Electron 회피에 유용합니다.
• 제로 설정: API 키나 구성 파일이 필요하지 않습니다—설치하고 열기만 하면 됩니다.
• 오픈소스 및 로컬: 이 도구는 오픈소스이며 로컬에서 실행되며, Claude Code의 작동을 방해하지 않는 읽기 전용입니다.

이 도구는 기본 터미널 출력보다 더 많은 투명성이 필요한 Claude Code의 고급 사용자를 위해 설계되었습니다. 독립적으로 실행되며 기존 로그를 활용하여 세션 활동에 대한 상세한 통찰력을 제공합니다.