Claude Code 음성 입력이 안 되나요? 모든 오류와 해결 방법.

1. /voice를 쓰려면 Claude.ai 계정으로 로그인해야 해요. API 키, Bedrock, Vertex, Foundry로는 쓸 수 없어요.
2. Claude Code가 실행되는 머신에서 녹음하기 때문에 SSH에서는 작동하지 않고, VS Code Remote나 클라우드 세션에서도 마찬가지예요.
3. 덮개를 닫았거나, 장치가 바뀌었거나, 업데이트된 뒤에는 새 세션을 시작하세요.

1. Unknown command: /voice 또는 Voice mode requires a Claude.ai account

   Claude.ai로 로그인하지 않았거나, API 키나 프로바이더 설정이 우선 적용되고 있어요. /login을 실행하고, ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, apiKeyHelper를 제거한 다음 Claude Code를 다시 시작하세요.

   출처: Claude Code 문서.

2. Voice mode is disabled by your organization’s policy

   관리자가 음성 입력을 꺼 둔 상태예요. 관리자에게 문의하거나 Claude Code 밖의 받아쓰기 도구를 쓰세요.

   출처: Claude Code 문서.

3. Microphone access is denied

   시스템 설정 → 개인정보 보호 및 보안 → 마이크에서 터미널(또는 VS Code)을 허용하세요. 목록에 없으면 권한을 재설정하고, ⌘Q로 종료한 다음 다시 여세요.

   # Terminal: com.apple.Terminal · iTerm2: com.googlecode.iterm2
   # Ghostty: com.mitchellh.ghostty · Warp: dev.warp.Warp-Stable · VS Code: com.microsoft.VSCode
   tccutil reset Microphone com.apple.Terminal
   
   # Not sure of the bundle ID? Ask macOS:
   osascript -e 'id of app "iTerm"'

   출처: Claude Code 문서.

4. No audio detected from microphone

   녹음에 무음만 담겼어요. 보통 세션이 바뀐 장치나 바이너리에 묶여 있는 경우예요: 새 세션을 시작하세요. 모든 원인과 해결 방법 →

5. No speech detected

   오디오는 도착했지만 단어가 인식되지 않았어요: 더 가까이에서 말하고, 소음을 줄이고, /config에서 언어를 설정하세요. 자세히 →

6. Voice input is failing repeatedly and has been paused

   10초 안에 세 번 실패: 보통 마이크가 없거나(SSH, 컨테이너) 권한이 거부된 경우예요. 자세히 →

7. Voice connection failed 또는 Voice stream error: WebSocket upgrade rejected

   녹음이 변환 서비스에 도달하지 못했어요. 네트워크를 확인하세요. 4xx 상태 코드라면 /login을 다시 실행하고, 중간에 VPN이나 프록시가 있는지 확인하세요.

   출처: Claude Code 문서.

8. Voice mode requires SoX for audio recording 또는 could not find a working audio recorder in WSL

   Linux와 WSL에서만 해당돼요. SoX를 설치하세요. WSL에서는 SoX의 PulseAudio 포맷도 필요해요.

   sudo apt-get install sox                    # Linux
   sudo apt install sox libsox-fmt-pulse       # WSL with WSLg

   출처: Claude Code 문서.

9. Space를 길게 누르면 공백만 입력돼요

   공백이 계속 쌓이면 음성 입력이 꺼져 있는 거예요: /voice hold를 실행하세요. 공백이 한두 개만 생기면 OS에서 키 반복이 꺼져 있는 거예요: 대신 /voice tap을 쓰세요. 탭 모드에서는 첫 번째 탭으로 녹음을 시작하려면 프롬프트가 비어 있어야 해요.

   출처: Claude Code 문서.

2026년 10월 기준. Claude Code 문서와 GitHub 이슈를 바탕으로 작성했어요.

Claude Code 음성 입력은 API 키, Bedrock, Vertex에서 작동하나요?

아니요. 음성 받아쓰기는 Claude.ai 계정 로그인이 필요해요. Copy That은 Claude Code에 텍스트를 붙여넣을 뿐이니 어떤 로그인 방식이든 작동해요.

Claude Code 음성 받아쓰기는 로컬에서 처리되나요?

아니요. 오디오는 Anthropic으로 스트리밍되어 텍스트로 변환되고, 프로젝트 이름과 git 브랜치가 힌트로 함께 전송돼요. 토큰을 쓰거나 사용량 한도에 포함되지는 않아요. Copy That은 Mac에서 Whisper로 변환해요.

VS Code Remote나 SSH에서 Claude Code 음성 입력을 쓸 수 있나요?

아니요, 음성은 Claude Code가 실행되는 머신에서 녹음돼요. Copy That은 SSH로 연결된 터미널을 포함해 Mac에서 앞에 열린 어떤 터미널에든 붙여넣어요.

이런 오류를 아예 피하는 방법이 있나요?

Mac의 마이크가 아닌 다른 마이크를 쓰세요. Copy That은 iPhone이나 Apple Watch에서 녹음하고, Mac에서 Whisper로 변환해 Claude Code에 붙여넣기 때문에 Mac의 입력 장치, 덮개, 마이크 권한과 상관없어요.