Claude Muzak: macOS에서 Claude Code를 사용할 때 자동으로 배경 음악을 재생하고 멈추는 도구

읽을거리&정보공유
, , , , , ,
1

Claude Muzak: Claude Code 사용 시 배경 음악을 자동으로 재생하는 도구
Claude Muzak: Claude Code 사용 시 배경 음악을 자동으로 재생하는 도구1187×229 19 KB

Claude Muzak 소개

Claude Muzak은 코드 작업을 할 때 자동으로 배경 음악을 재생해 주는 작은 파이썬 스크립트입니다. 이름처럼 일종의 ‘엘리베이터 뮤직’ 같은 역할을 하여, 사용자가 Claude Code 세션을 실행하는 동안 편안한 음악을 틀어줍니다. 음악은 muzakfiles/ 디렉토리에 넣어둔 음원 파일에서 무작위로 선택되며, 이를 통해 개발 환경을 조금 더 즐겁고 편안하게 만들 수 있습니다.

이 프로젝트의 핵심은 자동 통합 기능에 있습니다. 사용자는 Claude Code 설정(~/.claude/settings.json)에 몇 줄의 훅(hook) 설정만 추가하면, Claude가 프롬프트를 제출할 때 음악이 자동으로 시작되고, 세션이 끝나면 음악이 종료됩니다. 즉, 사용자가 별도로 음악을 틀고 끄는 번거로움 없이 자연스럽게 코딩과 음악을 함께할 수 있습니다.

또한 이 프로젝트는 외부 의존성 없는 파이썬 표준 라이브러리만으로 동작하며, macOS의 기본 오디오 재생 명령어인 afplay를 활용합니다. 그렇기 때문에 설치 과정이 매우 단순하고, 개발자 입장에서 부담 없이 적용할 수 있다는 장점이 있습니다.

코드를 작성하거나 AI 기반 작업을 할 때 배경 음악이 주는 몰입감은 상당합니다. 집중을 유지하는 동시에 반복적인 작업에 느껴지는 지루함을 줄여주며, Claude Muzak은 바로 이 점을 노리고 만들어진 가벼운 도구라고 할 수 있습니다.

음악 재생을 자동화하는 스크립트나 도구는 많지만, Claude Muzak은 Claude Code와 밀접하게 연결된 훅(hook) 기반 자동 재생이 특징입니다. 일반적인 음악 플레이어(예: iTunes, Spotify CLI, VLC 명령줄 모드)는 사용자가 명시적으로 실행·정지 명령을 내려야 하지만, Claude Muzak은 작업 흐름에 맞춰 자동으로 음악을 제어합니다.

또한, 다른 개발용 음악 도구들은 대체로 추가 라이브러리나 서드파티 API를 필요로 하는 반면, Claude Muzak은 파이썬 표준 라이브러리와 macOS 기본 기능만 사용하기 때문에 설치 및 유지보수가 간단합니다. 다만, macOS 전용이라는 한계가 있어, 크로스 플랫폼 호환성을 원한다면 별도의 수정이나 다른 솔루션을 고려해야 합니다.

Claude Muzak의 주요 기능

  • 자동 재생 및 제어: Claude Muzak은 Claude Code와의 세션 훅을 통해 음악을 자동으로 실행하고 종료합니다. ESC, Q, 또는 Ctrl+C 키를 눌러 수동으로 음악을 중단할 수도 있으며, 직관적이고 간단하게 제어가 가능합니다.

  • 지원되는 오디오 포맷: 다양한 음원 포맷을 지원하여 사용자가 보유한 음악 파일을 그대로 활용할 수 있습니다. 지원 포맷은 MP3, M4A, WAV, AAC, FLAC, OGG 등입니다. 즉, 별도의 변환 과정 없이 다양한 음악을 섞어 재생할 수 있습니다.

Claude Muzak 사용 방법

Claude Muzak을 사용하기 위해서는 먼저 아래의 시스템 요구사항을 만족해야 합니다:

  • macOS (내장 afplay 사용)
  • Python 3.6 이상
  • muzakfiles/ 디렉토리에 음악 파일 추가

시스템 요구 사항을 만족했다면, 다음과 같이 실행 할 수 있습니다:

  1. claude_muzak.py가 위치한 경로를 확인합니다:

    pwd  # 현재 경로 복사

  2. Claude Code 설정 파일(~/.claude/settings.json)에 다음과 같은 훅(hook)을 추가합니다. 이 때, 각 command 부분의 /full/path/to/claude_muzak.py 을 위에서 복사한 경로로 바꿔서 입력해야 합니다:

    {
  "hooks": {
    "UserPromptSubmit": {
      "command": "python3 /full/path/to/claude_muzak.py hook start"
    },
    "SessionEnd": {
      "command": "python3 /full/path/to/claude_muzak.py hook stop"
    }
  }
}

  3. 이제 Claude Code를 다시 시작하면 자동으로 음악이 재생되고, 세션이 종료되면 음악이 멈춥니다.

사용 시 문제 해결

  • 음악이 재생되지 않을 경우 muzakfiles/ 폴더에 음원 파일이 있는지 확인해야 합니다.
  • ESC 키가 먹히지 않을 때는 Q나 Ctrl+C 키를 사용하면 됩니다.
  • 훅(Hook)이 작동하지 않으면 경로를 다시 확인하고 Claude Code를 재시작해야 합니다.

라이선스

Claude Muzak 프로젝트는 MIT License로 공개 및 배포되고 있습니다. 상업적 사용을 포함해 자유롭게 수정 및 재배포가 가능합니다.

:github: Claude Muzak 프로젝트 GitHub 저장소



이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. :hugs:

:pytorch:파이토치 한국 사용자 모임:south_korea:이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일:love_letter:로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)

:wrapped_gift: 아래:down_right_arrow:쪽에 좋아요:+1:를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ :star_struck: