Copy That
Claude Code · 语音输入错误

Claude Code 语音无法使用？所有错误及修复方法。

在下面找到 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

    十秒内失败三次：通常是没有麦克风（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 上还要安装它的 PulseAudio 格式支持。

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

    出自 Claude Code 文档。

  9. 按住 Space 只会输入空格

    如果空格不停地冒出来，说明语音已关闭：运行 /voice hold。如果只出现一两个，说明系统关闭了按键重复：改用 /voice tap。在轻按模式下，提示框必须为空，第一次轻按才会开始录音。

    出自 Claude Code 文档。

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

或者干脆不用 Mac 的麦克风

用 iPhone 或 Apple Watch 当麦克风。

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

iPhone & Apple Watch · App Store下载 Mac 版 · 免费

Claude Code 语音输入 →

常见问题
Claude Code 语音能配合 API 密钥、Bedrock 或 Vertex 使用吗？
不能。语音听写需要登录 Claude.ai 账户。Copy That 适用于任何登录方式，因为它只是把文字粘贴到 Claude Code 中。
Claude Code 的语音听写是在本地处理的吗？
不是。音频会流式发送给 Anthropic 进行转写，你的项目名和 git 分支也会作为提示一并发送。它不消耗 token，也不计入用量限额。Copy That 则用 Whisper 在你的 Mac 上转写。
能在 VS Code Remote 中或通过 SSH 使用 Claude Code 语音吗？
不能，语音是在运行 Claude Code 的机器上录制的。Copy That 会粘贴到你 Mac 上前台的任何终端里，包括通过 SSH 连接的终端。
有没有办法彻底避免这些错误？
用一个不属于 Mac 的麦克风。Copy That 在 iPhone 或 Apple Watch 上录音，用 Whisper 在 Mac 上转写，然后粘贴到 Claude Code 中，所以 Mac 上的输入设备、合盖和麦克风权限都无关紧要了。
同样适用于
Claude CodeOpenCodeCodex CLIGemini CLICursorAiderPiClineWindsurfGitHub CopilotZedWarpRoo CodeKilo CodeAmpGooseKiroFactory DroidCrushQwen Codeany text field