도구별 실전 가이드 · 공식 정보 확인 2026-08-20
claude-devtools 사용법: 무료로 시작하는 가장 현실적인 방법
세션 로그, 도구 호출, 토큰 사용량, 서브에이전트, 컨텍스트 창을 시각적으로 탐색해 에이전트 실행을 디버깅한다. claude-devtools의 첫 실전 과제는 “비민감 샘플 세션에서 가장 토큰을 많이 쓴 도구 호출을 찾는다”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.
이럴 때 맞습니다
- “어제 demo-project 세션의 prompt/completion 토큰과 반복 호출 상위 세 개” 같은 입력으로 claude-devtools의 핵심 기능을 시험하려는 사람
- 원본 세션 로그의 호출 횟수·토큰 합계와 화면 집계가 일치한다. 기준으로 claude-devtools 결과를 직접 검수할 수 있는 경우
- macOS 환경에서 MIT 코드를 직접 설치·관리하려는 작업
이럴 때는 멈추세요
- Claude Code 세션·도구 호출 시각화 데스크톱 DevTools 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
- 다음 위험을 사람이 확인할 수 없는 작업: 세션 로그에는 프롬프트, 파일 내용, 명령 출력, 환경 변수 흔적이 들어갈 수 있어 화면 공유와 로그 내보내기 전에 비밀값을 제거해야 한다.
처음 해볼 작업 3가지
Claude Code 세션 로그 가져오기
샘플 세션의 메시지·tool call·token 기록이 DevTools에 열린다.
도구 호출·컨텍스트 흐름 추적
실패 명령의 입력·출력과 당시 context 비율이 연결된다.
원 로그와 시각화 대조
호출 수·토큰·subagent가 원본 세션과 일치한다.
무료 조건과 주의점
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 외부 제품 연동의 계정 조건은 공식 README에서 재확인 필요
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 외부 제품 연동의 계정 조건은 공식 README에서 재확인 필요
MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.
세션 로그에는 프롬프트, 파일 내용, 명령 출력, 환경 변수 흔적이 들어갈 수 있어 화면 공유와 로그 내보내기 전에 비밀값을 제거해야 한다.
직접 대안과 비교
- Claudoscope — ClaudeScope도 Claude Code 세션의 대화·사용량·보안 이벤트를 실시간 대시보드에서 추적한다.