Mac에서 Claude Code에 음성으로 받아쓰는 방법

Claude Code에는 내장 음성 모드가 있다 — 여기서 멈춘다

Claude Code에는 /voice 모드가 있습니다. 대화형 세션에서 실행하고, 말할 때 키를 누르고 있다가 떼면 프롬프트가 모델로 전송됩니다. 타이핑 없이 지시를 받아쓰게 하는 기분 좋은 방법이고, 내장이라 설치할 것도 없습니다. 다만 두 가지 한계가 있습니다. 첫째, 푸시투토크입니다 — 말하는 내내 키를 누르고 있어야 해서 진짜 핸즈프리는 아닙니다. 손을 키보드에 두고 싶거나 등을 기대고 그냥 말하고 싶은 순간, 누르고 있는 것과 씨름하게 됩니다. 둘째, Claude Code 터미널 세션 안에서만 살아 있고 다른 어디에도 없습니다. 프롬프트는 코딩 세션의 아마 5분의 1입니다. 커밋 메시지, 풀 리퀘스트 설명, 답하는 GitHub issue, 리뷰어가 질문하는 Slack 스레드 — 그 중 하나를 위해 터미널을 벗어나는 순간 /voice는 도움이 못 되고 다시 타이핑으로 돌아갑니다.

웨이크 워드를 「Claude」로 두고 Fast 모드로 돌린다

바로 이 설정이 모든 걸 네이티브처럼 느끼게 합니다. 시스템 전역 받아쓰기 앱은 웨이크 워드를 앱별로 설정하게 해 주므로, Claude Code에는 모델 자신의 이름인 「Claude」로 설정합니다. 이제 받아쓰기 도구를 부르는 게 아니라 모델에게 말을 겁니다. 「Claude, 이 컴포넌트에 로딩 상태 추가하고 에러 케이스 처리해 줘」라고 하면, 손이 키보드를 떠나지 않은 채로 말이 프롬프트 입력란에 떨어집니다. 나머지 절반은 속도입니다. 폴리싱 레벨을 Fast로 두면 AI 정리가 완전히 꺼집니다. 받아쓴 글이 즉시, 말한 그대로, 서버 왕복 없이 붙습니다. 프롬프트에는 이게 중요합니다 — 프롬프트는 다듬을 필요가 없고, 당신의 문자 그대로의 지시가 빠르게 모델에 닿기를 원하니까요. 대부분의 받아쓰기 앱은 그 정리를 항상 돌려서 여기서는 필요 없는 지연을 더합니다. Fast 모드는 그걸 건너뜁니다 — 받아쓰기로는 거의 최고 속도입니다. 스택의 개인 사전을 두면(프레임워크 이름, CLI 도구, 레포 이름) 「useEffect」「kubectl」「clavio-backend」가 그대로 통합니다. 그리고 완전한 핸즈프리 흐름을 위해 자동 전송은 켜 두세요 — 말을 멈추는 순간 프롬프트가 알아서 전송되므로 키를 전혀 건드리지 않습니다. Fast는 한 글자 그대로 붙이므로 모델에는 당신이 말한 그대로 닿습니다.

토큰을 아끼나요? 폴리싱을 압축기로 바꾸세요

다른 목적을 위한 두 번째 설정이 있습니다. 토큰 예산을 신경 쓴다면 — 긴 에이전트 세션은 쌓입니다 — Fast의 반대를 해서 AI가 당신을 위해 일하게 할 수 있습니다. 폴리싱은 앱별로 커스터마이즈되므로, 당신의 말을 다듬는 게 아니라 압축하는 커스텀 폴리싱 지시를 Claude Code에 줄 수 있습니다. 주절주절 말한 것을 같은 지시의 가장 짧고 명확한 버전으로 다시 씁니다. 당신은 느슨하고 길게 말하고, 모델에 닿는 것은 촘촘하고 토큰이 절약된 형태입니다. 이건 진짜 트레이드오프이고, 당신은 중요한 쪽 끝을 고릅니다. Fast는 가장 빠르고 가장 충실하지만 말한 걸 전부 보내고, 압축 폴리싱은 왕복 한 번을 대가로 프롬프트가 모델에 닿기 전에 쳐냅니다. 둘 다 같은 앱별 설정에 살고 — 한쪽 끝엔 속도, 다른 쪽엔 토큰 효율, 당신은 일하는 방식에 맞춰 고릅니다.

흐름 전체에 하나의 음성: 커밋, PR, Slack

프롬프트는 시작이지 끝이 아닙니다 — 그리고 그것이 터미널 내장 음성 대신 시스템 전역 앱을 쓰는 진짜 이유입니다. Claude Code가 변경을 만든 뒤, 커밋 메시지를 곧장 git 도구에 받아쓰세요. 풀 리퀘스트를 쓰나요? 설명을 — 무엇이 바뀌었고, 왜, 어떻게 테스트하는지 — 받아쓰는데, 여기서는 자연스러운 톤을 원하므로 터미널은 Fast로 두고 이 컨텍스트는 폴리싱으로 설정합니다. 리뷰어가 Slack으로 핑을 보냅니다. 창을 바꿔 캐주얼한 톤으로 핸즈프리로 답합니다. 톤과 폴리싱은 앱별로 기억되므로, 같은 음성이 Claude Code 입력란에서는 날것 그대로 즉시, PR 본문에서는 정돈되어, 채팅에서는 편안하게 나옵니다. 중간에 전환할 게 없습니다. 웨이크 워드는 기기 내 성문으로 보호되어, 옆에서 말하는 동료나 스피커로 걸려 온 통화가 세션 도중에 이를 실행시키지 않습니다. 핸즈프리 바이브 코딩의 실제 모습이 이렇습니다. Claude Code를 몰고, 변경을 배포하고, 그 주변의 모든 것을 음성으로 씁니다 — 한 번도 타이핑으로 끊기지 않고.

Claude Code를 위한 Clavio 권장 설정