Masko for Claude Code

Masko for Claude Code란?

Masko for Claude Code는 Claude Code 세션과 함께 뜨는 무료 오픈소스 macOS 데스크톱 동반 앱으로, 애니메이션 마스코트 오버레이를 표시합니다. 세션 활동을 실시간으로 추적하며, Claude가 권한이나 주의를 필요로 할 때 나타나 코딩 워크플로를 전환하지 않고 승인 또는 거부할 수 있습니다.

이 앱은 가벼운 오버레이 창으로 실행되며, 각 Claude 세션에 대한 관찰 대시보드를 제공합니다—세션 상태, 활동 피드, 권한 프롬프트 표시—Claude Code의 훅 시스템을 통해 모든 것을 로컬에서 유지합니다.

주요 기능

Claude Code용 macOS 오버레이 마스코트: 다른 창 위에 떠 있으며 현재 세션 상태(예: idle, working, attention)에 따라 업데이트됩니다.
실시간 권한 처리: Claude가 명령을 실행하려 할 때, 마우스 전환 대신 키보드로 allow/deny 흐름을 제공합니다.
알림 대시보드: 세션 스냅샷(예: running/awaiting input/compacting), 색상 코딩된 이벤트 피드, 세션 요약을 표시합니다.
서브에이전트 추적: 메인 세션 외에 발생하는 자식 에이전트를 실시간으로 모니터링합니다.
키보드 우선 세션 제어: 세션 간 전환, Claude Code를 실행 중인 터미널 탭으로 이동, 권한 액션 확인 단축키를 포함합니다.
로컬 우선 동작: Claude Code의 훅 시스템을 통해 이벤트 메타데이터(도구 이름 및 세션 상태)를 받지만 코드를 읽지 않으며, 서버로 코드를 보내지 않고 로컬에서 실행됩니다.

Masko for Claude Code 사용 방법

macOS에 다운로드 및 설치: 제공된 macOS DMG로 앱을 설치하세요; Dock를 어지럽히지 않고 메뉴바에 상주합니다.
접근성 권한 한 번 부여: 첫 실행 시 Claude Code 훅을 자동 설치하며, 오버레이를 위해 접근성 권한이 필요합니다.
Claude Code 시작: 터미널을 열고 Claude Code를 평소처럼 실행하여 앱이 세션을 관찰할 수 있게 합니다.
오버레이에서 상호작용: 프롬프트 시(예: Claude가 명령 실행 또는 질문), 키보드 단축키로 승인/거부하고 올바른 터미널 탭에 포커스합니다.
마스코트 선택: 기본 6개 마스코트 중 하나를 사용하거나 masko.ai에서 커스텀 마스코트를 데스크톱 앱으로 불러옵니다.

사용 사례

컨텍스트 전환 없이 Claude Code 명령 승인: Claude가 실행 권한을 요청할 때(예: 빌드 명령), 오버레이에서 키보드로 빠르게 allow/deny 액션을 제시합니다.
여러 세션에서 Claude 활동 추적: 세션 전환기와 세션 연동 터미널 점프로 여러 Claude 세션을 관리하고 각 세션에 연결된 정확한 터미널 탭으로 이동합니다.
세션 활동 및 도구 호출 검토: 알림 대시보드로 순서화된 이벤트(도구 호출 및 완료)를 확인하고 세션 변화를 시간에 따라 이해합니다.
“입력 대기” 순간 처리: 세션이 입력 대기를 표시할 때, 대시보드와 알림으로 상태를 식별하고 즉시 응답합니다.
서브에이전트에 의존하는 에이전트 활동 추적: 워크플로가 자식 에이전트를 트리거하면, 서브에이전트 추적으로 전체 실행 경로를 실시간으로 확인합니다.

자주 묻는 질문

Masko for Claude Code는 무료인가요? 네. 데스크톱 동반 앱은 무료 오픈소스이며 MIT 라이선스입니다.

Masko는 서버나 API 키가 필요하나요? 아니요. 설정 파일, 서버, API 키 없이 모든 것이 로컬에서 실행됩니다.

Masko는 무엇을 수집하나요, 내 코드를 읽나요? Masko는 Claude Code의 훅 시스템을 사용해 도구 이름 및 세션 상태 같은 이벤트 메타데이터를 받습니다. 코드를 읽지 않습니다.

마스코트는 어떻게 작동하나요? 앱에 기본 6개 마스코트가 포함되어 있습니다. masko.ai에서 커스텀 마스코트를 디자인하거나 불러와 데스크톱 앱에 로드할 수 있습니다.

Masko로 올바른 터미널로 이동할 수 있나요? 네. 오버레이에서 Claude Code를 실행 중인 터미널 탭에 즉시 포커스하는 단축키를 제공하며, 페이지에 언급된 터미널 및 에디터(iTerm2, Terminal.app, VS Code, Ghostty)를 지원합니다.

대안

터미널/편집기 내장 방식 (오버레이 없음): 터미널이나 IDE 내 Claude Code의 프롬프트에 의존해 그 자리에서 응답하세요. 항상 켜진 오버레이와 대시보드를 사용하는 대신 주의를 전환해야 한다는 점이 다릅니다.
일반 macOS 알림/자동화 도구: 알림 라우팅이나 키보드 자동화를 사용해 프롬프트와 작업을 강조하세요. 이는 더 일반적이며 Claude Code 전용 세션 관찰성이나 마스코트 기반 상태를 제공하지 않을 수 있습니다.
기타 개발자 생산성 오버레이: 개발 워크플로를 위한 세션 추적과 빠른 탐색을 제공하는 도구를 찾아보세요. 이러한 도구는 일반적으로 코드 탐색이나 채팅 기록에 초점을 맞추며 Claude Code 권한 프롬프트와 세션 이벤트 피드를 다루지 않습니다.
CLI 전용 워크플로와 수동 권한 확인: 명령줄에서 Claude Code를 실행하고 명령을 실행하기 전에 수동으로 검토하세요. 이는 최대한 간단하지만 오버레이의 실시간 대시보드 가시성과 한 번 클릭/키보드 승인을 제공하지 않습니다.