2026년 11월 20일 직접 시험 · earshot 0.4.1(github.com/Leonxlnx/earshot, MIT, 별 약 5.3천) · Claude Code 2.1.326 · sonnet · 게임은 11/16 클로드 코드로 만든 3D 비행 게임 복사본 · 비교 녹음 Kenney Impact Sounds(CC0) · 각 1회
AI로 게임을 만들면 화면 · 조작까지는 금방인데, 마지막에 막히는 게 소리예요. 클로드는 소리를 들을 수 없거든요. earshot은 AI 코딩 에이전트에게 '귀'를 주는 오픈소스입니다. 소리를 설명하고, 원하는 소리와 맞는지 점수를 매기고, 코드로 소리를 만들 수도 있어요. 지난번 만든 비행 게임에 녹음 파일 없이 효과음을 넣어 봤습니다.
earshot은 무엇인가요?
CPU에서 로컬로 도는 '듣는 도구'입니다. CLI · 파이썬 API · MCP 서버(클로드 코드에 연결)로 쓸 수 있고, README에 따르면 earshot forge로 코드로 소리를 만들고 들어 보며 고칠 수 있어요. 코드로 저장된 내장 소리 252개를 earshot sfx render로 바로 뽑을 수도 있습니다.

| 명령 | 하는 일 |
|---|---|
earshot describe 파일 |
어떤 소리로 들리는지 설명 |
earshot match 파일 "설명" |
설명과 얼마나 맞는지(strong · plausible · weak) |
earshot rank "설명" 파일… |
여러 후보를 설명에 맞는 순서로 |
earshot sfx render ID -o x.wav |
내장 소리 252개 중 하나를 코드로 렌더 |
earshot realness 파일… |
진짜 녹음인지 코드로 만든 소리인지 추정 |
설치는 어려웠나요?
파이썬 패키지라 pip로 깔면 되는데, torch · transformers가 필요하고 처음 '듣기'를 할 때 모델 두 개(약 1.1GB)를 받습니다. 저희는 이미 torch가 있는 파이썬 환경에 저장소를 그대로 쓰고, 빠진 패키지(pyloudnorm · matplotlib)만 따로 폴더에 넣어 돌렸어요. earshot doctor로 설치 상태를 확인할 수 있습니다.
클로드에게 어떻게 시켰나요?
게임 폴더 복사본에서 클로드 코드에 이렇게 맡겼습니다.
earshot으로 효과음을 코드로 만들어서 게임에 넣어 줘. 녹음 파일은 쓰지 마. 1) 추락해서 부딪히는 소리 2) 다시 출발할 때 짧은 신호음 3) 스로틀을 올려 빨라질 때 바람이 스치는 소리. 각 소리는 earshot forge 또는 sfx render로 만들어 sounds/에 저장하고, describe나 match로 들어 보고 원하는 소리와 다르면 다시 만들어.
2분 48초 · 16턴 만에 끝났고, 사용량으로 환산하면 약 0.35달러였어요.

| 소리 | 쓴 명령 | 들어 본 결과 | 다시 만든 횟수 |
|---|---|---|---|
| 추락 충돌음 | sfx render impact/blast --dur 1.6 |
처음 고른 punch는 '큰 드럼 소리'로 들려 weak → blast가 strong | 1회 |
| 재출발 신호음 | sfx render mallet/glock |
match strong(322개 설명 중 1위) | 0회 |
| 가속 바람 | sfx render whoosh_big/jet --dur 1.5 |
처음 고른 gust는 plausible → jet이 strong | 1회 |
게임 코드에는 playSfx()를 하나 추가해 추락 · 재출발 · 스로틀을 올릴 때 그 wav를 재생하게 했고, 기존 음소거 설정도 따릅니다. 다만 클로드는 "브라우저에서 직접 플레이해 보지는 못했다"고 적었어요. 그래서 저희가 게임을 녹화해 추락 → 재출발 → 가속이 일어나는 시각에 그 소리가 나오는 것을 영상으로 확인했습니다(영상은 녹화 화면에 같은 시각으로 소리를 얹은 것).
진짜 녹음과 구별될까요?
판정기도 헷갈렸습니다. 같은 '부딪히는 소리'로 Kenney의 실제 녹음(CC0)과 클로드가 만든 충돌음을 earshot realness에 넣었더니, 녹음은 0.91(real or pro-produced), 코드로 만든 소리는 0.75(uncertain, 녹음 쪽으로 기움)가 나왔어요.


영상에서는 두 소리를 나란히 들려 드리고 퀴즈로 냈어요(첫 번째가 녹음, 두 번째가 코드). 0.75라는 숫자처럼, 아주 짧은 충돌음은 코드로도 꽤 그럴듯합니다. 대신 이 숫자는 1회 측정이고, README도 이 판정을 '약하게 보정된 값'으로 설명하니 참고로만 보세요.
따라 할 때 주의할 점은?
- 처음 '듣기' 명령은 모델 로딩에 20~40초가 걸립니다(README). 여러 번 부를 거면 MCP 서버나 파이썬 API로 모델을 띄워 두는 편이 빠릅니다.
- 브라우저는 키를 한 번 누르기 전엔 소리를 막습니다. 게임 첫 화면에서 소리가 안 나도 정상이에요.
- 내장 소리 ID만 고르는 것보다 "어떤 소리여야 하는지" 설명을 같이 주면, 클로드가 match · rank로 비교해 더 맞는 걸 고릅니다.
- earshot은 MIT 라이선스이고, 비교에 쓴 Kenney 소리는 CC0입니다. 다른 게임의 소리는 쓰지 않았어요.
한 번에 정리
- earshot = 클로드 대신 소리를 듣고 점수를 주는 오픈소스(CPU · 로컬 · MIT)
- 클로드 코드가 2분 48초 · 16턴 만에 효과음 3개를 녹음 없이 만들고, 2개는 들어 보고 다시 골랐음
- 게임에는 추락 · 재출발 · 가속 때 울리게 연결
- 판정기 점수: 진짜 녹음 0.91 · 코드로 만든 소리 0.75 — 판정기도 헷갈릴 만큼 그럴듯
출처: earshot https://github.com/Leonxlnx/earshot (README · LICENSE, 11월 20일 확인) · Kenney Impact Sounds https://kenney.nl (CC0) · 직접 시험 기록(2026-11-20, 1회).
영상으로 보기: AItoZ 유튜브 쇼츠 'AI로 게임 만들기, 이 효과음 진짜 녹음일까?'
