Claude Code가 입력을 기다릴 때 커서에 Claude 로고가 나타나게 해서 터미널을 계속 지켜볼 필요가 없어짐
My cursor sprouts a Claude logo the moment Claude Code is waiting on me - so I stop babysitting the terminal
핵심 요약
Claude Code가 사용자 입력을 기다릴 때 커서에 로고를 띄워 알림을 주는 윈도우용 커서 도구를 개발함.
- 커서 알림 도구 — Claude Code가 입력을 대기할 때 커서에 로고를 표시해 작업 효율을 높임.
- 기술적 구현 — 윈도우 시스템 커서 API와 Claude Code의 훅을 연동해 실시간으로 반응함.
- UX 고민 — 여러 에이전트가 동시에 대기할 경우를 대비해 '+N' 카운터 기능을 추가함.
- 플랫폼 제약 — 윈도우 외 OS에서는 커서 제어 권한 문제로 구현이 어려워 다른 알림 방식을 고려함.
얼마 전에 물리 엔진을 적용해서 움직이는 윈도우 커서를 하나 만들었거든(방향 따라 회전하고, 로딩 아이콘은 뱅글뱅글 돌고, 텍스트 캐럿은 젤리처럼 흔들림) - r/csharp이랑 r/Worms에서 반응이 꽤 좋았지. 근데 정작 내가 매일 쓰는 기능은 훨씬 단순하면서도 훨씬 유용하더라고. Claude Code가 내 입력을 기다릴 때 커서가 그걸 알려주는 기능이야. 긴 작업을 돌려놓고 alt-tab으로 다른 창 보다가, 터미널 앞에서 죽치고 앉아있거나 2분씩 늦게 확인하는 대신, 입력이 필요한 순간 커서에 작은 Claude 로고가 딱 뜨는 거지. 내가 다시 작업 시작하면 로고는 사라지고.
작동 원리는 간단해:
- Claude Code의 hooks를 그대로 활용함 - 설치 프로그램이
~/.claude/settings.json에command훅(Notification, Stop, SessionStart 등)을 심어두는 방식이야. - 이벤트가 발생하면 Claude가
WormsCursor.exe hook --tool claude-code를 실행하는데, 이게 실행 중인 트레이 앱으로 한 줄짜리 이벤트를 쏘고 0.5초도 안 돼서 종료됨 - 실패해도 조용히 넘어가니까 세션이 멈추거나 뻗을 일이 없음. - 에이전트가 대기 중일 땐 커서에 작은 Claude 로고가 매달려서 똑같이 물리 엔진 따라 흔들거려. 타이핑 시작하면 바로 사라지고.
- 여러 세션이 쌓이면: 동시에 여러 개가 대기 중일 땐 로고 옆에 +N이 붙어 - 그래서 그냥 '누군가 기다린다'가 아니라 몇 개나 나를 기다리는지 한눈에 알 수 있지. (터미널 여러 개 띄워놓고 작업할 때 개꿀임.)
- 폴링도 없고 터미널 긁어오는 것도 없음 - 오직 실제 이벤트에만 반응함.
만들면서 놀랐던 건, 그 물리 엔진 커서가 윈도우 깊숙한 곳까지 파고드는 윈도우 전용 기능이라는 점이었어. 모든 앱이 공유하는 시스템 커서 슬롯인 SetSystemCursor에 의존하는데, 다른 OS에는 이걸 깔끔하게 구현할 방법이 없더라고. macOS는 애플이 업데이트할 때마다 깨먹는 비공개 CoreGraphics API를 써야 하고, Wayland는 설계상 아예 금지되어 있어 - 클라이언트가 자기 창 밖의 커서를 건드리는 것 자체가 안 되거든. 그러니까 "움직이는 커서 포팅하기"는 주말 동안 뚝딱 할 수준이 아니라 거의 불가능에 가까운 거지. 하지만 "에이전트 대기 중" 신호는 완전히 별개의, 훨씬 낮은 수준의 문제야 - 그냥 훅에 반응만 하면 되니까 - 그래서 이건 크로스 플랫폼 버전(메뉴바 깜빡임, 알림, 독 아이콘 튀어 오르기 등)으로 만드는 게 아주 쉬워. 재밌는 부분이랑 유용한 부분이 깔끔하게 분리된 셈이지.
이걸 보면서 든 생각인데, 진짜 문제는 커서 그 이상의 무언가 같아. 에이전트를 비동기로 더 많이 돌릴수록, ""라는 게 새로운 UX 공백으로 떠오르고 있거든. 벨소리, 알림, 슬랙 핑 같은 건 "다른 창 보느라 집중 중"인 상황에 딱 들어맞질 않아. 커서는 이미 네 눈앞에 항상 있으니까 의외로 아주 좋은 채널이 되는 거고. 다들 Claude가 끝났거나 막혔을 때 어떻게 확인해? 훅을 쓰나, 커스텀 알리미를 쓰나, 모니터를 하나 더 쓰나, 아니면 그냥 감으로 때려 맞추나? 아직 이 문제에 대한 제대로 된 정답은 아무도 안 만든 것 같아.



