AI 칼럼

코딩@donghyeok99운영진

lot-map: Claude Code가 지금 뭘 하는지 보여 주는 실시간 지도

Claude Code가 파일을 읽는지, 셸을 도는지, 웹에 나갔는지 채팅 옆 지도에 불이 켜져요

가운데 CLAUDE에서 모델, 파일, 셸, 네트워크 역으로 불빛이 오가고, 지나온 길이 노란 선으로 이어지며, 훅이 호출을 막자 그 역이 빨갛게 남아요.
가운데 CLAUDE에서 모델, 파일, 셸, 네트워크 역으로 불빛이 오가고, 지나온 길이 노란 선으로 이어지며, 훅이 호출을 막자 그 역이 빨갛게 남아요.
누가
Aleksei Volodin(alexeyw)이 Claude Code를 쓰는 사람을 위해 만들었어요. MIT 라이선스예요.
언제
2026년 11월 9일에 저장소가 열렸고, 11월 12일에 0.6.0이 나왔어요.
어디서
Claude Code 데스크톱 앱과 터미널. macOS의 Claude Code 2.1.321에서 만들고 시험했고, Windows에서도 된다는 사용자 보고가 있어요(README 기준).

이게 불편했어요

Claude Code에 긴 작업을 맡기면 화면에는 명령이 한 줄씩 쌓여요. 지금 파일을 고치는 중인지, 네트워크에 나갔는지, 서브에이전트가 몇 개 돌고 있는지 알려면 그 목록을 직접 읽어야 했어요.

그래서 이렇게 풀어요

lot-map은 채팅 옆 창에 지도 한 장을 띄워요. 가운데 원에서 나, 모델, 메모리, 파일, 셸, 네트워크, 브라우저, 에이전트, 스킬, 훅 열 개의 역으로 호출이 시작될 때 불빛이 날아가고 끝나면 돌아와요. 많이 쓴 길은 굵어지고 거절과 오류는 빨갛게 남아서, 세션이 끝나면 일이 어디에 몰렸는지 지도에 남아요. 지도에 적히는 것은 이름뿐이고 명령 줄이나 파일 내용은 나오지 않아요.

지어낸 세션을 플러그인의 그리기 코드로 다시 돌린 데모
지어낸 세션을 플러그인의 그리기 코드로 다시 돌린 데모
작업 중: 쓰는 역에 불이 켜지고 지나온 길이 이어져요
작업 중: 쓰는 역에 불이 켜지고 지나온 길이 이어져요
서브에이전트가 에이전트 역 둘레를 작은 점으로 돌아요
서브에이전트가 에이전트 역 둘레를 작은 점으로 돌아요
훅이 호출을 거절하면 그 역에 빨간 점이 남아요
훅이 호출을 거절하면 그 역에 빨간 점이 남아요

이걸로 만든 사람들

GitHub@buddyatkins2026-11-12

터미널에서는 글자 줄만 보이던 지도를 iTerm2, kitty, Ghostty에서 그림으로 띄우는 terminalView 옵션을 직접 만들어 보냈고, 어두운 화면과 밝은 화면에서 찍은 결과를 올렸어요.

Seen in iTerm2 3.7.7 on macOS 27.2.1, in a dark and a light profile: pictures below.
좋아요 0 · 댓글 7 (2026-11-13 기준)GitHub ↗

안에서는 이렇게 돌아가요

  1. 1

    나 → Claude Code

    메시지평소처럼 Claude Code에 일을 시켜요.
  2. 2

    Claude Code → register.tsx (훅)

    도구 호출, 모델 요청, 훅 이벤트플러그인의 훅이 이벤트를 받고, 받은 그대로 넘겨요. 입력도 결과도 바꾸지 않아요.hooks/register.tsx
  3. 3

    register.tsx (훅) → classify.ts

    도구 이름과 입력어느 역인지와 라벨을 정해요. 파일은 경로 끝 두 마디, 주소는 호스트만 남겨요.hooks/classify.ts
  4. 4

    classify.ts → board (세션 기록)

    역, 라벨, 시작 시각호출이 시작되면 기록 한 줄이 열리고 끝나면 닫혀요. 오류와 거절은 따로 세요.hooks/register.tsx
  5. 5

    board (세션 기록) → lot-map 창

    drawMap이 그린 지도기록에서 불빛, 길, 굵은 바퀴살, 컨텍스트 고리를 그려요.hooks/draw.ts
  6. 6

    board (세션 기록) → lot-map 창

    터미널에서는 PNG 그림terminalView가 picture면 같은 그림을 직접 칠해 터미널에 올려요.hooks/raster.ts

넣으면 이렇게 나와요

Read, Write, Edit, Grep, Glob파일 역
curl, gh, git push, npm install네트워크 역
동시에 시작한 호출 세 개역에 ×3
컨텍스트 창 70%, 90%가운데 고리가 호박색, 빨간색

나한테 맞을까요

이럴 때 좋아요

  • 긴 작업을 맡겨 두고 곁눈으로 진행을 보고 싶을 때
  • 서브에이전트나 백그라운드 작업을 여러 개 돌릴 때
  • 세션이 끝난 뒤 일이 어느 쪽에 몰렸는지 보고 싶을 때
  • 컨텍스트 창이 얼마나 찼는지 놓치고 싶지 않을 때

이건 안 돼요

  • 터미널에서는 창이 144열 이상일 때만 스스로 열려요. 좁으면 /lot-map을 입력해야 해요.
  • 터미널 기본은 글자 줄뿐이에요. 지도 그림은 terminalView를 picture로 두고 iTerm2 3.5 이상, kitty, Ghostty에서 보여요.
  • 셸 명령은 하는 일이 아니라 이름으로 분류해요. python -c로 연결을 여는 스크립트는 셸로 보여요.
  • 라벨 언어는 en, ru, es, fr, de, it, pt 일곱 가지이고 한국어는 없어요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기