Claude Code에 일을 맡겨 두면 "Thinking…" 타이머만 멍하니 보고 있는 시간이 생각보다 길어서, Claude Code의 모드(mod) 기능을 공부하는 김에 채팅 옆에 띄워 두는 애니메이션 패널을 만들어 봤습니다.
패널마다 Claude가 쉬는 중일 때와 일하는 중일 때 장면이 달라집니다.
- 어항: 작업 중엔 어두워지고 잠수함이 내려옴, 끝나면 다시 밝아짐
- 달: 작업 중엔 우주인이 공중제비를 돌고 로켓·UFO가 더 자주 지나감
- 모닥불은 불이 커지고, 야간열차는 터널을 지나고, 눈 오는 오두막은 밤이 됨
패널 11개(야간열차, 해변, 눈 오는 오두막, 심해 잠수정, 모닥불, 정글 폭포, 비 오는 창, 달, 건물 단면, 책상 정원, 어항) + 프롬프트 위에 붙는 띠 2개(컨텍스트·사용량·비용 한 줄, Haiku 선택 시 경고).
만든 방식
- 모드 하나가 플러그인 하나: plugin.json + hooks/register.tsx
- Claude의 턴 시작·끝과 도구 호출을 받아 작은 상태(작업 중 여부, 도구 횟수, 스톱워치)만 들고, 그 상태가 바뀔 때만 그림을 다시 그림
- 그림은 전부 TypeScript로 만든 SVG + SMIL 애니메이션(이미지 파일 없음). 무작위로 지나가는 것들은 미리 시간표로 깔아 두고, 다시 그릴 때 애니메이션 시작 시각을 지난 시간만큼 당겨서 장면이 튀지 않게 함
설치 (Claude Code 안에서)
/plugin marketplace add Gnosis333/mod_gallery
/plugin install reef-tank@mod-gallery
→ /reload-plugins 후 /reef (달은 moon-view, /moon)
알아 둘 점
- Claude Code 2.1.287 이상, 모드는 얼리 액세스라 API가 바뀔 수 있음
- 움직이는 그림은 데스크톱 앱에서만 보이고, 터미널에서는 정지된 글자 그림
- 패널은 명령을 실행할 때만 열림(CPU 절약). 여러 개 열면 그리기 부담이 쌓임(모델 속도와는 무관)
- 글자는 기본 영어, language 옵션으로 한국어
- MIT. 코드 대부분은 Claude Code와 같이 만들었습니다
움직이는 모습은 README의 GIF로 볼 수 있습니다. 다음에 어떤 장면이 있으면 좋을지, 실제 작업 중에 덜 거슬리려면 뭘 바꾸면 좋을지 의견 주시면 반영해 보겠습니다.