Claude Code 음성 모드, 한국어로 안 된다고요?
“영어 전용”이라는 말이 돌고 있습니다. 공식 문서에도 그렇게 나와 있습니다. 그런데 2026년 3월 14일 이후로 상황이 달라졌습니다. 정확히 무엇이 바뀌었는지, 그리고 여전히 막히는 부분이 어디인지 공식 GitHub 이슈와 changelog를 직접 확인했습니다.
음성 모드가 뭔지부터 짚고 가겠습니다
Claude Code 음성 모드는 터미널에서 /voice를 입력하면 활성화됩니다. 그 이후부터는 타이핑 대신 말로 명령을 내릴 수 있습니다. “인증 미들웨어 리팩토링해 줘”, “이 함수 테스트 코드 만들어 줘”처럼 구어체로 말하면 Claude Code가 이를 텍스트로 변환해 바로 실행합니다.
2026년 3월 3일, Anthropic 엔지니어 타리크 시히파르(Thariq Shihipar)가 X(구 트위터)를 통해 단계적 출시를 공식 발표했습니다. 당시 전체 사용자의 약 5%에게 먼저 제공됐고, 이후 수 주에 걸쳐 Pro·Max·Team·Enterprise 전체로 확대됐습니다. (출처: ZDNet Korea, 2026.03.04)
이 기능이 주목받은 이유는 단순히 ‘말로 시킬 수 있다’는 편의성만이 아닙니다. 일반 받아쓰기(dictation)와 달리 코딩 워크플로우에 맞게 최적화된 실시간 스트리밍 전사(transcription) 엔진을 씁니다. 코드 변수명이나 메서드 이름처럼 발음하기 어색한 표현도 더 정확하게 잡아낸다는 점이 차별점이었습니다. (출처: Tari Ibaba, Medium, 2026.03.06)
기능 구조는 두 가지입니다. 조용한 환경에서는 자연스러운 말의 정지를 감지하는 핸즈프리 모드, 시끄러운 환경이나 배경 소음이 있을 때는 스페이스바를 누르는 동안만 녹음하는 푸시투톡 모드입니다. 전환은 음성 모드 안에서 바로 됩니다. (출처: Anthropic 공식 지원 문서, support.claude.com)
공식 문서에 “영어 전용”이라고 쓰여 있습니다 — 그런데
Anthropic 공식 지원 페이지에는 이렇게 명시돼 있습니다.
“음성 모드는 현재 영어로만 사용 가능합니다.” (출처: Anthropic 공식 지원 문서, support.claude.com/ko)
그러니 “Claude Code 음성 모드는 한국어 안 됩니다”라는 말이 퍼진 건 당연합니다. 공식 문서에 딱 그렇게 나오니까요.
💡 공식 발표문과 실제 업데이트 흐름을 같이 놓고 보니 이런 차이가 보였습니다
음성 모드 자체의 인터페이스 언어는 여전히 영어입니다. 그런데 음성 입력(STT, 음성→텍스트 변환)의 언어 설정은 2026년 3월 14일 v2.1.76 업데이트에서 별도로 추가됐습니다. 같은 “언어” 이야기를 하고 있지만, 가리키는 레이어가 다릅니다.
Claude 일반 채팅 앱은 인터페이스 언어로 한국어 포함 11개 언어를 지원합니다(영어·프랑스어·독일어·힌디어·인도네시아어·이탈리아어·일본어·한국어·브라질 포르투갈어·라틴아메리카 스페인어·스페인 스페인어). (출처: Anthropic 공식 지원 문서, support.claude.com/en) 그런데 Claude Code 음성 모드는 출시 초기에 이 언어 설정 자체를 음성 입력에 연동하지 않았습니다. 말하자면 기능을 먼저 내보내고, 다국어 설정은 나중에 붙인 셈입니다.
이 점이 중요한 이유는 이렇습니다. 공식 지원 페이지의 문구는 출시 시점 기준으로 작성됐고, 그 이후 업데이트 내용이 즉시 반영되지 않는 경우가 있습니다. changelog와 GitHub 이슈를 함께 봐야 실제 현황을 파악할 수 있습니다.
v2.1.76이 바꾼 것과 바꾸지 못한 것
Claude Code 공식 changelog에는 v2.1.76 이후 이런 내용이 포함됩니다.
“Improved /voice to show your dictation language on enable and warn when your language setting isn’t supported for voice input.” (출처: Claude Code 공식 changelog, code.claude.com/docs/en/changelog)
즉, /config에서 언어를 한국어로 설정하면, 음성 입력 시 이 설정이 STT 엔진에 전달됩니다. 설정 방법은 다음 섹션에서 정리합니다.
그런데 이게 “한국어 음성 모드 완벽 지원”을 의미하는 건 아닙니다. GitHub 이슈 #33042(2026.03.10 등록)에는 Mac에서 Claude Code Max 구독자가 직접 보고한 내용이 있습니다.
⚠️ 실사용자가 보고한 두 가지 문제
- 한국어 음성 인식 정확도가 영어보다 낮습니다. 전사 오류가 자주 발생하고, 한국어 단어가 영어 혼합 텍스트로 변환되는 경우가 있습니다.
/voice --send플래그가 한국어 상황에서 작동하지 않습니다. 녹음 종료 후 자동 전송이 안 되고 수동으로 Enter를 눌러야 합니다. 손 없이 쓰겠다는 음성 모드의 핵심 편의성이 무너집니다.
(출처: GitHub anthropics/claude-code issue #33042, 2026.03.10)
이 두 가지는 현재까지 공식 수정 완료가 공지되지 않았습니다. 한국어로 음성 입력 설정은 가능해졌지만, 실제 인식 품질은 영어 대비 체감 차이가 있습니다. 이 부분을 넘어서 “한국어 완전 지원됐다”고 소개하면 실망하게 됩니다.
한국어로 음성 모드 켜는 실제 방법
Claude Code v2.1.76 이상 기준으로, 다음 순서로 진행합니다. (출처: GitHub anthropics/claude-code issue #31724, 2026.03.06 / 2026.03.14 업데이트 확인)
방법 1 — /config 명령어 사용 (권장)
# 터미널에서 Claude Code 실행 후
/config set language ko
# 음성 모드 켜기
/voice
/voice를 켤 때 화면 상단에 현재 설정된 음성 입력 언어가 표시됩니다. “ko”가 보이면 한국어 STT 모드로 진입한 겁니다. 이 표시가 v2.1.76에서 추가된 시각적 확인 기능입니다.
방법 2 — settings.json 직접 수정
# ~/.claude/settings.json 파일에 아래 추가
{
"language": "ko",
"voiceEnabled": true
}
GitHub 이슈 #33170(2026.03.11)에서 확인된 방법입니다. (출처: GitHub anthropics/claude-code issue #33170) ~/.claude/settings.json에 직접 언어 코드를 넣는 방식이며, /config로 설정한 것과 동일하게 적용됩니다.
💡 설정 전후 흐름을 같이 놓고 보니 이런 차이가 있었습니다
설정 전 기본 상태에서는 한국어로 말해도 STT 엔진이 영어로 강제 인식합니다. 설정 후에는 한국어 인식을 시도하지만, 전사 정확도는 영어 대비 낮습니다. 설정 자체와 품질은 별개 문제입니다.
버전 확인은 claude --version으로 할 수 있습니다. v2.1.76 미만이라면 npm update -g @anthropic-ai/claude-code 로 업데이트합니다.
추가 비용 없다는 말이 사실인 조건
음성 모드 출시 직후 가장 많이 나온 질문이 “음성 쓰면 토큰 더 나가냐”였습니다. Anthropic의 공식 입장은 이렇습니다.
“음성 모드를 사용해도 추가 비용이 들지 않고, 음성 받아쓰기에 사용되는 토큰은 요율 제한에 포함되지 않습니다.” (출처: Reddit r/ClaudeAI, Anthropic 공식 발표 인용, 2026.03.03)
이 말은 음성 입력(STT) 자체에는 토큰 비용이 붙지 않는다는 뜻입니다. 그런데 여기에 조건이 있습니다. 음성을 텍스트로 변환한 결과물이 Claude Code에 전달돼 실행되는 순간부터는 일반 텍스트 프롬프트와 동일하게 토큰이 카운트됩니다.
즉, “30초 동안 말로 설명했더니 텍스트 500자가 생성됐고 그게 Claude Code로 전달됐다”면, 그 500자에 해당하는 입력 토큰은 소비됩니다. STT 변환 과정 자체가 무료인 것이지, 이후 LLM 처리 비용까지 면제되는 게 아닙니다. Pro·Max 요금제에서는 사용량 한도 안에서 무료입니다.
| 항목 | 요금 발생 여부 | 비고 |
|---|---|---|
| STT 음성 변환 자체 | 없음 | 요율 제한에도 미포함 |
| 변환된 텍스트의 LLM 처리 | 일반과 동일 | 입력 토큰 소비 |
| 요금제별 사용 가능 여부 | Pro·Max·Team·Enterprise | Free 요금제 불가 |
Free 요금제에서는 음성 모드 자체가 비활성화됩니다. Pro 이상에서만 사용 가능하다는 점이 중요합니다. “무료로 쓸 수 있다”는 말이 돌지만, 이건 유료 구독 안에서 추가 비용 없이 쓸 수 있다는 의미입니다.
실무에서 쓸 만한 경우와 아직 이른 경우
솔직히 말하면, 지금 시점에서 Claude Code 음성 모드를 한국어 개발자가 업무 메인으로 쓰기에는 무리가 있습니다. 하지만 영어로 명령을 내리는 상황이라면 이야기가 다릅니다.
✅ 지금 써볼 만한 경우
명령 자체를 영어로 내리면 인식 정확도가 훨씬 높습니다. “refactor the authentication middleware”, “add unit tests for this function” 같은 코딩 명령은 영어가 자연스럽기도 합니다. 한국어 개발자도 코드 관련 영어 표현에 익숙한 경우가 많아서, 이 조합은 실무에서 바로 쓸 만합니다. 인식된 텍스트를 실행하기 전 수정할 수 있으므로 오인식 리스크도 줄일 수 있습니다.
두 번째로, 긴 문맥 설명이 필요할 때 말이 타이핑보다 빠릅니다. “이 컴포넌트가 props로 사용자 ID를 받아서 API 호출하고 로딩 상태와 에러 상태를 각각 다르게 표시해야 해”처럼 긴 설명을 음성으로 전달하면 시간을 아낄 수 있습니다. Anthropic은 2026년 2월 기준 Claude Code 연간 반복 수익(ARR)이 25억 달러를 넘어섰고, 주간 활성 사용자 수가 1월 이후 두 배로 늘었다고 밝혔습니다. (출처: ZDNet Korea, 2026.03.04) 사용자가 급증한 배경에 이런 생산성 도구 확장이 있습니다.
❌ 아직 이른 경우
한국어 음성으로 코딩 지시를 내리고 자동 실행까지 원하는 경우는 현재 두 가지 이유로 불안합니다. STT 오인식 확률이 높아 의도치 않은 명령이 실행될 수 있고, --send 플래그의 자동 전송 버그도 아직 수정 완료가 공지되지 않았습니다. (출처: GitHub anthropics/claude-code issue #33042, 2026.03.10) 중요한 코드베이스에서 자동 실행 설정은 현 시점에서 권장하지 않습니다.
시끄러운 환경에서 핸즈프리 모드로 한국어를 쓰는 경우도 이른 편입니다. 배경 소음 + 한국어 인식 정확도 이슈가 겹치면 전사 품질이 크게 떨어집니다. 조용한 환경 + 영어 명령 조합이 현재로서 가장 안정적입니다.
Q&A
마치며
Claude Code 음성 모드를 한 문장으로 정리하면, “설정은 가능해졌지만 품질은 아직 진행 중”입니다. “영어 전용”이라는 말이 퍼진 건 맞지만, v2.1.76 이후로는 정확하지 않은 표현이 됐습니다. 그렇다고 “한국어 완전 지원됐다”는 말도 맞지 않습니다.
현재 가장 현실적인 활용법은 영어 명령 + 한국어 문맥 설명의 혼용입니다. 코드 관련 동작은 영어로, 긴 배경 설명은 한국어로 말하는 방식입니다. 인식 정확도가 확보되는 조합을 찾는 것이 지금 단계에서 가장 실용적입니다.
GitHub 이슈 #33042(한국어 인식 품질)는 Anthropic이 인지하고 있는 상태입니다. 후속 업데이트에서 수정이 이뤄질 가능성이 높습니다. changelog를 주기적으로 확인하면서 쓰는 게 좋습니다. (출처: code.claude.com/docs/en/changelog)
📚 본 포스팅 참고 자료
- Anthropic 공식 지원 문서 — 음성 모드 사용 (한국어)
https://support.claude.com/ko/articles/11101966 - Anthropic 공식 지원 문서 — Claude 언어 설정 (영문)
https://support.claude.com/en/articles/10769299 - Claude Code 공식 Changelog
https://code.claude.com/docs/en/changelog - GitHub anthropics/claude-code Issue #31724 — voiceLanguage 설정 요청 및 v2.1.76 해결 확인
https://github.com/anthropics/claude-code/issues/31724 - GitHub anthropics/claude-code Issue #33042 — 한국어 음성 인식 품질 및 –send 버그 보고
https://github.com/anthropics/claude-code/issues/33042 - ZDNet Korea — 앤트로픽 클로드 코드 음성 모드 도입 보도 (2026.03.04)
https://zdnet.co.kr/view/?no=20260304215307
※ 본 포스팅은 2026년 3월 31일 기준으로 작성됐습니다. Claude Code는 지속적으로 업데이트되는 서비스로, 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. 최신 정보는 공식 changelog 및 지원 문서에서 확인하세요.
댓글 남기기