Claude Code · 语音输入错误
修复 Claude Code 中的“No speech detected”(未检测到语音)。
No speech detected
与“No audio detected”不同,这表示音频确实到达了 Anthropic 的转写服务,但没有从中识别出任何词。麦克风是好的;只是它听到的内容不像 Claude Code 预期语言的语音。
- 说话时靠近麦克风,并减少背景噪音。
- 在
/config中设置听写语言。未设置语言时,Claude Code 默认你说英语。 - 在按住模式下,一直按住,直到底栏显示
listening…再开始说话。
听写语言与你说的语言不一致
Claude Code 按
language设置进行听写,如果为空或不受支持,则回退到英语。在/config中设置。支持的语言:捷克语、丹麦语、荷兰语、英语、法语、德语、希腊语、印地语、印度尼西亚语、意大利语、日语、韩语、挪威语、波兰语、葡萄牙语、俄语、西班牙语、瑞典语、土耳其语和乌克兰语。出自 Claude Code 文档。
录音开始前你就开口了
在按住模式下,Claude Code 通过按键重复来检测按住的键,所以有一小段预热时间:底栏先显示
keep holding…,然后显示listening…。在此之前说的话不会被录下。在~/.claude/keybindings.json中把按键说话绑定到meta+k这类修饰键组合,就能跳过预热。出自 Claude Code 文档。
麦克风太远、音量太小或环境太吵
隔着房间的笔记本麦克风,或嘈杂的咖啡馆,录到的音频可能没有可识别的词。靠近一些,或者用耳麦。
出自 Claude Code 文档。也有用户在麦克风正常的情况下遇到这个问题:#38918 仍未解决。
截至 2026 年 10 月。信息来自 Claude Code 文档及其 GitHub issue。
用 iPhone 或 Apple Watch 当麦克风。
Copy That 在 iPhone 或 Apple Watch 上录音,用 Whisper 在 Mac 上转写,然后粘贴到 Claude Code 中。Mac 上的合盖、AirPods、输入设备和麦克风权限都不再重要,因为 Mac 根本不录音。
- “No speech detected”和“No audio detected from microphone”有什么区别?
- “No audio detected from microphone”表示 Claude Code 录到的是静音,所以问题在你的 Mac 上:输入设备、音量或权限。“No speech detected”表示音频已到达转写服务,但没有识别出任何词,所以问题在于距离、噪音或语言设置。
- Claude Code 的语音听写能离线使用吗?
- 不能。Claude Code 会把音频流式发送到 Anthropic 的服务器进行转写。它不消耗你的 token,也不计入用量限额。
- 有没有办法彻底避免这个问题?
- Copy That 在离你嘴边很近的 iPhone 或 Apple Watch 上录音,用 Whisper 在 Mac 上按你说的语言转写,然后粘贴到 Claude Code 中。