mbailey/voicemode

어떤 프로젝트인가요?

핵심 기능

• 01Claude Code 및 기타 MCP 에이전트에서 음성 입력과 음성 답변 지원
• 02Whisper.cpp를 사용한 로컬 음성-텍스트 변환 및 Kokoro를 사용한 텍스트-음성 변환
• 03OpenAI API를 통한 클라우드 대체 옵션
• 04무음 감지로 녹음 자동 종료
• 05디버깅을 위한 오디오 저장 옵션

활용 사례

• 걷거나 키보드 앞을 벗어나 있을 때 코딩 에이전트와 대화하기
• Whisper와 Kokoro를 로컬에서 실행해 음성 데이터를 기기에 보관하기
• 화면을 읽는 대신 에이전트의 출력을 음성으로 들으며 확인하기

빠른 시작

1. 1

   Claude Code에 VoiceMode 마켓플레이스를 추가합니다

   claude plugin marketplace add mbailey/voicemode
2. 2

   VoiceMode 플러그인을 설치합니다

   claude plugin install voicemode@voicemode
3. 3

   Claude Code 내에서 CLI와 로컬 음성 서비스를 설치합니다

   /voicemode:install
4. 4

   음성 대화를 시작합니다

   /voicemode:converse

사용 전 알아둘 점

• !마이크와 스피커가 정상적으로 작동하는 컴퓨터가 필요합니다.
• !클라우드 음성 서비스에는 OpenAI API 키가 필요합니다. 로컬 서비스를 사용하려면 ffmpeg와 PortAudio 같은 시스템 종속 항목을 포함한 추가 설정이 필요합니다.

토픽

자주 묻는 질문

voicemode은(는) 무엇인가요?

클라우드 또는 로컬 음성 서비스를 사용해 Claude Code 및 MCP를 지원하는 에이전트와 음성으로 대화할 수 있게 해주는 MCP 음성 레이어입니다. VoiceMode는 Model Context Protocol을 지원하는 Claude Code 및 다른 에이전트에 음성 입력과 출력을 추가합니다. 에이전트에게 말하면 답변을 음성으로 들을 수 있어, 걷거나 요리하는 등 손이나 눈을 쓰기 어려울 때도 작업을 이어갈 수 있습니다.

voicemode은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

voicemode은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

voicemode은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. voicemode의 마지막 커밋은 2026년 10월 17일입니다.

voicemode은(는) 어디에 사용할 수 있나요?

걷거나 키보드 앞을 벗어나 있을 때 코딩 에이전트와 대화하기 Whisper와 Kokoro를 로컬에서 실행해 음성 데이터를 기기에 보관하기 화면을 읽는 대신 에이전트의 출력을 음성으로 들으며 확인하기

voicemode는 어떻게 설치하나요?

Claude Code에 VoiceMode 마켓플레이스를 추가합니다: claude plugin marketplace add mbailey/voicemode VoiceMode 플러그인을 설치합니다: claude plugin install voicemode@voicemode Claude Code 내에서 CLI와 로컬 음성 서비스를 설치합니다: /voicemode:install 음성 대화를 시작합니다: /voicemode:converse

voicemode은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/mbailey/voicemode