Copy That
Claude Code · 语音输入错误

修复 Claude Code 中的“No speech detected”(未检测到语音)。

No speech detected

与“No audio detected”不同,这表示音频确实到达了 Anthropic 的转写服务,但没有从中识别出任何词。麦克风是好的;只是它听到的内容不像 Claude Code 预期语言的语音。

快速修复
  1. 说话时靠近麦克风,并减少背景噪音。
  2. 在 /config 中设置听写语言。未设置语言时,Claude Code 默认你说英语。
  3. 在按住模式下,一直按住,直到底栏显示 listening… 再开始说话。
所有原因及修复方法
  1. 听写语言与你说的语言不一致

    Claude Code 按 language 设置进行听写,如果为空或不受支持,则回退到英语。在 /config 中设置。支持的语言:捷克语、丹麦语、荷兰语、英语、法语、德语、希腊语、印地语、印度尼西亚语、意大利语、日语、韩语、挪威语、波兰语、葡萄牙语、俄语、西班牙语、瑞典语、土耳其语和乌克兰语。

    出自 Claude Code 文档。

  2. 录音开始前你就开口了

    在按住模式下,Claude Code 通过按键重复来检测按住的键,所以有一小段预热时间:底栏先显示 keep holding…,然后显示 listening…。在此之前说的话不会被录下。在 ~/.claude/keybindings.json 中把按键说话绑定到 meta+k 这类修饰键组合,就能跳过预热。

    出自 Claude Code 文档。

  3. 麦克风太远、音量太小或环境太吵

    隔着房间的笔记本麦克风,或嘈杂的咖啡馆,录到的音频可能没有可识别的词。靠近一些,或者用耳麦。

    出自 Claude Code 文档。也有用户在麦克风正常的情况下遇到这个问题:#38918 仍未解决。

截至 2026 年 10 月。信息来自 Claude Code 文档及其 GitHub issue。

或者干脆不用 Mac 的麦克风

用 iPhone 或 Apple Watch 当麦克风。

Copy That 在 iPhone 或 Apple Watch 上录音,用 Whisper 在 Mac 上转写,然后粘贴到 Claude Code 中。Mac 上的合盖、AirPods、输入设备和麦克风权限都不再重要,因为 Mac 根本不录音。

Claude Code 语音输入 →

常见问题
“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 中。
同样适用于