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

startup-song은 Claude Code를 시작할 때마다 무작위 노래를 몇 초간 재생하고 시작 화면에 정보를 띄우는 플러그인이다. 모델 호출 없이 동작하며, macOS와 인터넷 연결이 필요하다.

플러그인은 세션마다 팝, 힙합, 레트로 히트곡 장르를 번갈아 선택하고, 무료인 iTunes Search API에서 검색한 상위 10개 결과 중 무작위 곡을 재생한다. 오디오는 Apple이 제공하는 공식 30초 미리듣기이며, 다운로드하거나 저장하지 않는다. 설정한 재생 시간은 기본 10초, 최대 30초다.

재생 중에는 프롬프트 위에 시작 카드가 나타난다. 카드에는 연속으로 Claude Code를 시작한 날짜 수, 브랜치·변경 파일·앞섬/뒤처짐·마지막 커밋을 포함한 저장소 상태, 그리고 위키백과 ‘오늘의 역사’ 피드의 사건 하나가 표시된다. 우울한 사건은 제외한다. 노래가 끝나면 카드가 사라지며, 빈 프롬프트에서 Esc를 누르면 재생을 일찍 멈출 수 있다. /today 명령으로 카드를 다시 열 수 있다.

개발자 설명에 따르면 플러그인은 토큰을 사용하지 않는다. 웹 요청 두 번, 로컬 git 명령 두 번, 오디오 클립으로 동작한다. macOS에서는 afplay를 사용하며, Linux와 Windows에서는 소리가 나지 않는다. 시작 시 인터넷에 연결되어 있지 않으면 아무것도 재생하지 않는다.

설치는 Claude Code에서 다음 명령을 실행한다.

/plugin install startup-song --marketplace heyyviv/claude-boot-beats

로컬 복사본으로 시험하려면 다음 명령을 사용한다.

claude --plugin-dir ./claude-startup-song

장르와 재생 시간은 /config에서 genres와 seconds 설정으로 바꿀 수 있다. 장르는 쉼표로 구분한 검색어이며 차례대로 사용된다.