Claude Code의 “Voice input is failing repeatedly and has been paused” 해결.

1. Claude Code가 실행되는 머신에 마이크가 있는지 확인하세요. SSH, 컨테이너, 클라우드 세션에는 마이크가 없어요.
2. 시스템 설정 → 개인정보 보호 및 보안 → 마이크에서 터미널을 허용하세요.
3. 원인을 해결한 뒤 10초 기다렸다가 /voice를 다시 시도하세요.

1. Claude Code가 마이크 없는 머신에서 실행 중인 경우

   음성은 Claude Code가 실행되는 머신에서 녹음돼요. SSH, VS Code Remote(SSH, Dev Containers, Codespaces), 클라우드 세션, 헤드리스 서버에서는 쓸 수 없어요. Claude Code를 로컬에서 실행하거나, 그 머신에 묶이지 않은 마이크를 쓰세요.

   출처: Claude Code 문서.

2. 마이크 접근이 거부된 경우

   macOS: 시스템 설정 → 개인정보 보호 및 보안 → 마이크에서 터미널을 켜거나, 권한을 재설정해서 macOS가 다시 묻게 하세요. Windows: 설정 → 개인 정보 및 보안 → 마이크에서 데스크톱 앱을 허용하세요.

   # 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 문서.

3. 작동하는 녹음 도구가 없는 Linux 또는 WSL

   Linux에서 내장 오디오 모듈을 불러올 수 없으면 Claude Code에 arecord나 SoX가 필요해요. WSL에서는 WSLg와 SoX용 PulseAudio 포맷이 필요해요.

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

   출처: Claude Code 문서.

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

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

아니요. 음성은 Claude Code가 실행되는 머신에서 녹음되고, SSH 세션, VS Code Remote, 클라우드 세션에서는 쓸 수 없어요. Copy That은 그런 환경에서도 작동해요: 터미널이 어디에 연결되어 있든 Mac의 터미널에 붙여넣으니까요.

일시 중지는 얼마나 지속되나요?

Claude Code는 세 번의 실패 중 첫 번째 실패로부터 10초 후에 다시 음성 입력을 허용해요. 원인이 해결되지 않으면 다시 일시 중지돼요.

이 문제를 아예 피하는 방법이 있나요?

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