Claude Code의 “No audio detected from microphone” 해결.
No audio detected from microphone. Check that the correct input device is selected and that Claude Code has microphone access.
Claude Code의 /voice가 녹음을 시작했지만 무음만 담겼어요. 마이크 자체는 정상일 수 있어요: 대부분 세션이 시작된 뒤에 바뀐 입력 장치나 바이너리에 여전히 묶여 있는 경우예요.
- 새 Claude Code 세션을 시작하세요(
/exit로 종료하고claude를 다시 실행하거나, 대화를 유지하려면claude --resume). 가장 흔한 원인은 이걸로 해결돼요. - 시스템 설정 → 사운드 → 입력을 확인하세요: 올바른 마이크가 선택되어 있고 말할 때 레벨이 움직여야 해요.
- 시스템 설정 → 개인정보 보호 및 보안 → 마이크를 확인하세요: 터미널(또는 VS Code)이 켜져 있어야 해요.
세션 도중 덮개를 닫았거나, Mac을 잠자기 상태로 두었거나, AirPods를 연결한 경우
세션은 시작할 때 찾은 장치로 계속 녹음해요. 그 장치가 사라지거나 다시 나타나면(Apple Silicon에서 덮개 닫기, 잠자기에서 깨어나기, Bluetooth 헤드폰 연결) 그때부터 무음만 녹음돼요.
/voice를 껐다 켜도 소용없어요. 새 세션을 시작하고, 그래도 안 되면 터미널을 종료했다가 다시 실행하세요.#78169(덮개 닫기, 계획 없음으로 닫힘), #88890, #89635(Bluetooth, 잠자기)에 보고됨. 기본 장치 변경에 대한 수정은 v2.1.195에 포함됐어요(#65331).
세션이 열려 있는 동안 Claude Code가 자동 업데이트된 경우
macOS에서는 자동 업데이터가 실행 중인 세션이 아직 쓰고 있는 바이너리를 교체하고, macOS는 그 이전 프로세스에 더 이상 마이크 권한을 주지 않아요. 녹음은 시작된 것처럼 보이지만 무음만 전달돼요. 세션을 다시 시작하세요(
claude --resume을 쓰면 대화가 유지돼요).세션을 아주 오래 실행한 경우
긴 세션에서는 처음에 잘 되던 음성 입력이 멈출 수 있어요. 새 세션을 시작하세요.
잘못된 입력 장치가 시스템 기본값이거나 입력 레벨이 0인 경우
Claude Code는 시스템 기본 입력 장치로 녹음해요. macOS에서는 시스템 설정 → 사운드 → 입력을 열어 마이크를 고르고, 말하면서 레벨이 움직이는지 확인하세요. Windows: 설정 → 시스템 → 소리 → 입력.
출처: Claude Code 문서.
터미널에 마이크 사용 권한이 없는 경우
macOS는 Claude Code가 실행되는 앱에 마이크 권한을 줘요: Terminal, iTerm2, Ghostty, Warp, 또는 통합 터미널의 경우 VS Code. 시스템 설정 → 개인정보 보호 및 보안 → 마이크에서 켜세요. 앱이 목록에 없으면 권한을 재설정해서 macOS가 다시 묻게 하고, ⌘Q로 앱을 종료했다가 다시 열고
/voice를 실행하세요. 번들 ID는 꼭 지정하세요: 지정하지 않으면tccutil이 모든 앱의 마이크 권한을 재설정해요.# 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 문서.
세션이 백그라운드에서 시작된 경우
claude agents로 실행된 세션은 백그라운드 프로세스에서 돌아가는데, macOS는 이 프로세스에 마이크 권한을 연결하지 못해요. 일반 포그라운드 세션에서 말로 입력하세요.열려 있는 이슈 #86217.
2026년 10월 기준. Claude Code 문서와 GitHub 이슈를 바탕으로 작성했어요.
iPhone이나 Apple Watch를 마이크로 쓰세요.
Copy That은 iPhone이나 Apple Watch에서 녹음하고, Mac에서 Whisper로 변환해 Claude Code에 붙여넣어요. Mac은 아무것도 녹음하지 않으니 덮개, AirPods, 입력 장치, 마이크 권한은 더 이상 신경 쓸 필요가 없어요.
- 새 탭에서는 /voice가 되는데 기존 세션에서는 왜 안 되나요?
- 기존 세션이 시작된 뒤에 무언가 바뀌었기 때문이에요: 입력 장치를 바꾸거나 다시 연결했거나, 덮개를 닫았거나, Claude Code가 자동 업데이트됐을 수 있어요. 기존 세션은 여전히 예전 장치나 바이너리에 묶여 있어요. 새 세션은 현재 것을 사용해요.
- Claude Code 마이크가 왜 작동하지 않나요?
- Claude Code에 “No audio detected from microphone”이 뜨면 녹음은 시작됐지만 무음만 들린 거예요: 새 세션을 시작하고 입력 장치와 레벨을 확인하세요. “Microphone access is denied”가 뜨면 개인정보 보호 및 보안 → 마이크에서 터미널을 허용하세요.
/voice가 알 수 없는 명령이라고 나오면/login으로 로그인하세요: 음성 입력은 Claude.ai 계정이 필요하고 API 키, Bedrock, Vertex로는 작동하지 않아요. - Claude Code에서 마이크를 어떻게 활성화하나요?
- Claude Code에서
/voice를 실행한 다음, macOS가 물어보면 시스템 설정 → 개인정보 보호 및 보안 → 마이크에서 터미널 앱(또는 VS Code)을 허용하세요. Windows에서는 설정 → 개인 정보 및 보안 → 마이크에서 데스크톱 앱을 허용하세요. - 이 문제를 아예 피하는 방법이 있나요?
- Mac의 마이크가 아닌 다른 마이크를 쓰세요. Copy That은 iPhone이나 Apple Watch에서 녹음하고, Mac에서 Whisper로 변환해 Claude Code에 붙여넣기 때문에 Mac의 입력 장치, 덮개, 마이크 권한과 상관없어요.