Secondvisitation783/claude-voice-system

claude-voice-system은(는) 무엇을 하나요?

edge-tts, 구문 풀, 우선순위 큐 및 반복 방지 처리를 통해 Claude Code에 자가 학습 음성 알림을 추가합니다.

개요

이 시스템은 Claude Code 작업 중 음성 알림을 제공하여, 사용자가 터미널을 직접 확인하지 않고도 작업 완료, 오류, 또는 중요한 이벤트를 인지할 수 있도록 합니다.

주요 기능

• edge-tts: Microsoft Edge의 텍스트-음성 변환 엔진을 사용하여 고품질 음성 출력
• 구문 풀: 다양한 알림 문구를 사전 정의하여 단조로움 방지
• 우선순위 큐: 중요 알림(예: 오류)을 일반 알림보다 먼저 처리
• 반복 방지: 동일한 메시지가 짧은 시간 내에 반복되지 않도록 관리
• 자가 학습: 사용자의 작업 패턴을 분석하여 알림 빈도와 내용을 최적화

설치 방법

1. edge-tts 설치:

   pip install edge-tts
   

2. Claude Code 설정에 추가:

   • ~/.claude/settings.json 파일에 다음 내용을 추가

   {
     "voice": {
       "enabled": true,
       "engine": "edge-tts",
       "language": "ko-KR",
       "voice": "ko-KR-SunHiNeural"
     }
   }
   

사용 예시

from claude_voice import VoiceNotifier

notifier = VoiceNotifier()
notifier.notify("작업이 완료되었습니다.", priority="high")

구성 옵션

옵션	설명	기본값
enabled	음성 알림 활성화 여부	false
engine	사용할 TTS 엔진 (edge-tts 또는 gtts)	edge-tts
language	음성 언어 코드	en-US
voice	사용할 음성 모델	시스템 기본값
min_interval	최소 알림 간격 (초)	10

참고 사항

• edge-tts는 인터넷 연결이 필요합니다.
• 음성 알림은 작업이 백그라운드에서 실행 중일 때 특히 유용합니다.
• 자가 학습 기능은 사용자의 명시적 동의 하에 데이터를 수집합니다.