CodeTalk: Claude Code CLI에 음성 반영 추가하는 오픈소스 도구

CodeTalk은 Claude Code CLI에 음성 반사 레이어를 추가하는 오픈소스 도구입니다. Claude가 코드나 분석을 생성할 때, 간단한 음성 관찰을 임베드하여 스피커를 통해 소리로 재생할 수 있습니다.

작동 방식

이 도구는 Stop 훅을 사용하여 Claude가 응답 끝에 인라인으로 임베드하는 텍스트를 추출합니다. 두 번째 LLM 호출은 없습니다 — 주요 모델이 언제 말할지 결정하고 텍스트를 직접 출력에 포함시킵니다. 추출된 텍스트는 Microsoft의 무료 신경망 TTS(edge-tts)를 통해 재생됩니다.

기술적 세부사항

총 3개 파일, 약 150줄의 Python 코드
자연스러운 음성(로봇 음성 아님)을 위해 Azure의 AndrewMultilingualNeural 음성 사용
API 키 불필요 — edge-tts와 Stop 훅만 필요
20-30%의 시간만 말함 — 기본값은 침묵으로 짜증을 피함

설정

pip install edge-tts
Stop 훅을 ~/.claude/settings.json에 추가
음성 지시사항을 프로젝트의 CLAUDE.md에 복사

응답 형식 예시

CodeTalk을 사용한 응답의 모습입니다:

데이터베이스 마이그레이션 분석입니다... [일반 응답 내용]
---
> *해당 테이블을 삭제하면 user_sessions의 외래 키 제약 조건도 
> 제거됩니다 — 아직 참조하는 것이 있는지 확인하는 것이 좋습니다.*

"---" 뒤의 텍스트가 TTS를 통해 소리로 재생됩니다.

사용 사례

Claude는 음성 레이어를 다음과 같이 사용합니다:

코드 결정에서 명확하지 않은 트레이드오프
작업 시작/완료 알림
프로젝트의 더 큰 그림과의 연결

개발자는 음성 동작에 대한 피드백을 구하고 있습니다 — 특히 얼마나 자주 말해야 하는지, 그리고 어떤 종류의 관찰이 실제로 유용한지 대신 짜증나는지에 대해요. 이 도구는 Claude Code(Opus)로 구축되었으며, 아키텍처, 코드, 음성 튜닝, 심지어 원본 Reddit 게시물까지 포함합니다.

📖 전체 소스 읽기: r/ClaudeAI