Voice mode shows 'keep trying' instead of clear error when audio devices unavailable (WSL2)

Status Closed — not planned
Maintainer reply None cached
Activity 3 comments · opened Mar 29, 2026 · closed May 25, 2026

Bug Description

When using voice mode in Claude Code CLI inside WSL2 (Kali Linux), the voice feature silently fails with a generic "keep trying" message instead of a clear, actionable error explaining that audio devices are unavailable.

Environment

  • OS: Kali Linux running in WSL2
  • Kernel: 6.6.87.2-microsoft-standard-WSL2
  • Platform: Windows + WSL2 (no WSLg audio support configured)
  • Claude Code version: latest

Steps to Reproduce

  1. Run Claude Code CLI inside WSL2 (no WSLg audio configured)
  2. Run /voice to enable voice mode
  3. Hold Space to attempt to record
  4. Observe: generic "keep trying" message appears repeatedly

Expected Behavior

A clear error message such as:

"Voice mode requires audio device access. No audio devices found (/dev/snd/ missing). If you're using WSL2, run wsl --update && wsl --shutdown in PowerShell (Admin) to enable WSLg audio support."

Actual Behavior

Voice mode appears enabled but when recording is attempted, it shows "keep trying" with no explanation.

Root Cause

/dev/snd/ does not exist in WSL2 without WSLg. Claude Code does not detect this and surface a helpful diagnostic message.

Suggested Fix

Before activating voice mode (or on first failed record attempt), check for the presence of audio recording tools and /dev/snd/ devices. If unavailable, surface a specific error with WSL2 remediation steps instead of looping with "keep trying".

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗