[BUG] Voice recording requires the native audio module, which could not be loaded.
Resolved 💬 19 comments Opened Mar 5, 2026 by phoenixai-solutions Closed Apr 24, 2026
💡 Likely answer: A maintainer (claude[bot], contributor)
responded on this thread — see the highlighted reply below.
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
When trying to activate voice in ClaudeCode (Version 2.1.69) via Windows Powershell I get teh following error:
Voice recording requires the native audio module, which could not be loaded.
Trying to troubleshoot with Claude direct highlights:
The /voice feature on Windows requires a native audio-capture.node binary at audio-capture/x64-win32/audio-capture.node inside the Claude Code package, and it's completely missing from your installation.
I reinstalled Claude and issues remains so I cant use /voice.
What Should Happen?
I should be able activate the /voice command and use voice with Claude Code.
Error Messages/Logs
Output from Claude:
Bug: /voice command fails on Windows — native audio module not bundled
Environment:
- Claude Code: v2.1.69 (installed via npm install -g @anthropic-ai/claude-code)
- Node.js: v20.20.0
- npm: 11.2.0
- Platform: x64-win32
- OS: Windows 11 Home 10.0.26100
Error message:
Voice recording requires the native audio module, which could not be loaded.
Root cause:
The audio-capture/ directory is entirely missing from the npm package. The code in checkRecordingAvailability() expects a native binary at audio-capture/x64-win32/audio-capture.node, but no audio-capture/ directory is shipped in the package. The vendor/ directory only contains ripgrep/.
On non-Windows platforms, the code falls back to SoX (rec command), but on Windows the only supported path is the native module — so there is no fallback and voice mode is completely unavailable.Steps to Reproduce
- Open Windows Powershell
- Run Claude
- Type /voice
- Hit enter
Claude Model
Opus
Is this a regression?
No, this never worked
Last Working Version
_No response_
Claude Code Version
2.1.69
Platform
Anthropic API
Operating System
Windows
Terminal/Shell
PowerShell
Additional Information
_No response_
19 Comments
Found 3 possible duplicate issues:
This issue will be automatically closed as a duplicate in 3 days.
🤖 Generated with Claude Code
please solve it, we pay for it and we cant using it.
Windows x64 - audio-capture.node missing from npm package
Running Claude Code v2.1.72 on Windows 11 x64 (installed via npm).
Issue: The
audio-capturedirectory is completely missing from the npm package. The code incli.jsconstructs the path as../audio-capture/x64-win32/audio-capture.noderelative toimport.meta.url, but this directory does not exist in the package.Verified workarounds that do NOT work:
Voice mode is not supported in WSL because audio devices are not available)fcntlmoduleAUDIO_CAPTURE_NODE_PATHenv variable: No binary available to point toRequest: Please include
audio-capture/x64-win32/audio-capture.nodein the npm package distribution, or provide an official download link for the binary.Platform: Linux (Arch Linux, kernel 6.18.9)
Claude Code version: 2.1.72
Installation:
~/.local/share/claude/versions/2.1.72Same issue here — no audio capture binaries are bundled in the installation at all. Running
findacross the entire Claude installation directory returns zero results for anyaudio*,voice*, orspeech*files.The
/voicecommand doesn't appear as an available slash command, which I assume is due to the 5% rollout gate, but wanted to flag that even once it's enabled, the native module would be missing on this platform.Would love to see Linux support included in the voice mode rollout.
Same issue here.
Voice recording requires the native audio module, which could not be loaded.The
audio-capture.nodebinary is not bundled with the Windows distribution. Would appreciate a fix or a SoX/ffmpeg fallback as suggested in #32249.Having this issue also on Windows! Please fix I'd love to have this option.
Is this happening only for Windows?
Yes it works on MacOS.
✅ Working Fix for
/voiceon Windows — SoX Fallback PatchI've built and tested a complete fix that enables
/voicepush-to-talk on Windows 10/11.The Problem
/voicefails on Windows with:The native
audio-capture.nodebinary isn't bundled for win32, and the SoX fallback path (which works on macOS/Linux) is explicitly blocked on Windows with threeprocess.platform === "win32"guards.The Fix (6 targeted patches to cli.js)
| # | Location | Change | Why |
|---|----------|--------|-----|
| 1 |
checkRecordingAvailability| Remove win32 early-reject | Let it fall through to SoX || 2 |
checkVoiceDependencies| Remove win32 early-reject | Same || 3 |
startRecording| Remove win32 early-return | Allow SoX path || 4 | SoX spawn call |
rec→sox -t waveaudio default| Windows SoX has norecbinary; needs explicit waveaudio driver || 5 | Dependency check |
dl("rec")→dl("sox")on win32 | Windows uses sox.exe || 6 | Availability check |
dl("rec")→dl("sox")on win32 | Same |Key Technical Detail
On macOS/Linux the fallback runs:
On Windows, SoX doesn't ship
recand can't auto-detect the audio device. The working equivalent is:Tested On
winget install ChrisBagwell.SoX)Community Patch (one-click installer)
https://github.com/biketrader-afk/claude-voice-windows
Installs SoX, patches cli.js, verifies audio capture. Includes uninstall/restore.
Ask
Could the team consider adding native SoX fallback support for Windows? The changes are minimal — remove 3 platform guards and add a Windows-specific SoX command in the spawn call. Happy to help test any implementation.
Same here
Still happening on Windows 11 Pro (build 26200), Claude Code v2.1.74, Node v24.13.0.
Running
/voicegives:No workaround available — the native
audio-capture.nodebinary is not bundled in the npm package for Windows, and there's no SoX fallback like on Linux/macOS.Would love to see this resolved — either by shipping the native module for Windows or implementing the SoX fallback as proposed in #32249. Thanks!
@taqyon Same setup here — Windows 11, same build. I put together a fix that patches cli.js to use SoX for audio capture instead of the missing native module.
One-click install, backs up your originals: https://github.com/biketrader-afk/claude-voice-windows
Tested on the exact same config you're running (Win 11 build 26200, v2.1.74). Push-to-talk works immediately after.
@LaszloRobert @aditya-MHA @Promethia1 There's a working fix available — patches cli.js to use SoX for audio capture on Windows instead of the missing native module.
One-click install: https://github.com/biketrader-afk/claude-voice-windows
Tested on Windows 11 Home and confirmed working on Windows 10 as well. Push-to-talk works immediately after running the installer.
It seems like I do not get the error anymore that the native audio module is required. Now I get "Voice connection failed. Check your network and try again."
Anybody else experiencing this ?
Hi! Thanks for the message! Everything is working fine on Windows now! Awesome!
People facing this issue, switch to the native installer instead of npm, it worked for me
thanks for this, works for me now
This issue was fixed as of version 2.1.76.
This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.