클로드 효과음 도구 3개 설치 가이드 + 장면별 효과음 키워드 50개

클로드로 만든 영상에 효과음까지 알아서 넣게 해 주는 무료 도구 3개를 모았어요. 오픈버스(소리 522만 개), 오퍼스 사운드 레이어(무료 효과음 1,139개·19종), 이어샷(깃허브 별 4,000개+, 효과음 252개 내장).
각 도구마다 README에 적힌 공식 설치 명령어, 바로 붙여 넣는 첫 프롬프트, 그리고 맨 아래에 장면별 효과음 검색 키워드 50개를 정리했어요.

한눈에 보기

공통 준비물: 터미널에서 ffmpeg가 돼야 해요(맥: brew install ffmpeg). 설치 후에는 클로드 코드를 껐다 켜야 새 스킬·MCP가 보여요.

1. 오픈버스 (Openverse) — 소리 522만 개를 API 키 없이

무엇인지: 오픈버스는 CC 라이선스 사진·오디오를 모아 둔 무료 검색 엔진이에요. 공개 API(api.openverse.org)라 API 키 없이 바로 검색돼요. 클로드 코드에서는 openverse-sfx 스킬(Varnan-Tech/opendirectory 저장소)이 이 API로 효과음·배경음을 찾아 받고, 음량 맞추기와 credits.txt(출처 표기)까지 자동으로 해 줘요.

설치 (터미널)

npx skills add https://github.com/varnan-tech/opendirectory --skill openverse-sfx -g

• README 공식 명령은 npx skills add Varnan-Tech/opendirectory --skill openverse-sfx 예요. 끝에 -g(= --global)를 붙여야 ~/.claude/skills/에 깔려서 어느 폴더에서 연 클로드 코드에서도 보여요.
• 다른 방법(README Option A): npx "@opendirectory.dev/skills" install openverse-sfx --target claude
• 파이썬 패키지도 필요해요: pip install librosa matplotlib numpy scipy

직접 확인해 보기 (터미널, 키 없이 바로 돼요)

curl -s https://api.openverse.org/v1/audio/stats/ | jq '[.[].media_count] | add'
curl -s "https://api.openverse.org/v1/audio/?q=whoosh&license=cc0&page_size=5" | jq -r '.results[].title'

꼭 알아 둘 것

• 익명 사용은 하루 약 200회 검색 제한이 있어요. 스킬도 소리 종류마다 한 번만 검색해요.
• 라이선스는 cc0·by·pdm 만 써요(스킬이 강제해요). CC BY 소리는 출처 표기가 있어야 합법이라, 스킬이 credits.txt에 출처를 그대로 적어 줘요. 영상 설명란에 그대로 붙이세요.

첫 프롬프트

이 영상(out/final.mp4)에 openverse-sfx 스킬로 효과음을 넣어 줘. 화면 전환엔 whoosh, 글자 등장엔 pop, 클릭엔 click. CC0 위주로 고르고 credits.txt도 만들어 줘

오픈버스에서 15초 넘는 잔잔한 배경음악(cc0, by)을 3개 후보로 찾아서 길이·라이선스·출처를 표로 보여 줘

완성된 mp4를 verify_mix.py로 측정해서 음량(-16 LUFS)·피크가 통과하는지, 효과음이 컷 위치에 맞는지 확인하고 헤드폰으로 들어 볼 시각 5개를 알려 줘

2. 오퍼스 사운드 레이어 (opus-sound-layer) — 타임라인을 읽고 정확한 프레임에

무엇인지: 클로드(오퍼스)로 만든 모션 영상(리모션·HyperFrames 등)에 붙이는 사운드 레이어예요. 클로드는 소리를 못 들어서 효과음이 화면과 어긋나기 쉬운데, 이 저장소는 ① 진짜 녹음 효과음 1,139개(CC0)를 19종으로 깔아 두고 ② 타임라인(큐 시트)을 읽어 소리마다 정확한 위치(피크 정렬)에 배치하고 ③ 결과 mp4를 측정해 QA까지 해요.

19종: hit · boom · riser · reverse · transition · whoosh · swish · glitch · ui · click · key · tick · tap · pop · thump · paper · chime · shimmer · zap

준비물 (README Requirements)

• ffmpeg (PATH에 있어야 함)
• uv — 스크립트마다 파이썬과 패키지를 알아서 깔아 줘요. 맥: curl -LsSf https://astral.sh/uv/install.sh | sh
• uv가 invalid peer certificate 오류를 내면 UV_NATIVE_TLS=1을 설정하세요(백신·회사 프록시 환경).

설치 (터미널)

git clone https://github.com/Bodila51/opus-sound-layer
cd opus-sound-layer
uv run scripts/sfx.py kit

• sfx.py kit가 Kenney 팩 7개와 손으로 고른 Freesound 녹음을 받아 깨끗하게 자르고, catalog.json과 CREDITS.md를 만들어요.
• 클로드 코드에 붙여 넣을 프롬프트는 저장소의 PROMPT.md에 있어요.

손으로 돌려 보기 (README Run by hand)

uv run scripts/sfx.py browse --type hit --like "metal heavy"
uv run scripts/mix.py --schema           # 큐 시트 형식
uv run scripts/mix.py audio/cues.json
ffmpeg -i video.mp4 -i audio/mix.wav -map 0:v -map 1:a -c:v copy -c:a aac -b:a 256k -shortest out/final.mp4
uv run scripts/qa.py out/final.mp4

첫 프롬프트 (저장소 폴더에서 클로드 코드 실행)

PROMPT.md를 읽고 그대로 따라 줘. 내 영상은 ~/videos/launch.mp4 이고 HyperFrames로 만들었어. 장면 전환·글자 등장·클릭 순간을 타임라인에서 찾아 효과음을 넣어 줘

sfx.py browse로 whoosh 후보 5개를 파형이랑 같이 보여 주고, 0.4초 안쪽의 짧고 밝은 걸로 골라 줘

완성본을 qa.py로 검사해서 실패한 항목만 고쳐 다시 믹스해 줘

3. 이어샷 (earshot) — 코드로 새 효과음을 만들고 직접 들어 보고 확인

무엇인지: "코딩 에이전트에게 귀를" 달아 주는 도구예요. 소리를 말로 설명(describe)하고, 설명에 맞는지 점수(match)를 매기고, 영상 전체를 초 단위로 "듣고" 컷과 소리 싱크를 확인(timeline, sheet, critique)해요. 맞는 소리가 없으면 코드로 새 효과음을 만들고(forge) 들어 보며 고쳐요. 바로 쓰는 효과음 252개가 코드로 들어 있어요(sfx render). CPU만 쓰고, 첫 사용 때 모델 약 1.1GB를 받아요.

설치 (터미널, Python 3.10+ 와 ffmpeg/ffprobe 필요)

git clone https://github.com/Leonxlnx/earshot && cd earshot
python -m venv .venv
.venv/bin/python -m pip install torch --index-url https://download.pytorch.org/whl/cpu
.venv/bin/python -m pip install -e ".[mcp,llm,dev]"
.venv/bin/python -m earshot doctor --load

클로드 코드에 MCP로 연결 (터미널, README 그대로)

claude mcp add earshot --scope user -e EARSHOT_THREADS=3 -- /path/to/earshot/.venv/bin/python -m earshot mcp

• /path/to/earshot는 방금 clone 한 폴더의 실제 경로로 바꾸세요(그 폴더에서 pwd).
• 컴퓨터가 느리면 MCP_TIMEOUT=60000 claude 로 클로드 코드를 켜세요. 모델은 첫 호출 때 로드되고 계속 켜져 있어요.
• 스킬 2개(skills/earshot, skills/real-sound)를 ~/.claude/skills/에 복사하면 클로드가 언제 어떤 명령을 쓸지 알아요: cp -r skills/earshot skills/real-sound ~/.claude/skills/

자주 쓰는 명령

첫 프롬프트

earshot MCP로 out/final.mp4를 critique 해 줘. 컷보다 늦게 들리는 효과음과 너무 작은 소리를 시각과 함께 알려 주고 고쳐 줘

버튼 클릭 순간에 쓸 부드러운 UI pop 소리가 필요해. earshot sfx list에서 후보를 찾고, 없으면 forge로 만들어서 match로 확인해 줘

이 영상의 효과음 전체를 earshot sheet로 그림으로 뽑아서 싱크가 어긋난 곳을 표시해 줘

이렇게 조합하면 좋아요

1. 오퍼스 사운드 레이어로 기본 효과음 1,139개를 깔고, 타임라인 큐 시트로 장면마다 배치
2. 라이브러리에 없는 소리는 오픈버스에서 키 없이 검색해서 추가 (CC BY면 credits.txt 확인)
3. 그래도 없으면 이어샷 forge로 코드로 만들기
4. 마지막에 이어샷 critique·sheet로 직접 "듣고" 싱크·음량 확인 → 오퍼스 qa.py로 최종 검사

장면별 효과음 키워드 50개 (한국어 장면 → 영어 검색어)

오픈버스·프리사운드는 영어로 검색해야 잘 나와요. 왼쪽 장면에 맞는 검색어를 그대로 복사해서 q=에 넣거나 클로드에게 "이 키워드로 찾아 줘"라고 하세요.

전환·움직임

등장·강조

UI·조작

숫자·데이터

글리치·질감·분위기

검색 팁

• 오픈버스 API에서 &license=cc0를 붙이면 출처 표기도 필요 없는 소리만 나와요.
• 결과가 길면 duration(밀리초)을 같이 보고, 효과음은 0.2~1.5초짜리가 쓰기 좋아요.
• 같은 종류는 한 번만 검색하고 후보 중에서 고르세요(하루 약 200회 제한).

라이선스 주의

• CC0 / 퍼블릭 도메인(pdm): 출처 표기 없이 상업용으로 써도 돼요. 그래도 기록은 남겨 두세요.
• CC BY: 쓸 수 있지만 출처 표기가 꼭 필요해요. openverse-sfx가 만든 credits.txt의 문장을 유튜브 설명란 등에 그대로 붙이세요.
• CC BY-NC(비상업)·BY-ND(변경 금지)는 수익 영상·편집용으로 쓰지 마세요. openverse-sfx 스킬은 애초에 cc0·by·pdm 만 받아요.
• 오퍼스 사운드 레이어의 소리는 저장소에 들어 있지 않고 sfx.py kit가 Kenney·Freesound에서 CC0만 받아 와요. 출처는 audio/kit/CREDITS.md에 정리돼요. sfx.py add로 추가한 소리는 내가 준 출처를 따라가요.
• 이어샷 코드는 MIT, 모델(CLAP·AST)은 각 제작자 라이선스(Apache-2.0, BSD-3-Clause)예요. earshot fit으로 녹음을 코드로 바꾼 소리는 원본 녹음의 라이선스를 그대로 지켜야 해요.

자주 묻는 질문

• 설치했는데 스킬이 안 보여요 → 클로드 코드를 완전히 껐다 켜고 /를 눌러 목록을 확인하세요. -g 없이 설치했다면 그 폴더에서만 보여요. 클로드 앱(채팅)이 아니라 클로드 코드(터미널)용이에요.
• MCP가 연결 안 돼요 → claude mcp list로 earshot이 있는지 보고, 경로가 실제 .venv/bin/python인지 확인하세요. 첫 호출은 모델 로드로 20~40초 걸려요.
• 오픈버스 검색이 멈춰요 → 익명 한도(하루 약 200회)나 서버가 느린 시간일 수 있어요. 잠시 뒤 같은 검색어로 다시 하세요.
• 정말 무료예요? → 셋 다 오픈소스·무료예요. 오픈버스는 키도 필요 없어요.

링크

• 오픈버스: https://openverse.org · API https://api.openverse.org
• openverse-sfx 스킬: https://github.com/Varnan-Tech/opendirectory/tree/main/skills/openverse-sfx
• 오퍼스 사운드 레이어: https://github.com/Bodila51/opus-sound-layer
• 이어샷: https://github.com/Leonxlnx/earshot