Claude Code에 무료 음성을 입혀보세요 — 의외로 유용합니다
Give Claude Code a Free Voice — It’s Surprisingly Useful
핵심 요약
Claude Code가 작업을 마칠 때마다 로컬 TTS로 요약 내용을 들려주어 터미널을 계속 확인해야 하는 인지적 부담을 줄이는 방법을 공유합니다.
- Claude Code 활용 — 작업 완료 후 음성 요약으로 터미널 확인 빈도를 줄임
- 로컬 TTS 구현 — Kokoro-82M을 사용하여 API 비용 없이 로컬에서 실행함
- 인지 부하 감소 — 시각적 정보 대신 청각적 요약으로 상황 파악이 쉬워짐
- 주의 사항 — 음성 요약은 상황 파악용이며 코드 검토를 대체할 수는 없음
Claude Code 쓰다 보면 제일 피곤한 게 뭔지 아냐? 계속 따라가면서 확인하는 거다.
파일 읽고, 코드 수정하고, 테스트 돌리고, 문제 고치고 나면 터미널에 출력되는 텍스트 뭉치를 일일이 다 읽고 다음엔 뭘 할지 결정해야 하거든. 에이전트 몇 개 더 붙이거나 병렬 작업 돌리기 시작하면 뇌 과부하 걸리는 건 순식간이다.
그래서 난 Claude한테 방금 뭘 했는지 직접 말하게 바꿨다.
의미 있는 작업이 끝날 때마다 Claude가 짧은 영어 요약문을 쓰게 만들었거든. 그걸 로컬 스크립트가 음성으로 변환해서 백그라운드에서 재생해 주는 방식이다.
대충 이런 식이지:
“Done. The login issue was caused by the refresh token expiring too early. I fixed the refresh logic, added a regression test, and everything passes.”
보통 20초도 안 걸린다.
별거 아닌 것 같지? 근데 한 달 정도 매일 써보니까 Claude Code 쓸 때 머리 쓰는 부담이 확 줄어들더라. 상황 파악하려고 계속 터미널 창으로 눈 돌릴 필요가 없어졌거든.
물론 주의할 점은 있다. 음성 요약이 코드 리뷰를 대신하게 두지는 마라. 이건 어디까지나 상황 파악용이지 검증용이 아니니까. 그리고 Claude가 너무 쉴 새 없이 떠들게 하지도 마라. 시각적 공해를 청각적 공해로 바꾸는 꼴밖에 안 되니까.
무료 TTS 엔진은 Kokoro를 쓴다. 로컬에서 돌아가니까 API 키도 필요 없고 비용도 안 든다. 난 kokoro-onnx를 써서 Torch도 필요 없다. 현재 API는 Kokoro(...).create(text, voice=..., speed=..., lang=...)를 지원한다.
Notes in comments,
