원문 캡처 · github.com
원문 캡처 · github.com

orc-work-notify는 Claude Code에서 프롬프트를 보내거나, Claude가 사용자 응답을 기다리거나, 작업을 마칠 때 오크 음성 효과음을 재생하는 플러그인이다. 소리는 백그라운드에서 재생돼 Claude의 작업을 늦추지 않는다고 안내한다.

설치하려면 다음 명령을 실행한 뒤 Claude Code를 다시 시작하거나 /reload-plugins를 실행한다.

claude plugin marketplace add vagkaratzas/orc-work-notify
claude plugin install orc-work-notify@orc-work-notify

프롬프트 제출에는 submit.wav, 질문이나 권한 요청 등 사용자의 주의가 필요한 상황에는 attention.wav, 작업 완료에는 stop.wav를 재생한다. 플러그인에는 John Carroll의 무료 Orc Voice Pack에서 가져온 효과음 세 개가 포함돼 있으며, 해당 음원은 CC0 퍼블릭 도메인으로 제공된다. Orc Voice Pack

다른 효과음을 쓰려면 .wav 파일을 이벤트 이름에 맞춰 ~/.claude/sounds/ 또는 프로젝트의 <project>/.claude/sounds/에 둔다. 사용자 홈 디렉터리의 파일은 모든 프로젝트에, 프로젝트 디렉터리의 파일은 해당 프로젝트에만 적용된다. 파일은 플러그인 바깥에 저장되므로 업데이트 때 덮어쓰지 않는다. 파일 대신 이벤트 이름을 딴 폴더에 .wav 파일을 여러 개 넣으면 재생할 때마다 하나를 무작위로 선택한다. 같은 위치에서는 폴더가 단일 파일보다 우선하며, 프로젝트별 설정이 홈 디렉터리 설정보다 우선한다. 빈 폴더는 무시하고 소문자 .wav 파일만 인식한다.

~/.claude/orc-work-notify.muted 파일에 내용이 있으면 음소거된다. 아래 명령으로 음소거와 해제를 설정할 수 있다.

echo 1 > ~/.claude/orc-work-notify.muted # mute
: > ~/.claude/orc-work-notify.muted # unmute

오디오 재생기는 afplay(macOS), pw-play, paplay, ffplay, aplay, powershell.exe(Git Bash를 통한 Windows) 순서로 시도하며, 프로그램이 없거나 실행에 실패하면 다음 재생기를 사용한다. 코드는 MIT 라이선스, 포함된 음원은 CC0 라이선스다. 프로젝트 저장소