Claude Code 훅을 활용한 데스크탑 펫 프로젝트

섹션별 상세

Claude Code 훅 시스템의 단순함을 활용하여 외부 도구와 연동하는 방식을 고민했다. 훅은 세션 이벤트를 stdin을 통해 JSON 페이로드로 전달하여 실시간 상태 파악을 가능하게 한다. GitHub 리포지토리에 공개된 구현 코드는 이 훅 시스템을 직접 활용한다. 이를 통해 개발자는 AI 세션 상태를 외부 애플리케이션과 쉽게 통합할 수 있다.

단순한 알림 대신 시각적인 피드백을 제공하는 데스크탑 펫을 구현했다. 펫은 Claude Code의 idle, working, planning, waiting, finished 상태에 따라 애니메이션을 변경한다. 실제 구현된 펫은 사용자가 프롬프트를 보낼 때 깨어나고 응답이 완료되면 다시 잠드는 동작을 수행한다. 이는 AI와의 상호작용을 더 직관적이고 재미있게 만든다.

Code Pet 설정 화면으로, 다양한 상태(Idle, Working, Planning 등)에 따른 애니메이션 미리보기를 보여준다. — ScreenshotClaude Code 세션 상태에 따라 펫이 어떻게 반응하는지 시각적으로 보여준다. 각 상태별 애니메이션을 통해 사용자가 현재 AI의 작업 단계를 직관적으로 파악할 수 있음을 나타낸다.

어떤 도구가 실제로 워크플로에 도움이 되는지 파악하기 위해 도구 사용 빈도 추적이 필요했다. PostToolUse 이벤트를 통해 도구 이름, 입력, 출력 데이터를 수집하고 로컬에서 사용 빈도를 랭킹화한다. 구현된 기능은 별도의 외부 서버 없이 로컬에서만 작동한다. 이를 통해 사용자는 자신의 도구 사용 패턴을 분석하고 효율적인 워크플로를 설계할 수 있다.

용어 해설

클로드 코드(Claude Code): — Anthropic에서 제공하는 CLI 기반 AI 코딩 에이전트. 로컬 파일 시스템에 접근하여 코드를 작성, 수정, 실행하며 훅 시스템을 통해 외부 도구와 연동 가능하다.
모델 컨텍스트 프로토콜(MCP): — AI 모델과 외부 데이터, 도구 간의 상호작용을 표준화하는 프로토콜. 다양한 소스의 데이터를 AI 에이전트가 일관된 방식으로 활용할 수 있게 한다.

언급된 도구

Claude Code추천

AI 코딩 에이전트 및 훅 시스템 제공

MCP중립

도구 연결 및 상호운용성 표준

언급된 리소스

GitHubCode Pet GitHub Repository