Claude Code
Claude Code 음성 모드 써봤습니다 — 한국어가 문제입니다
결론부터 말씀드리면, 음성 변환 토큰은 요금제 한도에 카운트되지 않습니다. 그런데 한국어 인식 정확도는 GitHub 공식 이슈로 등록될 만큼 낮습니다. 어디서 막히는지, 어떤 환경에서는 아예 작동하지 않는지 공식 Changelog와 실사용 데이터를 바탕으로 정리했습니다.
음성 모드가 3월에 갑자기 나온 이유
Claude Code 음성 모드는 2026년 3월 3일 Anthropic 엔지니어 Thariq Shihipar가 X(트위터)를 통해 처음 공개했습니다. 당일 전체 사용자의 약 5%에게만 점진적으로 배포됐고, 이후 3월 내내 버전 업데이트마다 관련 패치가 이어졌습니다. (출처: TechCrunch, 2026.03.03)
같은 시기 Claude Code의 연매출 런레이트는 $25억을 돌파했고, 주간 활성 사용자는 2026년 1월 이후 2배로 늘었습니다. (출처: Anthropic 공식 발표, TechCrunch 보도) Anthropic이 단순 채팅 앱이 아닌 코딩 터미널 도구에 음성을 붙인 건 — 경쟁사인 Cursor와 GitHub Copilot을 겨냥한 의도적인 이동입니다.
처음엔 “ChatGPT처럼 목소리로 대화하는 기능이 생겼구나”라고 생각하기 쉬운데, 막상 써보면 다릅니다. 이 점이 가장 중요한 부분입니다.
Claude Code 음성 모드 작동 방식 — 생각보다 단순합니다
활성화 방법은 터미널에서 /voice를 입력하는 것입니다. 이후 스페이스바를 누른 채로 말하고, 손을 떼면 전송됩니다. Push-to-Talk 방식입니다. 24시간 열려 있는 마이크가 아닙니다.
이게 핵심입니다. Claude가 음성으로 답하지 않습니다. 사람의 말을 텍스트로 변환해 커서 위치에 삽입할 뿐이고, Claude의 응답은 여전히 텍스트로 출력됩니다. Reddit에서는 이 점에 실망한 사용자가 많았습니다. “STT(음성→텍스트)만 되는 것”이라는 게 공개 직후 커뮤니티 자동 요약에서도 가장 먼저 정리된 내용입니다. (출처: Reddit r/ClaudeAI 자동 요약, 2026.03.03)
💡 공식 발표문과 실제 사용 흐름을 같이 놓고 보니 이런 차이가 보였습니다
텍스트를 반쯤 입력한 뒤 복잡한 요구사항을 말로 채우고, 다시 입력으로 마무리하는 “하이브리드 방식”이 실제로 가장 유용한 사용법입니다. 말이 커서 위치에 삽입되기 때문에 기존 입력이 지워지지 않습니다. 이 점이 기존 OS 받아쓰기와 다른 핵심 차이입니다.
음성 모드는 Pro, Max, Team, Enterprise 플랜에서 사용 가능합니다. (출처: Claude Code Changelog v2.1.75, 2026.03.13) Free 플랜은 해당되지 않습니다.
토큰도 안 쓰인다는 게 사실인지 확인했습니다
막연히 “음성 쓰면 토큰 더 나가겠지”라고 생각하기 쉬운데, 공식 발표는 정반대입니다. Anthropic 엔지니어가 직접 공개한 내용에 따르면, 음성 변환에 사용되는 토큰은 요금제 사용량에 카운트되지 않고 추가 비용도 없습니다. (출처: Thariq Shihipar, X 공식 발표, 2026.03.03)
| 항목 | 요금제 한도 차감? | 추가 요금? |
|---|---|---|
| 음성 → 텍스트 변환 토큰 | ❌ 차감 안 됨 | ❌ 없음 |
| 변환된 텍스트를 Claude가 처리하는 토큰 | ✅ 차감됨 | 기존 요금과 동일 |
| 1M 컨텍스트 사용 (Max·Team·Enterprise) | 플랜 포함 | ❌ 없음 |
말을 텍스트로 바꾸는 과정 자체는 무료입니다. 하지만 그 텍스트를 Claude가 읽고 처리하는 토큰은 여전히 요금제 한도에서 차감됩니다. 두 가지를 구분해야 합니다. 말을 길게 할수록 Claude에게 전달되는 프롬프트 토큰이 늘어나므로, 요약해서 말하는 게 여전히 유리합니다.
추가로, 2026년 3월 13일 v2.1.75 업데이트에서 Max·Team·Enterprise 플랜에 100만 토큰 컨텍스트가 기본 제공됩니다. (출처: Claude Code Changelog v2.1.75) 이 컨텍스트 확장도 추가 비용 없이 포함된 변화입니다. 긴 코드베이스를 다루면서 동시에 음성으로 지시하는 시나리오가 한층 현실적이 됐습니다.
한국어가 왜 잘 안 되는지, 공식 이슈에 답 있습니다
Claude Code는 공식적으로 20개 언어를 지원한다고 발표했습니다. (출처: APIYI 기술팀 분석, 2026.03) 한국어도 목록에 포함돼 있습니다. 그런데 막상 써보면 다릅니다.
GitHub 공식 이슈 #33042 — 2026.03.10 등록
“/voice 모드에서 한국어로 말하면 인식 정확도가 영어보다 현저히 낮습니다. 변환 결과에 오류가 잦거나 말한 내용이 제대로 포착되지 않습니다.” — Claude Code Max 사용자, macOS 환경 보고
이 이슈는 아직 Closed 처리되지 않았습니다. Anthropic이 공식 답변을 내놓지 않은 부분입니다. 음성 인식 처리는 서버 측 WebSocket을 통해 이루어지는데, v2.1.80에서 “Cloudflare 봇 감지로 인한 WebSocket 실패” 버그가 수정된 게 눈에 띕니다. 서버 경로 자체의 안정성이 기본 품질에 영향을 줄 수 있다는 뜻입니다. (출처: Claude Code Changelog v2.1.80, 2026.03.19)
💡 지원 언어 20개와 실제 인식 품질은 별개입니다
지원 목록에 이름이 올라간 것과, 실제로 정확하게 인식하는 것은 다릅니다. 영어 중심으로 학습된 STT 모델은 비영어권 발음, 특히 억양이 다른 언어에서 성능 차이가 크게 나타납니다. Parakeet(25개 언어 지원)과 Whisper(99개 언어 지원) 비교에서도, Whisper가 비영어 환경에서 더 강한 이유로 “맥락 이해”와 “소음 내성”이 꼽힙니다. (출처: Reddit r/ClaudeAI 사용자 비교 논의)
코드 관련 용어도 문제입니다. “OAuth”, “regex”, “JSON” 같은 기술 단어는 영어 발음 기준으로 학습된 경우가 많습니다. 한국어로 “제이슨 파싱”이라고 말할 때 올바르게 “JSON”으로 변환되는지는 아직 이유가 공개되지 않은 상태입니다. v2.1.72 업데이트에서 “repo 이름, regex, OAuth, JSON 같은 개발 용어 음성 입력 정확도 개선”이 공식적으로 언급됐지만 이건 영어 발음 기준이었습니다. (출처: Claude Code Changelog v2.1.72, 2026.03.10)
이 환경에서는 Claude Code 음성 모드가 아예 켜지지 않습니다
공식 Changelog를 읽으면 생각보다 많은 환경에서 음성 모드가 막힌다는 걸 알 수 있습니다. 이 부분을 모르고 설정부터 건드리면 시간을 낭비합니다.
| 환경 | 상태 | 근거 (버전) |
|---|---|---|
| Docker 컨테이너 (오디오 하드웨어 없음) | ❌ 불가 | v2.1.83, 2026.03.25 |
| WSL1 (Windows 10 환경) | ❌ 불가 | v2.1.83, 2026.03.25 |
| 헤드리스 서버 (GUI 없는 서버) | ❌ 불가 | v2.1.83, 2026.03.25 |
| WSL2 (Windows 11 WSLg 포함) | ✅ 가능 (v2.1.78 패치 후) | v2.1.78, 2026.03.17 |
| SSH 원격 세션 | ❌ 제한됨 | 커뮤니티 보고 |
| Termux/Android | ⚠️ v2.1.83 패치 중 | v2.1.83, 2026.03.25 |
| macOS 네이티브 터미널 | ✅ 정상 작동 | v2.1.83 기준 |
Docker 컨테이너 안에서 개발하는 분들이 많습니다. 이 경우 오디오 하드웨어가 없어서 ALSA 라이브러리 오류가 터미널 UI를 깨트리는 버그가 v2.1.83에서 수정됐습니다. (출처: Claude Code Changelog v2.1.83, 2026.03.25) 수정됐다는 건 “오류 메시지를 더 명확하게 보여준다”는 것이지, Docker에서 음성을 쓸 수 있게 됐다는 뜻이 아닙니다.
또한, /voice 명령어 자체가 인증 방식이나 플랜에 따라 메뉴에서 아예 숨겨지도록 v2.1.84에서 변경됐습니다. 접근 권한이 없는 환경에서는 슬래시 명령 목록 자체에 표시되지 않습니다. (출처: Claude Code Changelog v2.1.84, 2026.03.26)
기존 받아쓰기 앱과 실제로 뭐가 다른가
Reddit에서 가장 많이 나온 질문이 이겁니다. “macOS 기본 받아쓰기(Fn+Fn)랑 뭐가 다른 거야?” 결론은 주요한 차이가 있고, 동시에 한계도 있습니다.
💡 이 기능을 “단순 받아쓰기”로 보면 놓치는 게 있습니다
Claude Code 음성 모드는 텍스트를 커서 위치에 스트리밍 방식으로 삽입합니다. 기존 입력이 지워지지 않고, 타이핑을 반쯤 하다가 말로 이어갈 수 있습니다. macOS 기본 받아쓰기는 이렇게 되지 않습니다.
| 비교 항목 | Claude Code 음성 모드 | Wispr Flow / SuperWhisper |
|---|---|---|
| 작동 범위 | Claude Code 내부만 | 모든 앱 사용 가능 |
| 추가 비용 | 무료 | 유료 구독 필요 |
| 커서 위치 삽입 | ✅ 지원 | 앱에 따라 다름 |
| 한국어 인식 품질 | 낮음 (공식 이슈 존재) | 모델 선택에 따라 다름 |
| Claude 답변 음성 출력 | ❌ 불가 | TTS 연동 가능 |
솔직히 말하면, 한국어로 코딩 지시를 해야 하는 상황이라면 지금 당장은 Whisper 계열 로컬 모델을 Claude Code에 붙이는 방법이 더 정확합니다. 커뮤니티에서 이미 “VoiceMode MCP + 로컬 Whisper STT”로 구성한 사례가 있고 (출처: Medium, 2026.01.01), 이 방식은 클라우드 API가 필요 없어 프라이버시 면에서도 낫습니다.
단, 영어로 주로 작업하는 분이라면 Claude Code 내장 음성 모드가 훨씬 빠릅니다. 별도 설치 없이 Pro 구독 안에 포함돼 있고, 무엇보다 커서 위치 삽입이 된다는 점이 실제 개발 워크플로우에서 유용합니다.
Q&A
Q. /voice 입력하면 바로 됩니까, 아니면 설정이 더 필요합니까?
Pro 플랜 이상이면 /voice만 입력하면 됩니다. 단, 처음 실행할 때 macOS에서 마이크 접근 권한을 요청합니다. 이걸 허용하지 않으면 음성이 잡히지 않습니다. v2.1.74 이전 버전에서는 이 권한 요청이 나타나지 않고 조용히 실패하는 버그가 있었는데 수정됐습니다. (출처: Changelog v2.1.74, 2026.03.12)
Q. /voice –send 옵션을 쓰면 말하고 나서 자동으로 전송됩니까?
현재 GitHub 이슈로 등록된 버그가 있습니다. --send 플래그를 써도 자동 전송이 되지 않고 수동으로 Enter를 눌러야 합니다. 이유는 아직 공개되지 않았습니다. (출처: GitHub anthropics/claude-code Issues #33042, 2026.03.10)
Q. Claude가 음성으로 답변해 주는 건가요?
아닙니다. Claude Code 음성 모드는 말 → 텍스트 방향만 지원합니다. Claude의 답변은 여전히 텍스트로만 출력됩니다. ChatGPT의 고급 음성 모드처럼 양방향 음성 대화는 현재 Claude Code에서 공식 지원하지 않습니다.
Q. 음성으로 말한 내용이 Anthropic 서버에 저장됩니까?
음성 변환은 WebSocket을 통해 서버 측에서 처리됩니다. Anthropic이 음성 데이터 보존 정책을 별도로 공개하지 않은 상태입니다. Reddit에서 “음성 데이터를 학습에 쓰거나 외부 업체에 넘기지 않는다는 확인이 없다”는 우려도 나왔습니다. 민감한 프로젝트라면 로컬 Whisper 방식을 검토하는 게 낫습니다.
Q. Free 플랜에서는 언제쯤 쓸 수 있게 됩니까?
공식적으로 Free 플랜 지원 일정은 공개된 바 없습니다. 현재는 Pro, Max, Team, Enterprise 플랜에만 제공됩니다. (출처: Changelog v2.1.75, 2026.03.13)
마치며
Claude Code 음성 모드는 무료인데다 한도도 차감하지 않는다는 점에서 분명히 괜찮은 추가 기능입니다. 하지만 지금 시점(2026년 3월)에서 한국어를 주로 쓰는 개발자라면 제한이 큽니다. GitHub 이슈로 등록될 만큼 인식 품질이 낮다는 건, 공식이 인정한 것이나 다름없습니다.
영어 개발 환경에서 주로 작업하고 macOS를 쓴다면, 쓸 만한 수준입니다. 타이핑 중간에 말로 요구사항을 채우는 “하이브리드 입력”이 실제로 유용하게 느껴지는 순간이 있습니다. 특히 아이디어를 빠르게 던지고 싶을 때는 생각보다 자연스럽습니다.
Docker나 WSL1, SSH 환경이 주 작업 공간이라면 지금은 적용 대상이 아닙니다. 버전 업데이트를 지켜보면서 환경이 지원되는 시점에 다시 시도해 보는 게 맞습니다. Changelog는 거의 주 단위로 업데이트되고 있습니다.
📚 본 포스팅 참고 자료
본 포스팅은 2026년 3월 27일 기준으로 작성됐습니다. Claude Code v2.1.81~v2.1.85 Changelog 및 공개 자료를 참조했습니다. 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. 음성 모드 지원 언어, 요금 정책, 작동 환경은 Anthropic의 업데이트에 따라 달라질 수 있으니 최신 공식 문서에서 확인하시기 바랍니다.
댓글 남기기