당신의 Claude Code는 여전히 '눈먼 코딩'을 하고 있습니다.
Your Claude Code is still "coding blind."
핵심 요약
Claude Code의 블랙박스 문제를 해결하고 세션 로그를 시각화하는 로컬 UI 도구 'claude-devtools'를 소개합니다.
- 블랙박스 문제 해결 — Claude Code의 내부 동작과 메모리 파일을 시각화하여 투명성을 높임.
- 주요 기능 추가 — 클립보드 복사, SSH 원격 세션, 메모리 뷰어 등 사용자 요청 기능을 구현함.
- 로컬 기반 도구 — API 키나 외부 래퍼 없이 로컬 JSONL 로그를 읽어 안전하게 작동함.
- 오픈 소스 프로젝트 — MIT 라이선스로 배포되며 현재도 활발히 개발 중인 오픈 소스 도구임.
여러분 안녕하세요,
3개월 전, 저는 Claude Code가 단순히 일반적인 초록색 체크 표시만 보여주는 대신 diff, 도구 호출, 숨겨진 메모리 파일을 실제로 보여주는 로컬 UI를 만들었습니다.
당시 Claude가 작업 내용을 숨기는 것에 지쳐서 대략적인 버전을 이곳에 올렸었죠. 반응이 예상보다 훨씬 뜨거웠고(그 이후로 별 3.3k개, 다운로드 67k회 기록), 그래서 지난 몇 달 동안 사용자들의 기능 요청을 모아 'claude-devtools'라는 제대로 된 도구로 발전시켰습니다.
'블랙박스' 문제가 점점 심각해지고 있습니다
최근 샌프란시스코에서 열린 Claude 발표를 보셨다면 아시겠지만, Anthropic은 '관리형 에이전트'에 힘을 싣고 있습니다. 메모리, 도구 루프, 검증 과정을 플랫폼 내부로 직접 옮기고 있죠.
효율적이긴 하지만, 이로 인해 CLI가 완전히 블랙박스화되고 있습니다. 터미널을 매초 지켜보고 있지 않으면 Claude가 왜 특정 결정을 내렸는지, 프로젝트 메모리에 실제로 무엇을 기록하고 있는지 알기 어렵습니다. 세션이 끝나면 해당 컨텍스트는 보통 사라져 버리죠. 최근 Claude 데스크톱 UI 업데이트가 이를 일부 해결했지만, 터미널을 사용하는 사람들에게는 과거 세션을 되짚어볼 방법이 없습니다.
그래서 이를 해결하기 위해 devtools에 다음과 같은 기능을 추가했습니다:
깔끔한 복사-붙여넣기: 터미널에서 코드를 복사하면 보통 ANSI 색상 코드와 깨진 줄바꿈이 포함됩니다. 모든 메시지에 원본 그대로의 깔끔한 코드를 즉시 복사할 수 있는 버튼을 추가했습니다.
SSH 및 원격 세션: 가장 요청이 많았던 기능입니다. 원격 개발 환경에서 Claude Code를 실행하면 SSH를 통해 연결하고, 기존 설정을 읽고, 로컬 머신에서 실시간으로 로그를 확인할 수 있습니다.
메모리 뷰어: Claude는 프로젝트에 대해 알고 있는 내용을 추적하기 위해 숨겨진 MEMORY.md 파일과 스타일 가이드를 유지합니다. 저는 이 레이어를 탐색하고 VS Code, Cursor, Zed에서 직접 열어 Claude가 무엇을 '기억'하고 있는지 관리할 수 있는 UI를 만들었습니다.
컨텍스트 시각화: 더 나은 시각화, 컨텍스트 재구성, 성능 최적화가 이루어졌습니다.
API 키나 래퍼가 필요 없습니다!
이 도구는 여전히 100% 로컬에서 작동하며 MIT 라이선스를 따릅니다. Claude가 이미 디스크에 저장하고 있는 JSONL 로그를 읽어서 읽기 쉽게 만들어줄 뿐입니다. 추가적인 권한이나 키를 제공할 필요가 없습니다.
프로세스를 무작정 신뢰하는 대신 실제로 내부에서 무슨 일이 일어나고 있는지 확인하고 싶다면 한번 사용해 보세요.
