Install
claude plugin marketplace add mbailey/voicemode
claude plugin install voicemode@voicemode누구에게 맞나
이미 Claude Code를 쓰고 있고, 손이 바쁘거나 타이핑이 불편할 때 자연 음성으로 대화를 이어가고 싶은 사람에게 맞다. 공식은 음성이 타이핑을 대체하려는 것이 아니라, 타이핑할 수 없을 때도 쓸 수 있게 한다고 적었다. 실제 음성 입출력을 받아들이고, 텍스트 메아리만으로는 부족한 사람에게 맞다.
플랫폼 발췌는 Linux, macOS, Windows(네이티브 또는 WSL), NixOS, Python 3.10-3.14를 다룬다. 현재 설명은 필수 마이크 모델, 스피커 요구, 클라우드 음성 서비스 강제 여부를 쓰지 않았다. Claude Code에 플러그인을 넣을 수 없거나 음성 관련 도구를 허용할 수 없다면 이 가이드는 도움이 되지 않는다.
3분 만에 첫 시도 끝내기
전제: Claude Code를 쓸 수 있고, Python이 3.10-3.14이며, 현재 환경에서 말하고 들을 수 있어야 한다. 공식 권장 경로는 마켓을 먼저 추가한 뒤 플러그인을 설치하는 것이다. 우회 MCP 명령부터 가지 말 것.
claude plugin marketplace add mbailey/voicemode
claude plugin install voicemode@voicemode
설치 후 Claude Code를 재시작하거나 다시 열고 플러그인이 나타났는지 확인한다. 첫 시도는 발췌가 지목한 mcp__voicemode__converse만 쓴다. 읽기 전용 조회가 아니다. 음성 대화에 들어가고, 로컬 오디오 장치를 쓸 수 있으며, 말한 내용을 에이전트에 넘긴다. 시작 전에 말할 수 있고, 들을 수 있으며, 이 대화가 모델에 처리되어도 괜찮은 환경인지 확인한 뒤 호출한다.
관찰 가능한 성공 신호: 대화가 음성으로 이어지는 것이지, 플러그인 설치 명령 자체의 성공이 아니다. 현재 설명은 "고정 테스트 단어를 말하라"거나 로그 키워드를 주지 않는다. 클라이언트가 권한 확인을 띄우면 허용 대상이 mcp__voicemode__converse인지 보고 동의한다. 첫 시도에서 mcp__voicemode__service를 호출하지 말 것. 발췌는 권한 목록에만 넣었고 무엇을 하는지는 설명하지 않았다.
자료에는 claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcher도 있으며 다른 설치 경로다. 첫 시도는 위의 플러그인 마켓만 타고, 입구를 두 개 동시에 맞추지 말 것.
사용 사례
사례 1: 옆에서 타이핑하기 어려울 때 mcp__voicemode__converse로 진행 중인 Claude Code 작업을 음성 왕복으로 바꾼다. 현재 설명은 "자연 음성 대화"만 보장하고 언어, 끼어들기, 노이즈 감소, 음성을 편집 가능한 초안으로 바꾸는 파라미터는 나열하지 않았다. 성공은 답을 알아듣고 다음 라운드를 이어갈 수 있는 기준이지, 특정 텍스트 로그가 아니다.
사례 2: 음성 능력을 명시적으로 허용해야 할 때 권한 목록에 mcp__voicemode__converse와 mcp__voicemode__service가 함께 나온다. 발췌는 service의 역할, 로컬 서비스를 바꾸는지, 실패 시 되돌리는 방법을 설명하지 않았다. 따라서 이 사례는 "목록대로 converse를 허용하고 service는 미설명으로 둔다"까지다. 서비스 재시작이나 시스템 데몬 설치 단계를 지어내지 말 것.
사용 경계
공식 페이지는
https://github.com/mbailey/voicemode
"네트워크 없음, 로컬 읽기 없음, 프라이버시 경계 없음"으로 이해하지 말 것. 음성 대화는 기본적으로 말한 내용을 수집한다. Python은 3.10-3.14여야 한다. 플랫폼 목록은 Linux, macOS, Windows(네이티브 또는 WSL), NixOS까지다. 발췌에는 제거, 마이크 끄기, 한 대화 철회 단계가 없다. service 도구는 권한 이름 외에 용법이 없다. 우회 uvx 시작 명령은 있지만 플러그인 마켓과 두 개의 주 경로로 겨루지 말 것. 할당량, 과금, 필수 클라우드 키는 쓰지 않았다.