도구별 실전 가이드 · 공식 정보 확인 2026-08-20
claude-devtools MIT 오픈소스 조건과 시작 절차
작성: gentive · 편집·검수 책임: 신유빈 · 지원 환경: macOS · 페이지 갱신: · 운영·편집 기준
세션 로그, 도구 호출, 토큰 사용량, 서브에이전트, 컨텍스트 창을 시각적으로 탐색해 에이전트 실행을 디버깅한다.
세션 로그, 도구 호출, 토큰 사용량, 서브에이전트, 컨텍스트 창을 시각적으로 탐색해 에이전트 실행을 디버깅한다. claude-devtools의 첫 실전 과제는 “비민감 샘플 세션에서 가장 토큰을 많이 쓴 도구 호출을 찾는다”이며, 이 흐름을 직접 통제할 사람에게 맞습니다.
이럴 때 맞습니다
- “어제 demo-project 세션의 prompt/completion 토큰과 반복 호출 상위 세 개” 같은 입력으로 claude-devtools의 핵심 기능을 시험하려는 사람
- 원본 세션 로그의 호출 횟수·토큰 합계와 화면 집계가 일치한다. 기준으로 claude-devtools 결과를 직접 검수할 수 있는 경우
- macOS 환경에서 MIT 코드를 직접 설치·관리하려는 작업
이럴 때는 멈추세요
- Claude Code 세션·도구 호출 시각화 데스크톱 DevTools 설치·모델 준비·업데이트를 관리하지 않고 즉시 완성된 서비스를 원하는 경우
- 다음 위험을 사람이 확인할 수 없는 작업: 세션 로그에는 프롬프트, 파일 내용, 명령 출력, 환경 변수 흔적이 들어갈 수 있어 화면 공유와 로그 내보내기 전에 비밀값을 제거해야 한다.
참고 시작점
팩트시트 · 작업 근거 확인 필요: 아래 문구는 공식 제품 사실을 정리한 참고 시작점이며, 성공 결과를 보장하는 검증 절차가 아닙니다.
Claude Code 세션 로그 가져오기
샘플 세션의 메시지·tool call·token 기록이 DevTools에 열린다.
참고 시작점: Claude DevTools에서 테스트 Claude Code 세션 하나를 선택해 달라. 검수 메모에는 “session viewer”가 확인된 화면이나 파일 위치를 포함해 달라.
- 개인정보 없는 샘플 세션을 고른다.
- 세션 viewer에 메시지 시간순을 연다.
- subagent와 context window 패널 존재를 확인한다.
도구 호출·컨텍스트 흐름 추적
실패 명령의 입력·출력과 당시 context 비율이 연결된다.
참고 시작점: 세션에서 실패한 tool call 하나를 찾아 전후 메시지와 token usage를 보여 달라.
- tool calls 패널에서 실패 상태를 필터한다.
- 호출 인자와 오류 출력을 펼친다.
- 같은 시각의 context window 사용량을 기록한다.
원 로그와 시각화 대조
호출 수·토큰·subagent가 원본 세션과 일치한다.
참고 시작점: 원 로그의 해당 이벤트와 DevTools 화면 값을 비교해 달라. 완료 보고에 “subagents”·“observability”·“Electron” 표기를 확인한 근거를 한 줄씩 덧붙여 달라.
- 호출 ID와 시각을 원 로그에서 찾는다.
- 입력·출력 토큰 합계를 비교한다.
- 누락된 subagent 또는 비밀값 노출을 표시한다.
무료 조건과 주의점
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 외부 제품 연동의 계정 조건은 공식 README에서 재확인 필요
MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 외부 제품 연동의 계정 조건은 공식 README에서 재확인 필요
MIT 저장소 코드는 상업적으로 사용할 수 있지만, 모델 가중치·입력 자료·생성물·번들 자산의 권리는 각각 따로 확인해야 합니다.
세션 로그에는 프롬프트, 파일 내용, 명령 출력, 환경 변수 흔적이 들어갈 수 있어 화면 공유와 로그 내보내기 전에 비밀값을 제거해야 한다.
직접 대안과 비교
- Claudoscope — ClaudeScope도 Claude Code 세션의 대화·사용량·보안 이벤트를 실시간 대시보드에서 추적한다.
공식 근거와 확인일
| 확인 항목 | 확인한 내용 | 공식 출처·확인일 |
|---|---|---|
| 제품 정보 | 세션 로그, 도구 호출, 토큰 사용량, 서브에이전트, 컨텍스트 창을 시각적으로 탐색해 에이전트 실행을 디버깅한다. | claude-devtools 공식 사이트 |
| 무료 조건 | MIT 오픈소스 소프트웨어는 횟수 제한 없이 실행 가능. 연결한 모델 API·서버·GPU 비용은 별도. 외부 제품 연동의 계정 조건은 공식 README에서 재확인 필요 | 공식 무료 정책·요금 안내 |
| 공식 코드 라이선스 | 오픈소스 코드의 사용·수정·재배포 조건 | 공식 코드 라이선스 |
| 공식 제품 페이지 | 세션 로그, 도구 호출, 토큰 사용량, 서브에이전트, 컨텍스트 창을 시각적으로 탐색해 에이전트 실행을 디버깅한다. | 공식 제품 페이지 |