修复 Claude Code 中的“Voice input is failing repeatedly and has been paused”（语音输入反复失败，已暂停）。

1. 确认运行 Claude Code 的机器有麦克风。通过 SSH、在容器中或在云端会话中都没有麦克风。
2. 在“系统设置 → 隐私与安全性 → 麦克风”中允许你的终端。
3. 解决原因后，等十秒再试一次 /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 issue。

能通过 SSH 使用 Claude Code 语音吗？

不能。语音是在运行 Claude Code 的机器上录制的，在 SSH 会话、VS Code Remote 或云端会话中都不可用。Copy That 在这些场景下能用：它粘贴到你 Mac 上的终端里，无论这个终端连接到哪里。

暂停会持续多久？

从三次失败中的第一次算起，十秒后 Claude Code 会重新允许使用语音。如果原因没解决，它还会再次暂停。

有没有办法彻底避免这个问题？

用一个不属于 Mac 的麦克风。Copy That 在 iPhone 或 Apple Watch 上录音，用 Whisper 在 Mac 上转写，然后粘贴到 Claude Code 中，所以 Mac 上的输入设备、合盖和麦克风权限都无关紧要了。